Spring 5.x 源码之旅八十三Qualifier注解一

@Qualifier注解

说说Qualifier注解，这个注解可以用在注解上，是@Inherited注解的，可被继承的，Target里有ElementType.ANNOTATION_TYPE，这个可以做限定用，也就是一个条件规定。

@Target({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.TYPE, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Qualifier {

	String value() default "";

}

例子-程序员选朋友

我们来做给程序员选朋友的例子，有些人程序员希望朋友都是男的好，有些希望都是女，有些人希望男女都可以，所以我们要满足他们的要求。

Girl注解

表示是一个女的。用Qualifier限定了下。

@Target({ ElementType.FIELD ,ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Qualifier
public @interface Girl {
}

Boy注解

表示是个男的。用Qualifier限定了下。

@Target({ ElementType.FIELD  ,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Qualifier
public @interface Boy {
}

Friend朋友

public class Friend {
    private String name;

    public Friend(String name){
        this.name=name;
    }

    @Override
    public String toString() {
        return "Friend{" +
                "name='" + name + '\'' +
                '}';
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

Programmer程序员

有个朋友集合的属性，需要注入。

public class Programmer {
    @Autowired(required = false)
    private List<Friend> friends;


    public List<Friend> getFriends() {
        return friends;
    }

    public void setFriends(List<Friend> friends) {
        this.friends = friends;
    }


}

配置类

创建了两个朋友，一个男的，一个女的，还有一个程序员。

@Configuration
public class QualifierConfig {
    @Bean
    public Friend friend1(){
        return new Friend("丽丽-女");
    }
    @Bean
    public Friend friend2(){
        return new Friend("杰克-男");
    }

    @Bean
    public Programmer programmer(){
        return new Programmer();
    }
}

测试类

获取程序员，打印所有朋友。

public class Test {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext configApplicationContext=new AnnotationConfigApplicationContext();
        configApplicationContext.register(QualifierConfig.class);
        configApplicationContext.refresh();
        Programmer programmer = configApplicationContext.getBean(Programmer.class);
        System.out.println(programmer.getFriends());
    }
}

结果全获得到了，这个符合第三种程序员：

全女的/全男的

如果是我，我要全女的，那怎么办呢，我该怎么跟spring说让他把女的都给我呢，这个时候就可以用到Qualifier注解了，上面不是还有定义男女两个注解嘛，我们用用看。
首先给女的朋友的方法加上注解：

然后给程序员类的朋友集合也加上：

于是我们看到结果只有女的了，好像实现了要求：

此时如果我们把女的朋友注解给去掉，会怎么样，我猜应该是没朋友了，结果却是：

幸亏还设置了required = false，不然就报异常啦，意思说找不到Girl注解候选bean：

Exception in thread "main" org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'programmer': Unsatisfied dependency expressed through field 'friends'; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'java.util.List<com.ww.qualifier.test.Friend>' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@com.ww.qualifier.test.Girl(), @org.springframework.beans.factory.annotation.Autowired(required=true)}

这个就说明了，如果用了Qualifier注解来修饰的注解，可以进行条件筛选。全男的结果也是类似的。

男女都要

现在如果男女都要，但是已经用@Boy修饰了，那我要怎么办呢。


当然我可以再加一个方法，把女的给注入进来，结果一样的：

但是还有一种方法，用ObjectProvider，让容器给你注入你要的东西：

好了大致例子就是这样，只是想说明@Qualifier还可以做条件限定用，具体原理下篇说吧。

好了，今天就到这里了，希望对学习理解有帮助，大神看见勿喷，仅为自己的学习理解，能力有限，请多包涵。