@Configuration
在介绍Spring核心容器的系列文章中已经多次出现这个注解,从使用的角度来说可以把他理解为XML配置中的
在
@Configuration的基本使用方法已经在纯Java运行与@Bean的“@Bean注解”部分介绍了使用方法,本篇在此基础上进一步进行说明。
@Configuration添加依赖
除了在纯Java运行与@Bean文中介绍的使用方法,我们还可以直接通过使用Java代码来添加依赖关系:
@ConfigurationpublicclassMyConfig{@BeanpublicAlicealice(){//直接使用方法注入数据。//从表面上看这里调用bob()并没有经过容器处理。而是直接使用了。returnnewAlice(bob()); }@BeanpublicBobbob(){returnnewBob(); }}
看到这里,思维敏捷的码友通过以下逻辑肯定就发现问题了:
通过@Bean注解是向容器添加一个BeanDefinition,
在所有的BeanDefinition创建之后容器开始创建Bean之前会执行预设的后置处理器BeanFactoryPostProcessor。
最后容器根据BeanDefinition的内容创建Bean。
return new Alice(bob()); 这段代码中MyConfig::bob方法的调用看起来完全和容器无关,这样就违反了依赖注入的原则!
所以是不是Alice类中被注入的Bob实例根本就不是IoC容器中的Bob?
首先可以很负责的告诉码友们Spring并没有限制这个方式去添加Bean,所以例子中Alice类中的Bob实例就是IoC容器中的实例。即使是这样去注入Bean同样实现了依赖注入的功能。至于怎么解决的看完本文自然就能得到答案了。
@Component添加依赖
之前在Stereotype组件与Bean扫描这篇文章已经提到过,除了在@Configuration中的方法使用@Bean,还可以在@Component及其派生类中的方法使用@Bean。例如下面的例子:
packagechkui.springcore.example.javabase.configuration.bean;@ComponentpublicclassBeanManager{@BeanpublicCytuscytus(){returnnewCytus();}@BeanpublicDvadva(){returnnewDva();}@BeanpublicGamegame(Dva dva){returnnewGame(cytus(), dva);}}
BeanManager中的三个方法都会向容器添加Bean。注意第三个方法:public Game game(Dva dva)。这里即采用了通过方法参数注入依赖,也像前面的例子一样直接调用了方法。但是这里与前面介绍的使用@Configuration注解不同,Game中的Cytus实例不是IoC容器中的Cytus。
通过下面的例子来说明@Configuration和@Component中注入Bean的差异。
//package chkui.springcore.example.javabase.configuration;//使用@Configuration注解@ConfigurationclassConfig{@BeanpublicAlicealice(){returnnewAlice(bob());}@BeanpublicBobbob(){returnnewBob();}}//package chkui.springcore.example.javabase.configuration.bean;//使用@Component注解@ComponentpublicclassBeanManager{@BeanpublicCytuscytus(){returnnewCytus();}@BeanpublicDvadva(){returnnewDva();}@BeanpublicGamegame(Dva dva){returnnewGame(cytus(), dva);}}//运行publicclassConfigurationApp{publicstaticvoidmain(String[] args){ApplicationContext ctx =newAnnotationConfigApplicationContext(Config.class, BeanManager.class);Bob bob = ctx.getBean(Bob.class);Alice alice = ctx.getBean(Alice.class);System.out.println("Bob instance of IoC hash: "+ bob.hashCode());System.out.println("Bob instance of Alice hash: "+ alice.getBob().hashCode());System.out.println("Compare:"+ (bob == alice.getBob()));System.out.println("Config instance:"+ ctx.getBean(Config.class));Game game = ctx.getBean(Game.class);Cytus cytus = ctx.getBean(Cytus.class);Dva dva = ctx.getBean(Dva.class);System.out.println("IoC Cytus: "+ cytus.hashCode());System.out.println("Game Cytus: "+ game.getCytus().hashCode());System.out.println("IoC Dva: "+ dva.hashCode());System.out.println("Game Dva: "+ game.getDva().hashCode());System.out.println("Cytus:"+ (cytus == game.getCytus()));System.out.println("Dva:"+ (dva == game.getDva()));System.out.println("BeanManager Instance:"+ ctx.getBean(BeanManager.class));}}
在最后的main方法中我们对容器中以及Alice、Game中包含的实例进行了hash以及实例对比,在我的电脑上输出结果如下:
1.Bob instance of IoChash: 12420275252.Bob instance of Alicehash: 12420275253.Compare:true4.Config instance:5.chkui.springcore.example.javabase.configuration.Config$$EnhancerBySpringCGLIB$$acdbeb32@74287ea36.IoC Cytus: 21049735027.Game Cytus: 7359374288.IoC Dva: 16042473169.Game Dva: 160424731610.Cytus:false11.Dva:true12.BeanManager Instance:chkui.springcore.example.javabase.configuration.bean.BeanManager@68746f22
例子中分别在@Configuration和@Component标记的类中使用@Bean来向容器添加Bean。最后通过输出实例的hash以及地址匹配(使用“==”比对)来确定是否都是同一个单例。
很明显IoC容器中的Cytus以Game中的Cytus并不是一个实例,其他都是同一个单例。仔细看看第4行和第12行的Config instance和BeanManager instance的输出内容就会得到答案。
BeanManager是一个常规的类,而在JVM中运行的Config是一个通过CGLIB实现的字节码级别的代理类(如果不知道CGLIB是什么就自己网上找找吧,这玩意在Java界已经红得发紫了)。Spring实际上是使用CGLIB为Config类添加了一个“代理壳”,当我们在任何地方直接调用@Configuration标注的类中的的方法时,代理壳都会将其整理为一个BeanDefinition的转换过程。
知道两者的差异后我们选择何种方式来添加Bean就很清晰了:
使用@Configuration能保证不会出现例子中Cytus这样的例外。也能清晰的明确@Configuration等价于一个
而在@Component或其他组建中使用@Bean好处是不会启动CGLIB这种重量级工具(不过在Spring中即使这里不使用,其他很多地方也在使用)。并且@Component及其相关的Stereotype组件自身就有摸框级别的功能,在这里使用@Bean注解能很好的表明一个Bean的从属和结构关系,但是需要注意直接调用方法的“副作用”。
个人建议如果没什么特别的要求就使用@Configuration,引入CGLIB并不会影响多少性能,然而坑会少很多。在spring官网将用@Configuration创建的@Bean称呼为"Full"模式、将@Component创建的@Bean称呼为"'lite"模式,从字面上也能略知他们的差异。
多种方式混合使用
从XML配置到纯Java配置,Spring变得越来越简便好用,对应的功能也越来越多样化。如果对他的脉络没有清晰的认识,往往会陷入迷惑中。无论功能再复杂我们都要记住本系列文章开篇提到的IoC容器的初衷:
处理容器与Bean、Bean与Bean的关系。Bean是最小的工作单元,一切功能都是在Bean基础上扩展而来的。
所以无论是XML配置还是纯Java配置基本目标就是解决三个问题:向容器添加Bean,确定Bean的功能,确定Bean与Bean之间的依赖关系。
既然XML和纯Java配置都是解决同样的问题,那么混合使用当然没问题。比如在XML中配置了
下面是一个使用AnnotationConfigApplicationContext启动容器混合使用Java配置与XML配置的例子。
首先我们使用AnnotationConfigApplicationContext启动IoC容器:
packagechkui.springcore.example.javabase.multiconfiguration;@Configuration@ComponentScans({@ComponentScan("chkui.springcore.example.javabase.multiconfiguration.config"),@ComponentScan("chkui.springcore.example.javabase.multiconfiguration.service") })publicclassMultiConfigurationApp{publicstaticvoidmain(String[] args){ApplicationContext ctx =newAnnotationConfigApplicationContext(MultiConfigurationApp.class);}}
在Main方法中直接指定了当前的类,所以MultiConfigurationApp类会成为一个Bean。由于是一个Stereotype模式的@Configuration标记类(@Configuration继承自@Component,提供了配置相关的分层功能,关于Stereotype模式的内容相见Stereotype组件与Bean扫描),所以容器会用CGLIB来代理它实现配置相关的功能。@ComponentScans是一个辅助注解,他的作用就是整合多个@ComponentScan一起使用。
在config包中有2个@Configuration类:
packagechkui.springcore.example.javabase.multiconfiguration.config;@Configuration@Import({ClubConfiguration.class})@ImportResource("javabase/multiconfiguration/config.xml")publicclassMainConfiguration{}
packagechkui.springcore.example.javabase.multiconfiguration.config;publicclassClubConfiguration{@BeanpublicMilmil(){returnnewMil();}@BeanpublicMaumau(){returnnewMau();}}
MainConfiguration类被标记了@Configuration注解,所以他会被扫描并添加到容器中。
@Import注解的作用是引入其他类成为一个Bean,我们可以看到ClubConfiguration类并没有任何注解,但是他通过@Import注解在其他类添加到容器中。
而@ImportResource等价于XML配置中的
这样XML配置中的2个类也会被添加到容器中。案例中对应的实体类如下:
packagechkui.springcore.example.javabase.multiconfiguration.bean;classMau{publicStringtoString(){return"Manchester United[MAU]";}}classCfc{publicStringtoString(){return"Chelsea Football Club[CFC]";}}classMil{publicStringtoString(){return"A.C Milan [MIL]";}}classJav{publicStringtoString(){return"Juventus [JAV]";}}
Conditionally
最后在使用@Configuration时可以使用Conditionally特性来确定是否添加Bean。大致用法就是实现Condition接口,然后通过@Conditional注解和@Bean绑定在一起进行条件判断。
实现Condition:
packagechkui.springcore.example.javabase.multiconfiguration.config;publicclassSoySauceConditionimplementsCondition{@Overridepublicbooleanmatches(ConditionContext context, AnnotatedTypeMetadata metadata){returnfalse;//返回false则不会对应的Bean。}}
然后使用@Conditional注解绑定到一个@Bean上:
packagechkui.springcore.example.javabase.multiconfiguration.config;publicclassClubConfiguration{@Bean@Conditional(SoySauceCondition.class)publicSoySaucesoySauce(){returnnewSoySauce();}}
这样,如果SoySauceCondition中的matches方法返回ture则添加SoySauce到IoC容器中,否则不会存在这个Bean。