悟纤:师傅,这一节,看着比较简单呢?
师傅:嗯嗯,这一节就是和大家分享一些一些基础的知识,基础功不打扎实一点的话,源码和高级一些的功能在实现的时候就没有思路了。
师傅:扎实基本功,敲码更轻松。
悟纤:师傅说的是,我一定会打好基础的。
师傅:孺子可教也。
悟纤:那咱们赶紧开始吧~ 我已经按耐不住想体验学习的快乐了!
导读
在前面小节中,在实现Ribbon的负载均衡提到一个很重要的注解@Qualifier,可能还有很多的小伙伴对于这个注解,还有点懵逼的状态,这一节的话就讲讲@Qualifier为什么需要存在,以及常见的几种方法。
扩展点实战系列:
01.《观察者模式实际应用场景「扩展点实战系列」》
02.《服务信息上报+记录请求信息+监听项目运行状态还能这么玩 「扩展点实战系列」》
03.《配置类信息赋值为Java静态变量「扩展点实战系列》」》
04. 《3种方案扩展RestTemplate让其具备负载均衡(超级详细)「扩展点实战系列」》
05.《一个注解@LoadBalanced就能让RestTemplate拥有负载均衡的能力?「扩展点实战系列」》
06.《Spring注解@Qualifier的详细用法你知道几种「扩展点实战系列」》
07.「待拟定」《利用Spring扩展点模拟FeignClient实现远程调用(干货满满)「扩展点实战系列」》
一、为什么需要@Qualifier
有句话说:知其然之所以然,知道它是这样的,更知道它为什么是这样的。
在使用之前呢,先要了解一下存在的价值和意义。
1.1 装配Bean的两种方式
这个还需要从转配Bean说起。
@Autowired与@Resource都可以用来装配Bean。
区别:
(1)@Autowired:Spring注解,默认按类型装配,默认情况下必须要求依赖对象必须存在。如果 Spring 没有其他提示,将会按照需要注入的变量名称来寻找合适的 bean。
(2)@Resoure:JavaEE注解,默认按照名称进行装配,可以通过name属性指定名称,如果没有指定name属性,当注解写在字段上时,默认取字段名进行查找注入,如果写在setter方法上默认取属性名进行装配。当找不到与名称匹配的bean时才按照类型进行装配。但是需要注意的是,如果name属性一旦指定,就只会按照名称进行装配。
从这个区别可以看出@Resouce还是非常强大的,各种情况都满足了。
那么对于@Autowired呢?作为Spring框架提供的注解,肯定也不至于不考虑常规的一些情况吧。
1.2 @Autowired
对于@Resouce基本满足了大部分装配的场景,而对于@Autowired的话,它自己就不能单干了,看如下这种场景:
这里声明了两个相同类型的bean,那么如果使用@Autowired进行装配的话:
此时就会报错:
required a single bean, but 2 were found
在上面@Autowired也是按照名称去寻找的,如果这里的名称修改为curDate的话:
此时装配进去一个是curDate(),可以看到打印的信息:
[Mon Sep 05 12:14:33 CST 2022]
1.3 @Qulifier
如果我们希望转配的是nextYear()的话,就需要使用@Qulifier(当然你把变量名称修改为nextYear也是一种方式),看下这个单词的意思:
合格者,也就是哪个Spring Bean是合格的,满足要求的。
再看另外一个解释:
限定符,这个可能在Spring描述的会更贴切,限定了只能是指定的名称的Spring Bean。
所以我们只需要在添加注解@Qualifier进行名称:
结果:
[Tue Sep 05 12:14:33 CST 2023]
当然这只是@Qualifier存在的一种情况,那么它还具备什么神奇的功效呢?
二、@Qualifier的各种用法
接下来就带着大家看看@Qualifier的各种奇淫技巧。
2.1 常规用法限定注入类
通过前面的示例已经了解了可以使用@Qualifier限定类的注入:
说明:用来限定注入的Bean的名称。
2.2 @Qualifier筛选注入对象
当有多个实例的时候,Spring的@Autowired支持注入到一个集合中:
打印结果:
[Mon Sep 05 12:14:33 CST 2022, Tue Sep 05 12:14:33 CST 2023]
接下来使用@Qulifier进行限定一下:
在使用的时候:
结果就只有一个数据了:
[Tue Sep 05 12:13:49 CST 2023]
说明:@Qualifier起到了一个筛选的作用只有Bean上加有@Qualifier注解的Bean才会被收集注入。
2.3自定义注解筛选注入对象
就如同ribbon的@LoadBalanced可以自定义注解类来限定注入Bean:
/**
* 自定义注解
*
* @author 悟纤「公众号SpringBoot」
* @date 2022-09-05
* @slogan 大道至简 悟在天成
*/
@Target({ElementType.FIELD,ElementType.PARAMETER,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Qualifier
public @interface QualifierDate {
}
在自定义注解上的注解称为元注解,具体都代表什么意思?如果你还不是很懂的话,可以关注公众号「SpringBoot」回复关键词[404],查看文章
《Spring Boot @ConditionalOnClass上的注解你了解多少-java元注解和注解 - 第404篇》
在注入Bean的时候就以使用QualifierDate注解:
/** 当前日期,应该是2022年*/
@Bean
public Date curDate(){
return new Date();
}
/**明年日期 ,应该是2023年*/
@Bean
@QualifierDate
public Date nextYear(){
Calendar ca = Calendar.getInstance();//得到一个Calendar的实例
ca.setTime(new Date()); //设置时间为当前时间
ca.add(Calendar.YEAR, +1); //年份+1
return ca.getTime();
}
那么在注入到集合的时候,就可以使用@QualifierDate来限定:
@Autowired
@QualifierDate
List<Date> dates = Collections.emptyList();
执行的结果和2.2的结果是一样。
总结
最后对于本文简单做个总结:
(1)@Qualifier是一个限定符号,用来限定注入类以及筛选注入对象。
(2)当一个项目中存在多个同类型的Bea你的时候,避免报required a single bean, but 2 were found的方案有如下几种:
①方案1:通过名称来自动注入,定义的变量名称和注入的bean的名称是一样的。
②方案2:使用@Qualifier限定符号,在类上添加@Qualifier注解限定注入类。
③方案3:使用@Primary定义首选项,只需要在注入Bean上添加@Primary定义首选项,那么该Bean就会作为首选进行注入。
转自:https://zhuanlan.zhihu.com/p/566046300
标签:Qualifier,Autowired,Spring,Bean,注解,注入 From: https://www.cnblogs.com/tiancai/p/16708695.html