[Spring实战系列]（13）使用注解自动装配

[code]<?xmlversion="1.0"encoding="UTF-8"?>

<beansxmlns="http://www.springframework.org/schema/beans"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:context="http://www.springframework.org/schema/context"

xsi:schemaLocation="http://www.springframework.org/schema/beans
'target='_blank'>http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd">
<context:annotation-config/>
</beans>


<context:annotation-config/>元素告诉Spring我们打算使用基于注解的自动装配。一旦装配完成，我们就可以对代码添加注解，表示Spring应该为属性，方法和构造器进行自动装配。

3.使用@Autowired
[code]@Autowired
publicvoidsetSchool(Schoolschool){
this.school=school;
}


当我们对setSchool()方法使用@Autowired注解时，我们可以移除用来定义Student的school属性所对应的<property>元素了。如下面配置文件中的yoonaBean。

[code]<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
'target='_blank'>http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd">
<context:annotation-config/>
<beanid="yoona"class="com.sjf.bean.Student">
<propertyname="name"value="yoona"/>
<propertyname="age"value="24"/>
</bean>
<beanid="xidianSchool"class="com.sjf.bean.School">
<propertyname="name"value="西安电子科技大学"/>
<propertyname="location"value="西安"/>
</bean>
</beans>


运行结果：

name：yoonaage：24school：西安电子科技大学[西安]
在这个实例中，我们对Student的school属性使用使用@Autowired注解，name属性和age属性使用setter注入方式。当Spring发现我们对setSchool()方法使用@Autowired注解时，Spring就会尝试对该方法执行byType自动装配。查询到只有一个Bean（xidianSchool）满足其条件，自动把xidianSchool
Bean注入到Student的school属性中。

注意点：

使用了@Autowired注解时，Spring就会尝试对该方法执行byType自动装配。
特别之处（不同XML方式）：

使用@Autowired注解不只可以使用它标注setter方法，还可以标注需要自动装配Bean引用的任意方法。甚至是构造器，@Autowired注解表示当创建Bean时，即使SpringXML文件中没有使用<constructor-arg>元素配置Bean，该构造器也需要进行自动装配。Spring会从所有满足装配条件的构造器中选择入参最多的那个构造器。还可以标注属性，并可以删除setter方法。
（1）使用@Autowired注解标注setter方法：

[code]@Autowired
publicvoidsetSchool(Schoolschool){
this.school=school;
}


（2）使用@Autowired注解标注属性（不受限于private关键字）：

[code]@Autowired
privateSchoolschool;


（3）使用@Autowired注解标注任意方法：

[code]@Autowired
publicvoidassemblySchool(Schoolschool){
this.school=school;
}


（4）使用@Autowired注解标注构造器：

[code]@Autowired
publicStudent(Schoolschool){
this.school=school;
}


局限性（同于XML方式）：

应用中必须只能有一个Bean适合装配到@Autowired注解所标注的属性或者参数中。如果没有匹配的Bean，或者存在多个匹配的Bean，@Autowired注解就会遇到一些麻烦。

3.1没有匹配的Bean

如果没有匹配的Bean，@Autowired注解就会失败，抛出NoSuchBeanDefinitionException异常。

Causedby:org.springframework.beans.factory.NoSuchBeanDefinitionException:
Noqualifyingbeanoftype[com.sjf.bean.School]foundfordependency:expected
atleast1beanwhichqualifiesasautowirecandidateforthisdependency.Dependencyannotations:{}
atorg.springframework.beans.factory.support.DefaultListableBeanFactory.
raiseNoSuchBeanDefinitionException(DefaultListableBeanFactory.java:1373)
atorg.springframework.beans.factory.support.DefaultListableBeanFactory.
doResolveDependency(DefaultListableBeanFactory.java:1119)
atorg.springframework.beans.factory.support.DefaultListableBeanFactory.
resolveDependency(DefaultListableBeanFactory.java:1014)
atorg.springframework.beans.factory.annotation.
AutowiredAnnotationBeanPostProcessor$AutowiredMethodElement.inject(AutowiredAnnotationBeanPostProcessor.java:618)
...15more
属性不一定非要装配，null值也是可以接受的。这种情况下，我们可以设置@Autowired的required属性为false来装配自动装配的是可选的。

