spring实战四之Bean的自动装配(注解方式)
使用注解装配：
从spring2.5开始,Spring启用了使用注解自动装配Bean的属性,使用注解方式自动装配与在XML中使用 autowire 属性自动装配并没有太大区别，但是使用注解方式允许更细粒度的自动装配。
Spring容器默认禁用注解装配。所以,在使用基于注解的自动装配前,需要在Spring配置中启用它,最简单的启用方式是使用spring的context命名空间配置中的 <context:annotation-config>元素,如下所示:
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="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 http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd"> <context:annotation-config /> <!-- bean declarations go here --> </beans>
<context:annotation-config>元素告诉Spring我们打算使用基于注解的自动装配,一旦配置完成,我们就可以对代码添加注解,标识Spring应该为属性,方法和构造器进行自动装配。
Spring3支持几种不同的用于自动装配的注解:
第一种:Spring自带的@Atutowired注解;
第二种:JSR-330的@Inject注解;
第三种:JSR-250的@Resource注解。
1.使用@Atutowired注解
使用@Atutowired注解标注setter方法:
@Autowired public void setInstrument(Instrument instrument) { this.instrument = instrument; }
当Spring发现对setInstrument()方法使用了@Atutowired注解时,Spring会尝试对该方法进行byType自动装配。
@Atutowired注解有趣的地方在于,不仅可以使用它标注setter方法,还可以标注需要自动装配的Bean引用的任意方法:
@Atutowired注解标注普通方法:
@Autowired public void heresYourInstrument(Instrument instrument) { this.instrument = instrument; }
@Atutowired注解标注构造器:
@Autowired public Instrumentalist(Instrument instrument) { this.instrument = instrument; }
当对构造器进行标注时,@Atutowired注解当创建Bean时,即使在Spring XML中没有使用 <constructor-arg>元素配置bean,该构造器也需要进行自动装配。
@Atutowired注解标直接标注属性,并删除setter方法:
@Autowired private Instrument instrument;
@Atutowired不会受限于private关键字。即使instrument属性是私有的实例变量。
@Atutowired的受限在于如果没有找到匹配的bean,或者存在多个匹配的Bean,庆幸的是这两种场景都有相应的解决办法。
解决没有找到匹配的bean的方式:可选的自动装配
通过设置@Atutowired的required属性为false来配置自动装配是可选的。如下:
@Autowired(required=false) private Instrument instrument;
在上面代码中,Spring尝试装配instrument属性,但是如果没有找到与之匹配的类型为Instrument的Bean,应用就不会发生任何问题,而instrument属性的值会设置为null。
需要注意的是required虽然可以用于@Atutowired注解所使用的任意的地方,但是当使用构造器装配时,只有一个构造器可以将@Atutowired的required属性设置为true。其他使用@Atutowired注解所标注的构造器只能将required属性设置为false,此外,当使用@Atutowired标注多个构造器时,Spring就会从所有满足装配条件的构造器中选择入参最多的那个构造器。
解决在多个匹配的Bean的方式:限定歧义性的依赖
为了帮助@Atutowired鉴别出哪一个bean才是我们所需要的,可以配合使用Spring的 @Qualifier注解,如下：
@Autowired @Qualifier("guitar") private Instrument instrument;
在上面的代码中,即使有其他的bean也可以装配到instrument属性中,但我们可以使用@Qualifier来明确指定名为guitar的Bean。
@Qualifier注解真正的缩小了自动装配挑选候选Bean的范围。还可以通过在Bean上直接使用qualifier来缩小范围,如下所示:
<bean class="com.springinaction.springidol.Guitar"> <qualifier value="stringed" /> </bean>
除了可以在XML中指定qualifier,还可以使用@Qualifier注解来标注Guitar吉他类,如下所示：
@Qualifier("stringed")
public class Guitar implements Instrument {
...
}
创建自定义限定器注解：
为了创建一个自定义的限定器注解器,所需要做的仅仅是定义一个注解,并使用@Qualifier注解作为它的元注解。例如,当我们创建自己的@StringedInstrument注解来充当限定器,如下所示自定义的限定器注解:
package com.springinaction.springidol.qualifiers; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; import org.springframework.beans.factory.annotation.Qualifier; @Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Qualifier public @interface StringedInstrument { }
通过自定义的@StringedInstrument注解,我们现在可以用它来代替@Qualifier来标注 Guitar :
@StringedInstrument public class Guitar implements Instrument { ... }
现在,我们也可以使用@StringedInstrument对自动装配的instrument属性进行限定:
@Autowired @StringedInstrument private Instrument instrument;
当Spring尝试装配instrument属性时,Spring会把所有可选择的乐器Bean缩小到只有被@StringedInstrument注解所标注的bean。如果只有一个乐器Bean使用@StringedInstrument注解,那该Bean将会被装配到instrument属性中。
如果使用@StringedInstrument注解的乐器Bean有多个,我们还需要进一步限定来缩小范围。例如,假设除了Guitar Bean,我们还有一个 HammeredDulcimer bean 也需要@StringedInstrument注解,所以为了进一步限定为Guitar Bean,我们可以定义另一种限定器注解@Strummed:
@Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Qualifier public @interface Strummed { }
给Guitar增加标注:
@StringedInstrument @Strummed public class Guitar implements Instrument { ... }
那么现在可以使用@Strummed注解标注instrument属性把选择范围缩小,如下所示:
@Autowired @StringedInstrument @Strummed private Instrument instrument;
现在Guitar类是唯一使用@Strummed and @StringedInstru-ment的类,它将是唯一可以注入到instrument属性的bean。如果还需要细分的话,那么需要做进一步的限定。
使用Spring的@Atutowired可以减少Spring XML的配置,但是使用它的类会引入对Spring的特定依赖,即使这种依赖仅仅只是一个注解。幸运的是,Spring还提供了标准的java注解来替代@Atutowired,那就是@Inject注解。
2. JSR-330的@Inject注解
3. JSR-250的@Resource注解
