Spring实战之bean重复、指定bean的名字、消除bean的歧义性

在 Spring实战之Bean的主要装配机制之一-通过Java代码显示装配bean和 Spring实战之Bean的主要装配机制之一-组件扫描、自动装配bean中，我们了解到bena的转配，但是这是在容器中只有一个同类bean的情况下完成的。如果有同类型实现类的bean呢？这种歧义性会阻碍Spring自动装配属性、构造器参数或方法参数。

自动装配的歧义性示例

解释自动装配的歧义性，如下：

public interface Dessert {
}

@Component
public class Cake implements Dessert{
}

@Component
public class Cookies implements Dessert{
}

@Component
public class IceCream implements Dessert{
}

@Configuration
@ComponentScan
public class TestConfig {
    private Dessert dessert;

    @Autowired
    public void setDessert(Dessert dessert){
        this.dessert = dessert;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

本例中，Dessert是要一个接口，并且有三个实现类：Cake、Cookies、IceCream。因这三个实现类都使用了@Component注解，在主键扫描的时候，能够发现它们并将它们创建为Sping上下文里的bean，然后Spring在自动装配setDessert()中的Dessert参数时，由于没有唯一、无歧义的可选值，Spring会抛出异常：

Parameter 0 of method setDessert in com.example.springboot.config.TestConfig required a single bean, but 3 were found:
	- cake: defined in file [Cake.class]
	- cookies: defined in file [Cookies.class]
	- iceCream: defined in file [IceCream.class]
1
2
3
4

怎么解决如上歧义性问题呢？Spring提供的了众多解决方案，接下来我们使用设置首选bean（primary）或者使用限定符（qualifier）。

解决方案

@Primary标示首选bean

当你都喜欢上述Cake、Cookies、IceCream这三个甜点时，选择一个你最喜欢的那个，加上@Primary注解来标示你最喜欢它。在声明bean的时候，通过@Primary注解来设置为首选，告诉Spring，当自动装配遇到歧义性的时候，Spring将会使用首选的bean。

@Primary注解与@Component注解配合使用

代码如下：

@Component
@Primary
public class IceCream implements Dessert {
}
1
2
3
4

@Primary与JavaConfig配合使用

代码如下：

    @Bean
    @Primary
    public Dessert iceCream(){
        return new IceCream();
    }
1
2
3
4
5

综上，在多个bean中选取一个bean成为首选bean。可是如果有多个bean都被加上了@Primary注解，在有多个首选bean的设置时，Spring也会无法选择装配哪个bean了！此时，可以为了解决这种歧义性，可以使用限定符（qualifier）。

@Qualifier限定符

@Qualifier注解是使用限定符的主要方式，它可以与@Autowired和@Inject协同使用，在注入的时候指定想要注入进去的那个bean。
例如，我们要确保将IceCream注入到setDessert()之中，代码如下：

    @Autowired
    @Qualifier("iceCream")
    public void setDessert(Dessert dessert){
        this.dessert = dessert;
    }
1
2
3
4
5

@Qualifier(“iceCream”)指向的bean是组件扫描时所创建的bean，即IceCream的实例。
但是需要注意的是，限定符中指定的bean是与注入的bean的名称紧耦合的，对类名称的修改，都会导致限定符失效!

创建自定义限定符

与组件扫描搭配使用

代码如下：

@Component
@Qualifier("cold")
public class IceCream implements Dessert {
}
1
2
3
4

限定符cold分配给了IceCream bean，没有耦合类名，此时可以随意重构IceCream的类名，而不必担心破会自动装配。在注入时，使用cold限定符就可以了：

    @Autowired
    @Qualifier("cold")
    public void setDessert(Dessert dessert){
        this.dessert = dessert;
    }
1
2
3
4
5

与JavaConfig搭配使用

    @Bean
    @Qualifier("cold")
    public Dessert iceCream(){
        return new IceCream();
    }
1
2
3
4
5

自定义注解实现限定符效果

自定义一个注解来标示特定bean。

@Target({ElementType.CONSTRUCTOR, ElementType.FIELD,
        ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Qualifier
public @interface Cold {
}
1
2
3
4
5
6

与组件扫描搭配使用

实现类上加上自定义注解：

@Component
@Cold
public class IceCream implements Dessert {
}
1
2
3
4

注入时，加上自定义注解

    @Autowired
    @Cold
    public void setDessert(Dessert dessert){
        this.dessert = dessert;
    }
1
2
3
4
5

与JavaConfig搭配使用

	@Bean
    @Cold//bean声明cold限定符
    public Dessert iceCream(){
        return new IceCream();
    }

    @Autowired
    @Cold//注入cold限定符指定的bean
    public void setDessert(Dessert dessert){
        this.dessert = dessert;
    }
1
2
3
4
5
6
7
8
9
10
11