15.4 @Qualifier
15.4.1 简介
@Qualifier通常是配合@Autowired的一起使用的。我们知道使用@Autowired进行注入时默认是按照类型进行注入的。打个比方当我们使用@Autowired的定义beanA需要自动注入一个类型为BeanB的bean时,如果在bean容器中存在多个类型为BeanB的bean,那么Spring就会抛出异常。这个时候我们就可以使用@Qualifier来指定需要进行注入的到底是哪个BeanB类型的bean,具体bean是通过@Qualifier注解的value属性来进行指定的。以下示例表示我们通过@Qualifier指定我们需要注入的是beanName为world的那个World,这个时候需要两者都满足的bean才能被注入,即要求被注入的bean既是World类型的,又必须对应的beanName为“world”。
public class Hello {
@Qualifier("world")
@Autowired
private World world;
}
对于通过构造方法或普通方法注入的形式,我们可以将@Qualifier标注在对应的方法参数上,以确定到底需要注入哪个对象。如下我们在构造方法参数world上使用@Qualifier标注了我们需要进行注入的是beanName为world1的那个World类型的bean。
public class Hello {
private World world;
private BeanA beanA;
@Autowired
public Hello(@Qualifier("world1") World world, BeanA beanA) {
this.world = world;
this.beanA = beanA;
}
}
@Qualifier注解的value属性值默认对应的是对应bean定义的beanName,而实际上@Qualifier寻找的是对应的qualifier,只是在没有指定对应的qualifier时默认会取beanName。对应的qualifier可以在进行bean定义时通过qualifier元素进行定义。如下示例我们在定义bean定义时指定了对应的qualifier为abc,那么之后我们在通过@Qualifier指定需要注入该bean时就只能使用@Qualifier(“abc”),而不能使用@Qualifier(“world1”)。
<bean id="world1" class="com.app.World">
<qualifier value="abc"/>
</bean>
qualifier元素除了可以通过value属性指定当前元素对应的qualifier之外,还需要指定一个type属性,该属性的默认值是org.springframework.beans.factory.annotation.Qualifier。只有这两者的结合才能对应一个qualifier。如在上述示例中当我们在字段上使用@Qualifier(“abc”)进行标注时,实际上Spring将会去寻找value为“abc”,type为org.springframework.beans.factory.annotation.Qualifier的qualifier对应的对应类型的bean进行注入,如果不存在对应类型的qualifier,则取beanName为“abc”的那个bean进行注入。此外还支持给一个bean定义多个qualifier,即定义多个qualifier元素。
在使用qualifier元素定义一个bean的qualifier时允许有重复的qualifier存在,即不要求每个元素的qualifier在当前bean容器内是唯一的。
15.4.2 自定义@Qualifier
@Qualifier还可以标注在其它注解上,这样就形成了一个自定义的Qualifier。在使用@Autowired的时候我们也可以使用自定义的Qualifier来标识我们需要进行注入的具体是哪一个bean。我们先来自定义一个Qualifier,叫MyQualifier。
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD})
@Qualifier
public @interface MyQualifier {
public String value() default "";
}
然后就可以在我们的代码中使用@MyQualifier进行标识需要注入的bean了。
public class Hello {
@MyQualifier("world1")
@Autowired
private World world;
}
根据前面的介绍我们知道这里使用@MyQualifier(“world1”)进行标注后,Spring将寻找type为com.app.MyQualifier,value为world1的Qualifier对应com.app.World类型的bean进行注入。当没有找到时就会取beanName为world1的World类型的bean进行注入。所以我们的World类型的bean可以如下定义:
<bean id="world" class="com.app.World" p:id="10">
<qualifier type="com.app.MyQualifier" value="world1"/>
</bean>
也可以不指定qualifier,然后指定其beanName为world1,这个时候也可以有其它类型的Qualifier定义,但是切不可有MyQualifier类型的Qualifier定义。如下这种定义是可以的。
<bean id="world1" class="com.app.World" p:id="10">
<qualifier value="abc"/>
</bean>
我们也可以在使用@MyQualifier进行注入时不定义对应的参数,如:
public class Hello {
@MyQualifier
@Autowired
private World world;
}
那么对应的在定义需要注入的bean时,也不能指定对应的参数,但是需要定义qualifier元素,并指定对应的type。
<bean id="world0" class="com.app.World" p:id="10">
<qualifier type="com.app.MyQualifier"/>
</bean>
在自定义Qualifier的时候也可以给我们自定义的Qualifier加上其它额外的属性,如在下面示例中我们给MyQualifier多加了一个order属性的定义。
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD})
@Qualifier
public @interface MyQualifier {
public String value() default "";
public int order() default 0;
}
那么在使用MyQualifier进行标注的时候我们就可以使用新增加的属性进行定义了。
public class Hello {
@MyQualifier(order=1, value="world1")
@Autowired
private World world;
}
对应的我们在定义bean时也需要通过qualifier定义对应的属性,这个时候对应的属性是通过qualifier的子元素attribute进行定义的。
<bean class="com.app.World" p:id="10">
<qualifier type="com.app.MyQualifier" value="world1">
<attribute key="order" value="1"/>
</qualifier>
</bean>
对于使用注解进行扫描bean的情况其实我们还可以直接在对应的bean上使用@Qualifier进行标注来指定当前bean对应的qualifier。关于使用注解扫描bean并添加到bean容器中的内容将在后续文章中进行讲解。这里我们先来看一个对应的示例。
@Component
@Qualifier("abc")
public class World {
}
15.5 @Resource
@Resource是JSR250标准中的一个注解,Spring也对其提供了支持,我们可以使用@Resource标注在我们需要进行自动注入的field或set方法上,也可以是普通的非set方法上,但是对应方法只允许接收一个参数。其不能像@Autowired那样定义在构造方法上,也不允许通过一个方法同时注入多个bean对象。
public class Hello {
@Resource
private World world;
private BeanA beanA;
/**
* 通过普通方法进行注入,对应方法只允许拥有一个参数
* @param beanA
*/
@Resource
public void otherMethod(BeanA beanA) {
this.beanA = beanA;
}
}
使用@Resource时默认是通过按照beanName来进行注入的。@Resource拥有一个name属性,我们可以通过它来指定我们需要注入的bean的beanName。当没有指定时默认将使用field的名称,或set方法去掉set前缀后的名称。当对应beanName的bean在bean容器中不存在时,Spring将尝试按照需要注入的类型寻找对应的bean给@Resource标注的field或方法进行注入,但此时如果对应类型的bean拥有多个时也一样会报异常。
public class Hello {
/**
* 优先注入beanName为world1的bean,不存在时才注入一个类型为World的bean。
*/
@Resource(name="world1")
private World world;
}
对于其它如数组、集合类型的注入,以及ApplicationContext等的注入@Resource也是一样支持的。
public class Hello {
@Resource
private World[] worldArray;
@Resource
private List<World> worldList;
@Resource
private Set<World> worldSet;
@Resource
private Map<String, World> worldMap;
@Resource
private ApplicationContext applicationContext;
}
因为元素类型的问题,我们不能直接通过@Autowired加@Qualifier的形式注入一个集合等类型的bean,但是这种情况我们可以通过@Resource来解决。如我们拥有如下这样一个ArrayList类型的bean定义。
<bean id="strList" class="java.util.ArrayList">
<constructor-arg>
<list>
<value>abc</value>
<value>bcd</value>
<value>cde</value>
</list>
</constructor-arg>
</bean>
如果现在我们需要在我们的程序中自动注入这么一个bean,那么通过@Autowired加@Qualifier的形式是不行的,但是我们只能通过@Resource进行注入。
public class Hello {
@Resource(name="strList")
private List<String> strList;
}
其实,类似的支持自动注入的注解还有JSR330标准的@Inject注解,这个将在后续单独讲解。
15.6 @PostConstruct和@PreDestroy
@PostConstruct和@PreDestroy注解在之前讲解bean的生命周期回调方法的时候有讲解过。其实把它们放在这里来讲可能并不是很合适,因为这两个注解不需要我们在Spring的配置文件中配置启用Spring对注解的支持就可以使用,即不需要配置<context:annotation-config/>
就可以用的注解。但既然本文是讲解Spring对使用注解进行配置的支持,那就还是顺便讲讲。使用@PostConstruct进行标注的方法会被当做是初始化方法,其会在对应bean实例化之后由Spring进行调用。使用@PreDestroy进行标注的方法会被当做是释放资源的方法,其会在bean容器销毁前由Spring进行调用。使用@PostConstruct和@PreDestroy进行标注的方法都是不能带参数。更多信息请参考之前介绍bean生命周期回调的那篇文章。
public class Hello {
@PostConstruct
public void doInit() {
System.out.println("init****************");
}
@PreDestroy
public void doDestroy() {
System.out.println("destroy***************");
}
}
(注:本文是基于Spring4.1.0所写)