Spring2.5的新特性—Autowired实现快速的自动注入

使用Spring2.5的新特性——Autowired可以实现快速的自动注入，而无需在xml文档里面添加bean的声明，大大减少了xml文档的维护。（偶喜欢这个功能，因为偶对xml不感冒）。      

以下是一个例子：  

先编写接口Man：  

   1. public interface Man {      
   2.   
   3.       public String sayHello();      
   4.   
   5. }      

然后写Man的实现类Chinese和American：  

   1. @Service     
   2.   
   3. public class Chinese implements Man{      
   4.   
   5.     public String sayHello() {      
   6.   
   7.         return "I am Chinese!";      
   8.   
   9.     }      
  10.   
  11. }      
  12.   
  13.      
  14.   
  15. @Service     
  16.   
  17. public class American implements Man{      
  18.   
  19.     public String sayHello() {      
  20.   
  21.         return "I am American!";      
  22.   
  23.     }      
  24.   
  25. }      
  26.   

      @Service注释表示定义一个bean，自动根据bean的类名实例化一个首写字母为小写的bean，例如Chinese实例化为 chinese，American实例化为american，如果需要自己改名字则:@Service("你自己改的bean名")。  

beans.xml  

   1. <?xml version="1.0" encoding="UTF-8"?>      
   2.   
   3. <beans xmlns="http://www.springframework.org/schema/beans"     
   4.   
   5.         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     
   6.   
   7.         xmlns:context="http://www.springframework.org/schema/context"     
   8.   
   9.         xsi:schemaLocation="http://www.springframework.org/schema/beans       
  10.   
  11.            http://www.springframework.org/schema/beans/spring-beans-2.5.xsd      
  12.   
  13.            http://www.springframework.org/schema/context      
  14.   
  15.            http://www.springframework.org/schema/context/spring-context-2.5.xsd">      
  16.   
  17.       <context:annotation-config/>      
  18.   
  19.       <context:component-scan base-package="testspring.main"/>      
  20.   
  21. </beans>      
  22.   

在spring的配置文件里面只需要加上<context:annotation-config/> 和<context:component-scan base-package="需要实现注入的类所在包"/>，可以使用base-package="*"表示全部的类。  

编写主类测试：  

   1. @Service     
   2.   
   3. public class Main {      
   4.   
   5.     @Autowired     
   6.   
   7.     @Qualifier("chinese")      
   8.   
   9.     private Man man;      
  10.   
  11.      
  12.   
  13.     public static void main(String[] args) {      
  14.   
  15.         // TODO code application logic here      
  16.   
  17.         ApplicationContext ctx = new ClassPathXmlApplicationContext("beans.xml");      
  18.   
  19.         Main main = (Main) ctx.getBean("main");      
  20.   
  21.         System.out.println(main.getMan().sayHello());      
  22.   
  23.     }      
  24.   
  25.      
  26.   
  27.     public Man getMan() {      
  28.   
  29.         return man;      
  30.   
  31.     }      
  32.   
  33. }      
  34.   

在Man接口前面标上@Autowired和@Qualifier注释使得Man接口可以被容器注入，当Man接口存在两个实现类的时候必须指定其中一个来注入，使用实现类首字母小写的字符串来注入。否则可以省略，只写@Autowired   

 

**********************  

使用 Spring 2.5 注释驱动的 IoC 功能  

注释配置相对于 XML 配置具有很多的优势：  

它可以充分利用 Java 的反射机制获取类结构信息，这些信息可以有效减少配置的工作。如使用 JPA 注释配置 ORM 映射时，我们就不需要指定 PO 的属性名、类型等信息，如果关系表字段和 PO 属性名、类型都一致，您甚至无需编写任务属性映射信息——因为这些信息都可以通过 Java 反射机制获取。   

注释和 Java 代码位于一个文件中，而 XML 配置采用独立的配置文件，大多数配置信息在程序开发完成后都不会调整，如果配置信息和 Java 代码放在一起，有助于增强程序的内聚性。而采用独立的 XML 配置文件，程序员在编写一个功能时，往往需要在程序文件和配置文件中不停切换，这种思维上的不连贯会降低开发效率。   

因此在很多情况下，注释配置比 XML 配置更受欢迎，注释配置有进一步流行的趋势。Spring 2.5 的一大增强就是引入了很多注释类，现在您已经可以使用注释配置完成大部分 XML 配置的功能。在这篇文章里，我们将向您讲述使用注释进行 Bean 定义和依赖注入的内容。  


原来我们是怎么做的  

在使用注释配置之前，先来回顾一下传统上是如何配置 Bean 并完成 Bean 之间依赖关系的建立。下面是 3 个类，它们分别是 Office、Car 和 Boss，这 3 个类需要在 Spring 容器中配置为 Bean：  

Office 仅有一个属性：  

清单 1. Office.java  

   1. package com.baobaotao;      
   2.   
   3. public class Office {      
   4.   
   5.     private String officeNo =”001”;      
   6.   
   7.      
   8.   
   9.     //省略 get /setter      
  10.   
  11.      
  12.   
  13.     @Override     
  14.   
  15.     public String toString() {      
  16.   
  17.         return "officeNo:" + officeNo;      
  18.   
  19.     }      
  20.   
  21. }      
  22.   

 

