Spring 中的 `@Qualifier` 注解有什么作用？

推荐答案

@Qualifier 注解在 Spring 中用于解决自动装配时的歧义性问题。当 Spring 容器中存在多个相同类型的 Bean 时，@Qualifier 可以帮助指定具体要注入哪一个 Bean。

本题详细解读

1. @Qualifier 的作用

在 Spring 中，@Autowired 注解用于自动装配 Bean。然而，当容器中存在多个相同类型的 Bean 时，Spring 无法确定应该注入哪一个 Bean，这时就会抛出 NoUniqueBeanDefinitionException 异常。@Qualifier 注解的作用就是在这种情况下，指定具体要注入的 Bean。

2. 使用场景

• 多个同类型 Bean：当 Spring 容器中存在多个相同类型的 Bean 时，可以使用 @Qualifier 来指定具体的 Bean。
• 自定义 Bean 名称：默认情况下，Spring 使用 Bean 的类名作为其名称（首字母小写）。可以通过 @Qualifier 指定自定义的 Bean 名称。

3. 使用方法

@Qualifier 注解可以与 @Autowired 一起使用，也可以单独使用在方法参数上。

示例 1：与 @Autowired 一起使用

// www.javascriptcn.com code example
@Service
public class MyService {
    private final MyRepository repository;

    @Autowired
    public MyService(@Qualifier("myRepositoryImpl") MyRepository repository) {
        this.repository = repository;
    }
}

示例 2：单独使用在方法参数上

// www.javascriptcn.com code example
@Service
public class MyService {
    private MyRepository repository;

    @Autowired
    public void setRepository(@Qualifier("myRepositoryImpl") MyRepository repository) {
        this.repository = repository;
    }
}

4. 与 @Primary 的区别

• @Primary 注解用于指定当存在多个相同类型的 Bean 时，优先使用被标记为 @Primary 的 Bean。
• @Qualifier 则是显式指定要使用的 Bean，优先级高于 @Primary。

5. 注意事项

• @Qualifier 注解的值必须与 Bean 的名称一致，否则会抛出 NoSuchBeanDefinitionException 异常。
• 如果 @Qualifier 注解的值未指定，Spring 会尝试根据字段或参数名称来匹配 Bean。