Spring(15)——基于注解的配置(二)

简介: 15.4 @Qualifier 15.4.1 简介 @Qualifier通常是配合@Autowired的一起使用的。我们知道使用@Autowired进行注入时默认是按照类型进行注入的。

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所写)

目录
相关文章
|
1月前
|
XML Java 数据格式
SpringBoot入门(8) - 开发中还有哪些常用注解
SpringBoot入门(8) - 开发中还有哪些常用注解
50 0
|
2月前
|
Java Spring
在使用Spring的`@Value`注解注入属性值时,有一些特殊字符需要注意
【10月更文挑战第9天】在使用Spring的`@Value`注解注入属性值时,需注意一些特殊字符的正确处理方法,包括空格、引号、反斜杠、新行、制表符、逗号、大括号、$、百分号及其他特殊字符。通过适当包裹或转义,确保这些字符能被正确解析和注入。
129 3
|
1月前
|
Java 开发者 微服务
手写模拟Spring Boot自动配置功能
【11月更文挑战第19天】随着微服务架构的兴起,Spring Boot作为一种快速开发框架,因其简化了Spring应用的初始搭建和开发过程,受到了广大开发者的青睐。自动配置作为Spring Boot的核心特性之一,大大减少了手动配置的工作量,提高了开发效率。
50 0
|
2月前
|
Java API 数据库
Spring Boot框架因其简洁的配置、快速的启动特性及丰富的功能集而备受开发者青睐
本文通过在线图书管理系统案例,详细介绍如何使用Spring Boot构建RESTful API。从项目基础环境搭建、实体类与数据访问层定义,到业务逻辑实现和控制器编写,逐步展示了Spring Boot的简洁配置和强大功能。最后,通过Postman测试API,并介绍了如何添加安全性和异常处理,确保API的稳定性和安全性。
43 0
|
3天前
|
NoSQL Java Redis
Spring Boot 自动配置机制:从原理到自定义
Spring Boot 的自动配置机制通过 `spring.factories` 文件和 `@EnableAutoConfiguration` 注解,根据类路径中的依赖和条件注解自动配置所需的 Bean,大大简化了开发过程。本文深入探讨了自动配置的原理、条件化配置、自定义自动配置以及实际应用案例,帮助开发者更好地理解和利用这一强大特性。
38 14
|
2天前
|
XML Java 数据格式
🌱 深入Spring的心脏:Bean配置的艺术与实践 🌟
本文深入探讨了Spring框架中Bean配置的奥秘,从基本概念到XML配置文件的使用,再到静态工厂方式实例化Bean的详细步骤,通过实际代码示例帮助读者更好地理解和应用Spring的Bean配置。希望对你的Spring开发之旅有所助益。
27 3
|
2月前
|
Java API Spring
在 Spring 配置文件中配置 Filter 的步骤
【10月更文挑战第21天】在 Spring 配置文件中配置 Filter 是实现请求过滤的重要手段。通过合理的配置,可以灵活地对请求进行处理,满足各种应用需求。还可以根据具体的项目要求和实际情况,进一步深入研究和优化 Filter 的配置,以提高应用的性能和安全性。
|
22天前
|
前端开发 Java Spring
Spring MVC核心:深入理解@RequestMapping注解
在Spring MVC框架中,`@RequestMapping`注解是实现请求映射的核心,它将HTTP请求映射到控制器的处理方法上。本文将深入探讨`@RequestMapping`注解的各个方面,包括其注解的使用方法、如何与Spring MVC的其他组件协同工作,以及在实际开发中的应用案例。
36 4
|
1月前
|
XML JSON Java
SpringBoot必须掌握的常用注解!
SpringBoot必须掌握的常用注解!
61 4
SpringBoot必须掌握的常用注解!
|
22天前
|
前端开发 Java 开发者
Spring MVC中的请求映射:@RequestMapping注解深度解析
在Spring MVC框架中,`@RequestMapping`注解是实现请求映射的关键,它将HTTP请求映射到相应的处理器方法上。本文将深入探讨`@RequestMapping`注解的工作原理、使用方法以及最佳实践,为开发者提供一份详尽的技术干货。
65 2
下一篇
DataWorks