使用 Spring 2.5 注解驱动的 IoC 功能(二)

 

清单 11. 使用 @Autowired(required = false)

package com.baobaotao;   import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Required;   public class Boss {       private Car car;     private Office office;       @Autowired     public void setCar(Car car) {         this.car = car;     }     @Autowired(required = false)     public void setOffice(Office office) {         this.office = office;     }     … }

 

当然，一般情况下，使用 @Autowired 的地方都是需要注入 Bean 的，使用了自动注入而又允许不注入的情况一般仅会在开发期或测试期碰到（如为了快速启动 Spring 容器，仅引入一些模块的 Spring 配置文件），所以 @Autowired(required = false) 会很少用到。

和找不到一个类型匹配 Bean 相反的一个错误是：如果 Spring 容器中拥有多个候选 Bean ，Spring 容器在启动时也会抛出 BeanCreationException 异常。来看下面的例子：

清单 12. 在 beans.xml 中配置两个 Office 类型的 Bean

… <bean id="office" class="com.baobaotao.Office">     <property name="officeNo" value="001"/> </bean> <bean id="office2" class="com.baobaotao.Office">     <property name="officeNo" value="001"/> </bean> …

 

我们在 Spring 容器中配置了两个类型为 Office 类型的 Bean ，当对 Boss 的 office 成员变量进行自动注入时，Spring 容器将无法确定到底要用哪一个 Bean ，因此异常发生了。

Spring 允许我们通过 @Qualifier 注释指定注入 Bean 的名称，这样歧义就消除了，可以通过下面的方法解决异常：

清单 13. 使用 @Qualifier 注释指定注入 Bean 的名称

@Autowired public void setOffice(@Qualifier("office")Office office) {     this.office = office; }

 

@Qualifier("office") 中的 office 是 Bean 的名称，所以 @Autowired 和 @Qualifier 结合使用时，自动注入的策略就从 byType 转变成 byName 了。 @Autowired 可以对成员变量、方法以及构造函数进行注释，而 @Qualifier 的标注对象是成员变量、方法入参、构造函数入参。正是由于注释对象的不同，所以 Spring 不将 @Autowired 和 @Qualifier 统一成一个注释类。下面是对成员变量和构造函数入参进行注释的代码：

对成员变量进行注释：

清单 14. 对成员变量使用 @Qualifier 注释

public class Boss {     @Autowired     private Car car;       @Autowired     @Qualifier("office")     private Office office;     … }

 

对构造函数入参进行注释：

清单 15. 对构造函数变量使用 @Qualifier 注释

public class Boss {      private Car car;     private Office office;       @Autowired     public Boss(Car car , @Qualifier("office")Office office){         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

package com.baobaotao;   import javax.annotation.Resource;   public class Boss {     // 自动注入类型为 Car 的 Bean     @Resource     private Car car;       // 自动注入 bean 名称为 office 的 Bean     @Resource(name = "office")     private Office office; }

 

一般情况下，我们无需使用类似于 @Resource(type=Car.class) 的注释方式，因为 Bean 的类型信息可以通过 Java 反射从代码中获取。

要让 JSR-250 的注释生效，除了在 Bean 类中标注这些注释外，还需要在 Spring 容器中注册一个负责处理这些注释的 BeanPostProcessor ：

<bean   class="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 的生命周期，笔者在《精通 Spring 2.x— 企业应用开发精解》第 3 章进行了详细的描述，有兴趣的读者可以查阅。

JSR-250 为初始化之后/ 销毁之前方法的指定定义了两个注释类，分别是 @PostConstruct 和 @PreDestroy ，这两个注释只能应用于方法上。标注了 @PostConstruct 注释的方法将在类实例化后调用，而标注了 @PreDestroy 的方法将在类销毁之前调用。

清单 17. 使用 @PostConstruct 和 @PreDestroy 注释的 Boss.java

package com.baobaotao;   import javax.annotation.Resource; import javax.annotation.PostConstruct; import javax.annotation.PreDestroy;   public class Boss {     @Resource     private Car car;       @Resource(name = "office")     private Office office;       @PostConstruct     public void postConstruct1(){         System.out.println("postConstruct1");     }       @PreDestroy     public void preDestroy1(){         System.out.println("preDestroy1");     }     … }

 

您只需要在方法前标注 @PostConstruct 或 @PreDestroy ，这些方法就会在 Bean 初始化后或销毁之前被 Spring 容器执行了。

我们知道，不管是通过实现 InitializingBean / DisposableBean 接口，还是通过 <bean> 元素的 init-method/destroy-method 属性进行配置，都只能为 Bean 指定一个初始化 / 销毁的方法。但是使用 @PostConstruct 和 @PreDestroy 注释却可以指定多个初始化 / 销毁方法，那些被标注 @PostConstruct 或 @PreDestroy 注释的方法都会在初始化 / 销毁时被执行。

通过以下的测试代码，您将可以看到 Bean 的初始化 / 销毁方法是如何被执行的：

清单 18. 测试类代码

package com.baobaotao;   import org.springframework.context.support.ClassPathXmlApplicationContext;   public class AnnoIoCTest {       public static void main(String[] args) {         String[] locations = {"beans.xml"};         ClassPathXmlApplicationContext ctx =             new ClassPathXmlApplicationContext(locations);         Boss boss = (Boss) ctx.getBean("boss");         System.out.println(boss);         ctx.destroy();// 关闭 Spring 容器，以触发 Bean 销毁方法的执行     } }

 

这时，您将看到标注了 @PostConstruct 的 postConstruct1() 方法将在 Spring 容器启动时，创建 Boss Bean 的时候被触发执行，而标注了 @PreDestroy 注释的 preDestroy1() 方法将在 Spring 容器关闭前销毁 Boss Bean 的时候被触发执行。

使用 <context:annotation-config/> 简化配置

Spring 2.1 添加了一个新的 context 的 Schema 命名空间，该命名空间对注释驱动、属性文件引入、加载期织入等功能提供了便捷的配置。我们知道注释本身是不会做任何事情的，它仅提供元数据信息。要使元数 据信息真正起作用，必须让负责处理这些元数据的处理器工作起来。

而我们前面所介绍的 AutowiredAnnotationBeanPostProcessor 和 CommonAnnotationBeanPostProcessor 就是处理这些注释元数据的处理器。但是直接在 Spring 配置文件中定义这些 Bean 显得比较笨拙。Spring 为我们提供了一种方便的注册这些 BeanPostProcessor 的方式，这就是 <context:annotation-config/> 。请看下面的配置：