Car 拥有两个属性：  

清单 2. Car.java          

   1. package com.baobaotao;      
   2.   
   3. public class Car {      
   4.   
   5.     private String brand;      
   6.   
   7.     private double price;      
   8.   
   9.      // 省略 get /setter      
  10.   
  11.       @Override     
  12.   
  13.     public String toString() {      
  14.   
  15.         return "brand:" + brand + "," + "price:" + price;      
  16.   
  17.     }      
  18.   
  19. }      
  20.   

 

Boss 拥有 Office 和 Car 类型的两个属性：  

清单 3. Boss.java  

   1. package com.baobaotao;      
   2.   
   3. public class Boss {      
   4.   
   5.     private Car car;      
   6.   
   7.     private Office office;      
   8.   
   9.      // 省略 get /setter      
  10.   
  11.      @Override     
  12.   
  13.     public String toString() {      
  14.   
  15.         return "car:" + car + "\n" + "office:" + office;      
  16.   
  17.     }      
  18.   
  19. }      
  20.   

我们在 Spring 容器中将 Office 和 Car 声明为 Bean，并注入到 Boss Bean 中：下面是使用传统 XML 完成这个工作的配置文件 beans.xml：  

清单 4. beans.xml 将以上三个类配置成 Bean  

   1. <?xml version="1.0" encoding="UTF-8" ?>      
   2.   
   3. <beans xmlns="http://www.springframework.org/schema/beans"     
   4.   
   5.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     
   6.   
   7.     xsi:schemaLocation="http://www.springframework.org/schema/beans       
   8.   
   9.  http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">      
  10.   
  11.     <bean id="boss" class="com.baobaotao.Boss">      
  12.   
  13.         <property name="car" ref="car"/>      
  14.   
  15.         <property name="office" ref="office" />      
  16.   
  17.     </bean>      
  18.   
  19.     <bean id="office" class="com.baobaotao.Office">      
  20.   
  21.         <property name="officeNo" value="002"/>      
  22.   
  23.     </bean>      
  24.   
  25.     <bean id="car" class="com.baobaotao.Car" scope="singleton">      
  26.   
  27.         <property name="brand" value=" 红旗 CA72"/>      
  28.   
  29.         <property name="price" value="2000"/>      
  30.   
  31.     </bean>      
  32.   
  33. </beans>      
  34.   

 

当我们运行以下代码时，控制台将正确打出 boss 的信息：  

清单 5. 测试类：AnnoIoCTest.java    

   1. import org.springframework.context.ApplicationContext;      
   2.   
   3. import org.springframework.context.support.ClassPathXmlApplicationContext;      
   4.   
   5. public class AnnoIoCTest {      
   6.   
   7.      
   8.   
   9.     public static void main(String[] args) {      
  10.   
  11.         String[] locations = {"beans.xml"};      
  12.   
  13.         ApplicationContext ctx =       
  14.   
  15.             new ClassPathXmlApplicationContext(locations);      
  16.   
  17.         Boss boss = (Boss) ctx.getBean("boss");      
  18.   
  19.         System.out.println(boss);      
  20.   
  21.     }      
  22.   
  23. }      
  24.   

这说明 Spring 容器已经正确完成了 Bean 创建和装配的工作。  

 

使用 @Autowired 注释  

Spring 2.5 引入了 @Autowired 注释，它可以对类成员变量、方法及构造函数进行标注，完成自动装配的工作。来看一下使用 @Autowired 进行成员变量自动注入的代码：  

清单 6. 使用 @Autowired 注释的 Boss.java  

   1. package com.baobaotao;      
   2.   
   3. import org.springframework.beans.factory.annotation.Autowired;      
   4.   
   5.   
   6. public class Boss {      
   7.   
   8.   
   9.     @Autowired     
  10.   
  11.     private Car car;      
  12.      
  13.   
  14.     @Autowired     
  15.   
  16.     private Office office;      
  17.   
  18.      
  19.   
  20.     …      
  21.   
  22. }      
  23.   

Spring 通过一个 BeanPostProcessor 对 @Autowired 进行解析，所以要让 @Autowired 起作用必须事先在 Spring 容器中声明 AutowiredAnnotationBeanPostProcessor Bean。  

清单 7. 让 @Autowired 注释工作起来  

   1. <?xml version="1.0" encoding="UTF-8" ?>      
   2.   
   3. <beans xmlns="http://www.springframework.org/schema/beans"     
   4.   
   5.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     
   6.   
   7.     xsi:schemaLocation="http://www.springframework.org/schema/beans       
   8.   
   9.  http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">      
  10.   
  11.       <!-- 该 BeanPostProcessor 将自动起作用，对标注 @Autowired 的 Bean 进行自动注入 -->      
  12.   
  13.     <bean class="org.springframework.beans.factory.annotation.      
  14.   
  15.         AutowiredAnnotationBeanPostProcessor"/>      
  16.   
  17.      <!-- 移除 boss Bean 的属性注入配置的信息 -->      
  18.   
  19.     <bean id="boss" class="com.baobaotao.Boss"/>      
  20.   
  21.        <bean id="office" class="com.baobaotao.Office">      
  22.   
  23.         <property name="officeNo" value="001"/>      
  24.   
  25.     </bean>      
  26.   
  27.     <bean id="car" class="com.baobaotao.Car" scope="singleton">      
  28.   
  29.         <property name="brand" value=" 红旗 CA72"/>      
  30.   
  31.         <property name="price" value="2000"/>      
  32.   
  33.     </bean>      
  34.   
  35. </beans>      
  36.   