[code]@Autowired(required=false)
publicvoidsetSchool(Schoolschool){
this.school=school;
}


在这里，Spring将尝试装配school属性，但是如果没有查找到与之匹配的类型为School的Bean，不会抛出任何异常，并且StudentBean的school属性会设置为null。

注意点：

required属性可以用于@Autowired注解所使用的任意地方。但是当使用构造器装配时，只有一个构造器可以将@Autowired的required属性设置true。其他使用@Autowired注解所标注的构造器只能将required属性设置为false。

3.2多个匹配的Bean

另一个问题是可能会有足够多的（至少2个）都满足装配条件，并且都可以被装配到属性或参数中。假如，我们有两个Bean是School类型的，满足装配条件。这种情况下，@Autowired注解没有办法选择哪一个Bean才是它需要的，会抛出NoUniqueBeanDefinitionException异常。

[code]<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
'target='_blank'>http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd">
<context:annotation-config/>
<beanid="yoona"class="com.sjf.bean.Student">
<propertyname="name"value="yoona"/>
<propertyname="age"value="24"/>
</bean>
<beanid="xidianSchool"class="com.sjf.bean.School">
<propertyname="name"value="西安电子科技大学"/>
<propertyname="location"value="西安"/>
</bean>
<beanid="shandaSchool"class="com.sjf.bean.School">
<propertyname="name"value="山东大学"/>
<propertyname="location"value="山东"/>
</bean>
</beans>


抛出异常：

Causedby:org.springframework.beans.factory.NoUniqueBeanDefinitionException:
Noqualifyingbeanoftype[com.sjf.bean.School]isdefined:expectedsinglematchingbeanbutfound2:xidianSchool,shandaSchool
atorg.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency(DefaultListableBeanFactory.java:1126)
atorg.springframework.beans.factory.support.DefaultListableBeanFactory.resolveDependency(DefaultListableBeanFactory.java:1014)
atorg.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor$AutowiredMethodElement.
inject(AutowiredAnnotationBeanPostProcessor.java:618)
...15more
为了帮助@Autowired鉴别出哪一个Bean才是我们所需要的，我们可以配合使用Spring的@Qualifier注解。

[code]@Autowired
@Qualifier("shandaSchool")
publicvoidsetSchool(Schoolschool){
this.school=school;
}


这样，我们就使用@Qualifier注解尝试注入ID为"shandaSchool"的Bean。表面上看，把@Autowired的byType自动装配转换为显示的byName装配。实际只是使用@Qualifier注解缩小了自动装配挑选候选Bean的范围。上例中通过指定Bean的ID把选择范围缩小到只剩一个Bean。

除了通过Bean的ID缩小选择范围，还可以通过在Bean上直接使用qualifier来缩小范围。

[code]<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
'target='_blank'>http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd">
<context:annotation-config/>
<beanid="yoona"class="com.sjf.bean.Student">
<propertyname="name"value="yoona"/>
<propertyname="age"value="24"/>
</bean>
<beanid="xidianSchool"class="com.sjf.bean.School">
<propertyname="name"value="西安电子科技大学"/>
<propertyname="location"value="西安"/>
<qualifiervalue="ShanXi"/>
</bean>
<beanid="shandaSchool"class="com.sjf.bean.School">
<propertyname="name"value="山东大学"/>
<propertyname="location"value="山东"/>
<qualifiervalue="ShanDong"/>
</bean>
</beans>


这里，限定shandongSchoolBean是山东地区的大学，xidianSchoolBean是陕西地区的大学。

[code]@Autowired
@Qualifier("ShanXi")
publicvoidsetSchool(Schoolschool){
this.school=school;
}


运行结果：

name：yoonaage：24school：西安电子科技大学[西安]
这里通过指定@Qualifier属性为"ShanXi"，把选择范围缩小到只剩一个Bean（xidianSchool）。

参考：《Spring实战》