您好,登錄后才能下訂單哦!
Spring Boot中的那些Conditional
spring boot中為我們提供了豐富的Conditional來讓我們得以非常方便的在項目中向容器中添加Bean。本文主要是對各個注解進行解釋并輔以代碼說明其用途。
所有ConditionalOnXXX的注解都可以放置在class或是method上,如果方式在class上,則會決定該class中所有的@Bean注解方法是否執行。
@Conditional
下面其他的Conditional注解均是語法糖,可以通過下面的方法自定義ConditionalOnXXX
Conditional注解定義如下,接收實現Condition接口的class數組。
public @interface Conditional { Class<? extends Condition>[] value(); }
而Condition接口只有一個matchs方法,返回是否匹配的結果。
public interface Condition { boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata); }
通過操作系統進行條件判斷,從而進行Bean配置。當Window時,實例化Bill的Person對象,當Linux時,實例化Linus的Person對象。
//LinuxCondition,為方便起見,去掉判斷代碼,直接返回true了 public class LinuxCondition implements Condition { @Override public boolean matches(ConditionContext conditionContext, AnnotatedTypeMetadata annotatedTypeMetadata) { return true; } }
//WindowsCondition,為方便起見,去掉判斷代碼,直接返回false了 public class WindowsCondition implements Condition { @Override public boolean matches(ConditionContext conditionContext, AnnotatedTypeMetadata metadata) { return false; } } @Data
@ToString @AllArgsConstructor @NoArgsConstructor public class Person { private String name; private Integer age; }
//配置類 @Configuration public class BeanConfig { @Bean(name = "bill") @Conditional({WindowsCondition.class}) public Person person1(){ return new Person("Bill Gates",62); } @Bean("linus") @Conditional({LinuxCondition.class}) public Person person2(){ return new Person("Linus",48); } }
public class AppTest { AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(BeanConfig.class); @Test public void test(){ String osName = applicationContext.getEnvironment().getProperty("os.name"); System.out.println("當前系統為:" + osName); Map<String, Person> map = applicationContext.getBeansOfType(Person.class); System.out.println(map); } }
輸出的結果:
當前系統為:Mac OS X
{linus=Person(name=Linus, age=48)}
@ConditionalOnBean & @ConditionalOnMissingBean
這兩個注解會對Bean容器中的Bean對象進行判斷,使用的例子是配置的時候,如果發現如果沒有Computer實例,則實例化一個備用電腦。
@Data @AllArgsConstructor @ToString public class Computer { private String name; }
@Configuration public class BeanConfig { @Bean(name = "notebookPC") public Computer computer1(){ return new Computer("筆記本電腦"); } @ConditionalOnMissingBean(Computer.class) @Bean("reservePC") public Computer computer2(){ return new Computer("備用電腦"); } }
public class TestApp { AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(BeanConfig.class); @Test public void test1(){ Map<String,Computer> map = applicationContext.getBeansOfType(Computer.class); System.out.println(map); } }
修改BeanConfig,如果注釋掉第一個@Bean,會實例化備用電腦,否則就不會實例化備用電腦
@ConditionalOnClass & @ConditionalOnMissingClass
這個注解會判斷類路徑上是否有指定的類,一開始看到的時候比較困惑,類路徑上如果沒有指定的class,那編譯也通過不了啊...這個主要用于集成相同功能的第三方組件時用,只要類路徑上有該組件的類,就進行自動配置,比如spring boot web在自動配置視圖組件時,是用Velocity,還是Thymeleaf,或是freemaker時,使用的就是這種方式。
例子是兩套盔甲A(光明套裝)和B(暗黑套裝),如果A不在則配置B。
public interface Fighter { void fight(); } public class FighterA implements Fighter { @Override public void fight() { System.out.println("使用光明套裝"); } } public class FighterB implements Fighter { @Override public void fight() { System.out.println("使用暗黑套裝"); } }
Van是武士,使用套裝進行戰斗
@Data @AllArgsConstructor @NoArgsConstructor public class Van { private Fighter fighter; public void fight(){ fighter.fight(); } }
VanConfigA/B實例化武士
@Configuration @ConditionalOnClass({FighterA.class}) public class VanConfigA { @Primary @Bean public Van vanA(){ return new Van(new FighterA()); } } @Configuration @ConditionalOnClass({FighterB.class}) public class VanConfigB { @Bean public Van vanB(){ return new Van(new FighterB()); } }
測試類,默認情況,如果套裝AB都在類路徑上,兩套都會加載,A會設置為PRIMARY,如果在target class中將FightA.class刪除,則只會加載套裝B。
@SpringBootApplication public class TestApp implements CommandLineRunner { @Autowired private Van van; public static void main(String[] args) { SpringApplication.run(TestApp.class, args); } @Override public void run(String... args) throws Exception { //do something van.fight(); } }
另外,嘗試將兩個VanConfigA/B合并,將注解ConditionalOnClass放到方法上,如果刪除一個套裝就會運行出錯。
@ConditionalOnExpress
依據表達式進行條件判斷,這個作用和@ConditionalOnProperty大部分情況可以通用,表達式更靈活一點,因為可以使用SpEL。例子中會判斷properties中test.enabled的值進行判斷。BeanConfig分別對布爾,字符串和數字三種類型進行判斷。數字嘗試了很多其他的方式均不行,比如直接使用==,貌似配置的屬性都會當成字符串來處理。
@Data public class TestBean { private String name; }
@Configuration @ConditionalOnExpression("#{${test.enabled:true} }") //@ConditionalOnExpression("'zz'.equalsIgnoreCase('${test.name2}')") //@ConditionalOnExpression("new Integer('${test.account}')==1") public class BeanConfig { @Bean public TestBean testBean(){ return new TestBean("我是美猴王"); } }
@SpringBootApplication public class TestAppCommand implements CommandLineRunner { @Autowired private TestBean testBean; public static void main(String[] args) { SpringApplication.run(TestAppCommand.class, args); } @Override public void run(String... args) throws Exception { System.out.println(testBean.getName()); } }
@ConditionalOnProperty
適合對單個Property進行條件判斷,而上面的@ConditionalOnExpress適合面對較為復雜的情況,比如多個property的關聯比較。這個例子也給了三種基本類型的條件判斷,不過貌似均當成字符串就可以...
@Data @AllArgsConstructor @NoArgsConstructor public class TestBean { private String name; }
@Configuration @ConditionalOnProperty(prefix = "test", name="enabled", havingValue = "true",matchIfMissing = false) //@ConditionalOnProperty(prefix = "test", name="account", havingValue = "1",matchIfMissing = false) //@ConditionalOnProperty(prefix = "test", name="name1", havingValue = "zz",matchIfMissing = false) public class BeanConfig { @Bean public TestBean testBean(){ return new TestBean("我是美猴王"); } }
@SpringBootApplication public class TestAppCommand implements CommandLineRunner { @Autowired private TestBean testBean; public static void main(String[] args) { SpringApplication.run(TestAppCommand.class, args); } @Override public void run(String... args) throws Exception { System.out.println(testBean.getName()); } }
@ConditionalOnJava
可以通過java的版本進行判斷。
@Data public class TestBean { }
@Configuration @ConditionalOnJava(JavaVersion.EIGHT) public class BeanConfig { @Bean public TestBean testBean(){ return new TestBean(); } }
public class TestApp { AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(BeanConfig.class); @Test public void test(){ Map<String,TestBean> map = context.getBeansOfType(TestBean.class); System.out.println(map); } }
@ConditionalOnResource
通過指定的資源文件是否存在進行條件判斷,比如判斷ehcache.properties來決定是否自動裝配ehcache組件。
@Data public class TestBean { }
@Configuration @ConditionalOnResource(resources = "classpath:application.yml") public class BeanConfig { @Bean public TestBean testBean(){ return new TestBean(); } }
public class TestApp { AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(BeanConfig.class); @Test public void test(){ Map<String,TestBean> map = context.getBeansOfType(TestBean.class); System.out.println(map); } }
@ConditionalOnSingleCandidate
這個還沒有想到應用場景,條件通過的條件是:1 對應的bean容器中只有一個 2.對應的bean有多個,但是已經制定了PRIMARY。例子中,BeanB裝配的時候需要看BeanA的裝配情況,所以BeanBConfig要排在BeanAConfig之后.可以修改BeanAConfig,將@Primary注解去掉,或者把三個@Bean注解去掉,BeanB就不會實例化了。
@Data @AllArgsConstructor @NoArgsConstructor public class BeanA { private String name; }
@Configuration public class BeanAConfig { @Bean @Primary public BeanA bean1(){ return new BeanA("bean1"); } @Bean(autowireCandidate = false) public BeanA bean2(){ return new BeanA("bean2"); } //@Bean(autowireCandidate = false) public BeanA bean3(){ return new BeanA("bean3"); } }
@Data public class BeanB { }
@Configuration @AutoConfigureAfter(BeanAConfig.class) @ConditionalOnSingleCandidate(BeanA.class) public class BeanBConfig { @Bean public BeanB targetBean(){ return new BeanB(); } }
public class TestApp { AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(BeanAConfig.class, BeanBConfig.class); @Test public void test(){ Map<String,BeanA> map = context.getBeansOfType(BeanA.class); System.out.println(map); Map<String,BeanB> map2 = context.getBeansOfType(BeanB.class); System.out.println(map2); } }
@ConditionalOnNotWebApplication & @ConditionalOnWebApplication
判斷當前環境是否是Web應用。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持億速云。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。