spring注解详解Word格式.docx
《spring注解详解Word格式.docx》由会员分享,可在线阅读,更多相关《spring注解详解Word格式.docx(20页珍藏版)》请在冰豆网上搜索。
publicStringtoString(){
return"
officeNo:
"
+officeNo;
}
}
Car拥有两个属性:
清单2.Car.java
publicclassCar{
privateStringbrand;
privatedoubleprice;
//省略get/setter
brand:
+brand+"
"
+"
price:
+price;
Boss拥有Office和Car类型的两个属性:
清单3.Boss.java
publicclassBoss{
privateCarcar;
privateOfficeoffice;
car:
+car+"
\n"
office:
+office;
我们在Spring容器中将Office和Car声明为Bean,并注入到BossBean中:
下面是使用传统XML完成这个工作的配置文件beans.xml:
清单4.beans.xml将以上三个类配置成Bean
<
?
xmlversion="
1.0"
encoding="
UTF-8"
?
>
beansxmlns="
http:
//www.springframework.org/schema/beans"
xmlns:
xsi="
//www.w3.org/2001/XMLSchema-instance"
xsi:
schemaLocation="
//www.springframework.org/schema/beans
http:
//www.springframework.org/schema/beans/spring-beans-2.5.xsd"
<
beanid="
boss"
class="
com.baobaotao.Boss"
propertyname="
car"
ref="
/>
office"
/>
/bean>
com.baobaotao.Office"
officeNo"
value="
002"
com.baobaotao.Car"
scope="
singleton"
brand"
红旗CA72"
price"
2000"
/beans>
当我们运行以下代码时,控制台将正确打出boss的信息:
清单5.测试类:
AnnoIoCTest.java
importorg.springframework.context.ApplicationContext;
importorg.springframework.context.support.ClassPathXmlApplicationContext;
publicclassAnnoIoCTest{
publicstaticvoidmain(String[]args){
String[]locations={"
beans.xml"
};
ApplicationContextctx=
newClassPathXmlApplicationContext(locations);
Bossboss=(Boss)ctx.getBean("
);
System.out.println(boss);
这说明Spring容器已经正确完成了Bean创建和装配的工作。
使用@Autowired注释
Spring2.5引入了@Autowired注释,它可以对类成员变量、方法及构造函数进行标注,完成自动装配的工作。
来看一下使用@Autowired进行成员变量自动注入的代码:
清单6.使用@Autowired注释的Boss.java
importorg.springframework.beans.factory.annotation.Autowired;
@Autowired
…
Spring通过一个BeanPostProcessor对@Autowired进行解析,所以要让@Autowired起作用必须事先在Spring容器中声明AutowiredAnnotationBeanPostProcessorBean。
清单7.让@Autowired注释工作起来
!
--该BeanPostProcessor将自动起作用,对标注@Autowired的Bean进行自动注入-->
beanclass="
org.springframework.beans.factory.annotation.
AutowiredAnnotationBeanPostProcessor"
--移除bossBean的属性注入配置的信息-->
001"
这样,当Spring容器启动时,AutowiredAnnotationBeanPostProcessor将扫描Spring容器中所有Bean,当发现Bean中拥有@Autowired注释时就找到和其匹配(默认按类型匹配)的Bean,并注入到对应的地方中去。
按照上面的配置,Spring将直接采用Java反射机制对Boss中的car和office这两个私有成员变量进行自动注入。
所以对成员变量使用@Autowired后,您大可将它们的setter方法(setCar()和setOffice())从Boss中删除。
当然,您也可以通过@Autowired对方法或构造函数进行标注,来看下面的代码:
清单8.将@Autowired注释标注在Setter方法上
publicvoidsetCar(Carcar){
this.car=car;
publicvoidsetOffice(Officeoffice){
this.office=office;
这时,@Autowired将查找被标注的方法的入参类型的Bean,并调用方法自动注入这些Bean。
而下面的使用方法则对构造函数进行标注:
清单9.将@Autowired注释标注在构造函数上
publicBoss(Carcar,Officeoffice){
this.office=office;
由于Boss()构造函数有两个入参,分别是car和office,@Autowired将分别寻找和它们类型匹配的Bean,将它们作为Boss(Carcar,Officeoffice)的入参来创建BossBean。
当候选Bean数目不为1时的应对方法
在默认情况下使用@Autowired注释进行自动注入时,Spring容器中匹配的候选Bean数目必须有且仅有一个。
当找不到一个匹配的Bean时,Spring容器将抛出BeanCreationException异常,并指出必须至少拥有一个匹配的Bean。
我们可以来做一个实验:
清单10.候选Bean数目为0时
//www.springframework.org/schema/beans/spring-beans-2.5.xsd"
--将officeBean注释掉-->
--<
-->
由于officeBean被注释掉了,所以Spring容器中将没有类型为Office的Bean了,而Boss的office属性标注了@Autowired,当启动Spring容器时,异常就产生了。
当不能确定Spring容器中一定拥有某个类的Bean时,可以在需要自动注入该类Bean的地方可以使用@Autowired(required=false),这等于告诉Spring:
在找不到匹配Bean时也不报错。
来看一下具体的例子:
清单11.使用@Autowired(required=false)
importorg.springframework.beans.factory.annotation.Required;
@Autowired(required=false)
当然,一般情况下,使用@Autowired的地方都是需要注入Bean的,使用了自动注入而又允许不注入的情况一般仅会在开发期或测试期碰到(如为了快速启动Spring容器,仅引入一些模块的Spring配置文件),所以@Autowired(required=false)会很少用到。
和找不到一个类型匹配Bean相反的一个错误是:
如果Spring容器中拥有多个候选Bean,Spring容器在启动时也会抛出BeanCreationException异常。
来看下面的例子:
清单12.在beans.xml中配置两个Office类型的Bean
…
office2"
…
我们在Spring容器中配置了两个类型为Office类型的Bean,当对Boss的office成员变量进行自动注入时,Spring容器将无法确定到底要用哪一个Bean,因此异常发生了。
Spring允许我们通过@Qualifier注释指定注入Bean的名称,这样歧义就消除了,可以通过下面的方法解决异常:
清单13.使用@Qualifier注释指定注入Bean的名称
@Autowired
publicvoidsetOffice(@Qualifier("
)Officeoffice){
@Qualifier("
)中的office是Bean的名称,所以@Autowired和@Qualifier结合使用时,自动注入的策略就从byType转变成byName了。
@Autowired可以对成员变量、方法以及构造函数进行注释,而@Qualifier的标注对象是成员变量、方法入参、构造函数入参。
正是由于注释对象的不同,所以Spring不将@Autowired和@Qualifier统一成一个注释类。
下面是对成员变量和构造函数入参进行注释的代码:
对成员变量进行注释:
清单14.对成员变量使用@Qualifier注释
@Qualifier("
)
对构造函数入参进行注释:
清单15.对构造函数变量使用@Qualifier注释
publicBoss(Carcar,@Qualifier("
)Officeoffice){
@Qualifier只能和@Autowired结合使用,是对@Autowired有益的补充。
一般来讲,@Qualifier对方法签名中入参进行注释会降低代码的可读性,而对成员变量注释则相对好一些。
使用JSR-250的注释
Spring不但支持自己定义的@Autowired的注释,还支持几个由JSR-250规范定义的注释,它们分别是@Resource、@PostConstruct以及@PreDestroy。
@Resource
@Resource的作用相当于@Autowired,只不过@Autowired按byType自动注入,面@Resource默认按byName自动注入罢了。
@Resource有两个属性是比较重要的,分别是name和type,Spring将@Resource注释的name属性解析为Bean的名字,而type属性则解析为Bean的类型。
所以如果使用name属性,则使用byName的自动注入策略,而使用type属性时则使用byType自动注入策略。
如果既不指定name也不指定type属性,这时将通过反射机制使用byName自动注入策略。
Resource注释类位于Spring发布包的lib/j2ee/common-annotations.jar类包中,因此在使用之前必须将其加入到项目的类库中。
来看一个使用@Resource的例子:
清单16.使用@Resource注释的Boss.java
importjavax.annotation.Resource;
//自动注入类型为Car的Bean
@Resource
//自动注入bean名称为office的Bean
@Resource(name="
一般情况下,我们无需使用类似于@Resource(type=Car.class)的注释方式,因为Bean的类型信息可以通过Java反射从代码中获取。
要让JSR-250的注释生效,除了在Bean类中标注这些注释外,还需要在Spring容器中注册一个负责处理这些注释的BeanPostProcessor:
bean
org.springframework.context.annotation.CommonAnnotationBeanPostProcessor"
CommonAnnotationBeanPostProcessor实现了BeanPostProcessor接口,它负责扫描使用了JSR-250注释的Bean,并对它们进行相应的操作。
@PostConstruct和@PreDestroy
Spring容器中的Bean是有生命周期的,Spring允许在Bean在初始化完成后以及Bean销毁前执行特定的操作,您既可以通过实现InitializingBean/DisposableBean接口来定制初始化之后/销毁之前的操作方法,也可以通过<
bean>
元素的init-method/destroy-method属性指定初始化之后/销毁之前调用的操作方法。
关于Spring的生命周期,笔者在《精通Spring2.x—企业应用开发精解》第3章进行了详细的描述,有兴趣的读者可以查阅。
JSR-250为初始化之后/销毁之前方法的指定定义了两个注释类,分别是@PostConstruct和@PreDestroy,这两个注释只能应用于方法上。
标注了@PostConstruct注释的方法将在类实例化后调用,而标注了@PreDestroy的方法将在类销毁之前调用。
清单17.使用@PostConstruct和@PreDestroy注释的Boss.java
importjavax.annotation.Resour