Přetěžování core služeb

Mechanismus @ConditionalOnNoCustomService umožňuje v klientském projektu nahradit výchozí core beanu vlastní implementací. Core beana se při přetížení vůbec nezaregistruje — v kontextu vznikne vždy jen jedna instance. Odpadá tak nutnost přetěžovat celou @Configuration třídu pomocí configurationOverride kvůli jedné službě.

Použití v core moduluZkopírovat odkaz na sekci

Služba, která má být rozšiřitelná, se v @Configuration třídě označí anotací @ConditionalOnNoCustomService:

1@ConditionalOnNoCustomService2@Bean3public AbstractCompanyService companyService(CoreDependency dao) {4    return new DefaultCompanyService(dao);5}

Anotace automaticky použije název metody (companyService) jako klíč. Pokud je potřeba specifikovat jiný klíč, lze ho předat jako parametr:

1@ConditionalOnNoCustomService("myCustomKey")2@Bean3public AbstractCompanyService companyService(CoreDependency dao) {4    return new DefaultCompanyService(dao);5}

Použití v klientském projektuZkopírovat odkaz na sekci

1. Vytvoření properties souboruZkopírovat odkaz na sekci

V klientském projektu vytvořte soubor src/main/resources/META-INF/edee-custom-services.properties a přidejte název přetěžované beany jako klíč. Jako hodnotu zapište plně kvalifikovaný název nové třídy (implementace vyhodnocuje pouze existenci klíče, ale hodnota slouží pro přehlednost a případné budoucí využití):

1# Vypne načtení core beany 'companyService'2companyService=com.fg.client.CustomCompanyService

2. Definice vlastní beanyZkopírovat odkaz na sekci

V projektu nadefinujte vlastní beanu (klidně se stejným názvem), do které si přes konstruktor nainjektujete projektové závislosti:

1@Configuration2public class ProjectCompanyConfig {3
4    @Bean5    public AbstractCompanyService companyService(6            ProjectSpecificDependency projectDep,7            CoreDependency dao8    ) {9        return new ProjectCompanyService(projectDep, dao);10    }11}

Protože core beana nebyla díky property souboru vůbec zaregistrována, nedojde k porušení allowBeanDefinitionOverriding=false.

TestováníZkopírovat odkaz na sekci

V JUnit testech stačí na classpath umístit testovací verzi properties souboru:

1src/test/resources/META-INF/edee-custom-services.properties

Výhody oproti @PrimaryZkopírovat odkaz na sekci

Klíčové třídyZkopírovat odkaz na sekci

• com.fg.cps.eshop.cps.config.spring.annotation.ConditionalOnNoCustomService — anotace pro označení výchozích bean metod
• com.fg.cps.eshop.cps.config.spring.annotation.NoCustomServiceCondition — evaluátor podmínky