这样，当 Spring 容器启动时，AutowiredAnnotationBeanPostProcessor 将扫描 Spring 容器中所有 Bean，当发现 Bean 中拥有 @Autowired 注释时就找到和其匹配（默认按类型匹配）的 Bean，并注入到对应的地方中去。  

按照上面的配置，Spring 将直接采用 Java 反射机制对 Boss 中的 car 和 office 这两个私有成员变量进行自动注入。所以对成员变量使用 @Autowired 后，您大可将它们的 setter 方法（setCar() 和 setOffice()）从 Boss 中删除。  

 当然，您也可以通过 @Autowired 对方法或构造函数进行标注，来看下面的代码：  

清单 8. 将 @Autowired 注释标注在 Setter 方法上  

   1. package com.baobaotao;      
   2.   
   3. public class Boss {      
   4.   
   5.     private Car car;      
   6.   
   7.     private Office office;      
   8.   
   9.      
  10.   
  11.      @Autowired     
  12.   
  13.     public void setCar(Car car) {      
  14.   
  15.         this.car = car;      
  16.   
  17.     }      
  18.   
  19.        
  20.   
  21.     @Autowired     
  22.   
  23.     public void setOffice(Office office) {      
  24.   
  25.         this.office = office;      
  26.   
  27.     }      
  28.   
  29.     …      
  30.   
  31. }      
  32.   

这时，@Autowired 将查找被标注的方法的入参类型的 Bean，并调用方法自动注入这些 Bean。而下面的使用方法则对构造函数进行标注：  

 清单 9. 将 @Autowired 注释标注在构造函数上         

   1. package com.baobaotao;      
   2.   
   3.   public class Boss {      
   4.   
   5.     private Car car;      
   6.   
   7.     private Office office;      
   8.   
   9.        
  10.   
  11.     @Autowired     
  12.   
  13.     public Boss(Car car ,Office office){      
  14.   
  15.         this.car = car;      
  16.   
  17.         this.office = office ;      
  18.   
  19.     }      
  20.   
  21.        
  22.   
  23.     …      
  24.   
  25. }      
  26.   

由于 Boss() 构造函数有两个入参，分别是 car 和 office，@Autowired 将分别寻找和它们类型匹配的 Bean，将它们作为 Boss(Car car ,Office office) 的入参来创建 Boss Bean。  

 

当候选 Bean 数目不为 1 时的应对方法  

在默认情况下使用 @Autowired 注释进行自动注入时，Spring 容器中匹配的候选 Bean 数目必须有且仅有一个。当找不到一个匹配的 Bean 时，Spring 容器将抛出 BeanCreationException 异常，并指出必须至少拥有一个匹配的 Bean。我们可以来做一个实验：  

清单 10. 候选 Bean 数目为 0 时  

   1. <?xml version="1.0" encoding="UTF-8" ?>      
   2.   
   3. <beans xmlns="http://www.springframework.org/schema/beans"     
   4.   
   5.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     
   6.   
   7.      xsi:schemaLocation="http://www.springframework.org/schema/beans       
   8.   
   9.  http://www.springframework.org/schema/beans/spring-beans-2.5.xsd ">      
  10.   
  11.        
  12.   
  13.     <bean class="org.springframework.beans.factory.annotation.      
  14.   
  15.         AutowiredAnnotationBeanPostProcessor"/>       
  16.   
  17.      
  18.   
  19.     <bean id="boss" class="com.baobaotao.Boss"/>      
  20.   
  21.      
  22.   
  23.     <!-- 将 office Bean 注释掉 -->      
  24.   
  25.     <!-- <bean id="office" class="com.baobaotao.Office">      
  26.   
  27.     <property name="officeNo" value="001"/>      
  28.   
  29.     </bean>-->      
  30.   
  31.      
  32.   
  33.     <bean id="car" class="com.baobaotao.Car" scope="singleton">      
  34.   
  35.         <property name="brand" value=" 红旗 CA72"/>      
  36.   
  37.         <property name="price" value="2000"/>      
  38.   
  39.     </bean>      
  40.   
  41. </beans>      
  42.   

由于 office Bean 被注释掉了，所以 Spring 容器中将没有类型为 Office 的 Bean 了，而 Boss 的 office 属性标注了 @Autowired，当启动 Spring 容器时，异常就产生了。  

 

当不能确定 Spring 容器中一定拥有某个类的 Bean 时，可以在需要自动注入该类 Bean 的地方可以使用 @Autowired(required = false)，这等于告诉 Spring：在找不到匹配 Bean 时也不报错。来看一下具体的例子：