spring注解详解.docx
- 文档编号:6326085
- 上传时间:2023-01-05
- 格式:DOCX
- 页数:20
- 大小:24.99KB
spring注解详解.docx
《spring注解详解.docx》由会员分享,可在线阅读,更多相关《spring注解详解.docx(20页珍藏版)》请在冰豆网上搜索。
spring注解详解
概述
注释配置相对于XML配置具有很多的优势:
∙它可以充分利用Java的反射机制获取类结构信息,这些信息可以有效减少配置的工作。
如使用JPA注释配置ORM映射时,我们就不需要指定PO的属性名、类型等信息,如果关系表字段和PO属性名、类型都一致,您甚至无需编写任务属性映射信息——因为这些信息都可以通过Java反射机制获取。
∙注释和Java代码位于一个文件中,而XML配置采用独立的配置文件,大多数配置信息在程序开发完成后都不会调整,如果配置信息和Java代码放在一起,有助于增强程序的内聚性。
而采用独立的XML配置文件,程序员在编写一个功能时,往往需要在程序文件和配置文件中不停切换,这种思维上的不连贯会降低开发效率。
因此在很多情况下,注释配置比XML配置更受欢迎,注释配置有进一步流行的趋势。
Spring2.5的一大增强就是引入了很多注释类,现在您已经可以使用注释配置完成大部分XML配置的功能。
在这篇文章里,我们将向您讲述使用注释进行Bean定义和依赖注入的内容。
原来我们是怎么做的
在使用注释配置之前,先来回顾一下传统上是如何配置Bean并完成Bean之间依赖关系的建立。
下面是3个类,它们分别是Office、Car和Boss,这3个类需要在Spring容器中配置为Bean:
Office仅有一个属性:
清单1.Office.java
packagecom.baobaotao;
publicclassOffice{
privateStringofficeNo=”001”;
//省略get/setter
@Override
publicStringtoString(){
return"officeNo:
"+officeNo;
}
}
Car拥有两个属性:
清单2.Car.java
packagecom.baobaotao;
publicclassCar{
privateStringbrand;
privatedoubleprice;
//省略get/setter
@Override
publicStringtoString(){
return"brand:
"+brand+","+"price:
"+price;
}
}
Boss拥有Office和Car类型的两个属性:
清单3.Boss.java
packagecom.baobaotao;
publicclassBoss{
privateCarcar;
privateOfficeoffice;
//省略get/setter
@Override
publicStringtoString(){
return"car:
"+car+"\n"+"office:
"+office;
}
}
我们在Spring容器中将Office和Car声明为Bean,并注入到BossBean中:
下面是使用传统XML完成这个工作的配置文件beans.xml:
清单4.beans.xml将以上三个类配置成Bean
xmlversion="1.0"encoding="UTF-8"?
>
//www.springframework.org/schema/beans" xmlns: xsi="http: //www.w3.org/2001/XMLSchema-instance" xsi: schemaLocation="http: //www.springframework.org/schema/beans http: //www.springframework.org/schema/beans/spring-beans-2.5.xsd"> 当我们运行以下代码时,控制台将正确打出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("boss"); System.out.println(boss); } } 这说明Spring容器已经正确完成了Bean创建和装配的工作。 使用@Autowired注释 Spring2.5引入了@Autowired注释,它可以对类成员变量、方法及构造函数进行标注,完成自动装配的工作。 来看一下使用@Autowired进行成员变量自动注入的代码: 清单6.使用@Autowired注释的Boss.java packagecom.baobaotao; importorg.springframework.beans.factory.annotation.Autowired; publicclassBoss{ @Autowired privateCarcar; @Autowired privateOfficeoffice; … } Spring通过一个BeanPostProcessor对@Autowired进行解析,所以要让@Autowired起作用必须事先在Spring容器中声明AutowiredAnnotationBeanPostProcessorBean。 清单7.让@Autowired注释工作起来 xmlversion="1.0"encoding="UTF-8"? > //www.springframework.org/schema/beans" xmlns: xsi="http: //www.w3.org/2001/XMLSchema-instance" xsi: schemaLocation="http: //www.springframework.org/schema/beans http: //www.springframework.org/schema/beans/spring-beans-2.5.xsd"> --该BeanPostProcessor将自动起作用,对标注@Autowired的Bean进行自动注入--> AutowiredAnnotationBeanPostProcessor"/> --移除bossBean的属性注入配置的信息--> 这样,当Spring容器启动时,AutowiredAnnotationBeanPostProcessor将扫描Spring容器中所有Bean,当发现Bean中拥有@Autowired注释时就找到和其匹配(默认按类型匹配)的Bean,并注入到对应的地方中去。 按照上面的配置,Spring将直接采用Java反射机制对Boss中的car和office这两个私有成员变量进行自动注入。 所以对成员变量使用@Autowired后,您大可将它们的setter方法(setCar()和setOffice())从Boss中删除。 当然,您也可以通过@Autowired对方法或构造函数进行标注,来看下面的代码: 清单8.将@Autowired注释标注在Setter方法上 packagecom.baobaotao; publicclassBoss{ privateCarcar; privateOfficeoffice; @Autowired publicvoidsetCar(Carcar){ this.car=car; } @Autowired publicvoidsetOffice(Officeoffice){ this.office=office; } … } 这时,@Autowired将查找被标注的方法的入参类型的Bean,并调用方法自动注入这些Bean。 而下面的使用方法则对构造函数进行标注: 清单9.将@Autowired注释标注在构造函数上 packagecom.baobaotao; publicclassBoss{ privateCarcar; privateOfficeoffice; @Autowired publicBoss(Carcar,Officeoffice){ this.car=car; this.office=office; } … } 由于Boss()构造函数有两个入参,分别是car和office,@Autowired将分别寻找和它们类型匹配的Bean,将它们作为Boss(Carcar,Officeoffice)的入参来创建BossBean。 当候选Bean数目不为1时的应对方法 在默认情况下使用@Autowired注释进行自动注入时,Spring容器中匹配的候选Bean数目必须有且仅有一个。 当找不到一个匹配的Bean时,Spring容器将抛出BeanCreationException异常,并指出必须至少拥有一个匹配的Bean。 我们可以来做一个实验: 清单10.候选Bean数目为0时 xmlversion="1.0"encoding="UTF-8"? > //www.springframework.org/schema/beans" xmlns: xsi="http: //www.w3.org/2001/XMLSchema-instance" xsi: schemaLocation="http: //www.springframework.org/schema/beans http: //www.springframework.org/schema/beans/spring-beans-2.5.xsd"> AutowiredAnnotationBeanPostProcessor"/> --将officeBean注释掉--> -- --> 由于officeBean被注释掉了,所以Spring容器中将没有类型为Office的Bean了,而Boss的office属性标注了@Autowired,当启动Spring容器时,异常就产生了。 当不能确定Spring容器中一定拥有某个类的Bean时,可以在需要自动注入该类Bean的地方可以使用@Autowired(required=false),这等于告诉Spring: 在找不到匹配Bean时也不报错。 来看一下具体的例子: 清单11.使用@Autowired(required=false) packagecom.baobaotao; importorg.springframework.beans.factory.annotation.Autowired; importorg.springframework.beans.factory.annotation.Required; publicclassBoss{ privateCarcar; privateOfficeoffice; @Autowired publicvoidsetCar(Carcar){ this.car=car; } @Autowired(required=false) publicvoidsetOffice(Officeoffice){ this.office=office; } … } 当然,一般情况下,使用@Autowired的地方都是需要注入Bean的,使用了自动注入而又允许不注入的情况一般仅会在开发期或测试期碰到(如为了快速启动Spring容器,仅引入一些模块的Spring配置文件),所以@Autowired(required=false)会很少用到。 和找不到一个类型匹配Bean相反的一个错误是: 如果Spring容器中拥有多个候选Bean,Spring容器在启动时也会抛出BeanCreationException异常。 来看下面的例子: 清单12.在beans.xml中配置两个Office类型的Bean … … 我们在Spring容器中配置了两个类型为Office类型的Bean,当对Boss的office成员变量进行自动注入时,Spring容器将无法确定到底要用哪一个Bean,因此异常发生了。 Spring允许我们通过@Qualifier注释指定注入Bean的名称,这样歧义就消除了,可以通过下面的方法解决异常: 清单13.使用@Qualifier注释指定注入Bean的名称 @Autowired publicvoidsetOffice(@Qualifier("office")Officeoffice){ this.office=office; } @Qualifier("office")中的office是Bean的名称,所以@Autowired和@Qualifier结合使用时,自动注入的策略就从byType转变成byName了。 @Autowired可以对成员变量、方法以及构造函数进行注释,而@Qualifier的标注对象是成员变量、方法入参、构造函数入参。 正是由于注释对象的不同,所以Spring不将@Autowired和@Qualifier统一成一个注释类。 下面是对成员变量和构造函数入参进行注释的代码: 对成员变量进行注释: 清单14.对成员变量使用@Qualifier注释 publicclassBoss{ @Autowired privateCarcar; @Autowired @Qualifier("office") privateOfficeoffice; … } 对构造函数入参进行注释: 清单15.对构造函数变量使用@Qualifier注释 publicclassBoss{ privateCarcar; privateOfficeoffice; @Autowired publicBoss(Carcar,@Qualifier("office")Officeoffice){ this.car=car; this.office=office; } } @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 packagecom.baobaotao; importjavax.annotation.Resource; publicclassBoss{ //自动注入类型为Car的Bean @Resource privateCarcar; //自动注入bean名称为office的Bean @Resource(name="office") privateOfficeoffice; } 一般情况下,我们无需使用类似于@Resource(type=Car.class)的注释方式,因为Bean的类型信息可以通过Java反射从代码中获取。 要让JSR-250的注释生效,除了在Bean类中标注这些注释外,还需要在Spring容器中注册一个负责处理这些注释的BeanPostProcessor: class="org.springframework.context.annotation.CommonAnnotationBeanPostProcessor"/> CommonAnnotationBeanPostProcessor实现了BeanPostProcessor接口,它负责扫描使用了JSR-250注释的Bean,并对它们进行相应的操作。 @PostConstruct和@PreDestroy Spring容器中的Bean是有生命周期的,Spring允许在Bean在初始化完成后以及Bean销毁前执行特定的操作,您既可以通过实现InitializingBean/DisposableBean接口来定制初始化之后/销毁之前的操作方法,也可以通过 关于Spring的生命周期,笔者在《精通Spring2.x—企业应用开发精解》第3章进行了详细的描述,有兴趣的读者可以查阅。 JSR-250为初始化之后/销毁之前方法的指定定义了两个注释类,分别是@PostConstruct和@PreDestroy,这两个注释只能应用于方法上。 标注了@PostConstruct注释的方法将在类实例化后调用,而标注了@PreDestroy的方法将在类销毁之前调用。 清单17.使用@PostConstruct和@PreDestroy注释的Boss.java packagecom.baobaotao; importjavax.annotation.Resour
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- spring 注解 详解