@Qualifier注解有什么作用

tim-qtp2025年3月7日...大约 1 分钟Spring框架

在Spring中,如果一个接口有多个实现类,或者一个类有多个实例被定义为Bean,Spring在进行依赖注入时可能会不知道该注入哪一个。此时,@Qualifier注解可以明确指定注入的Bean的名称,从而解决这种歧义。

假设我们有一个MessageService接口,它有两个实现类:EmailServiceSmsService

public interface MessageService {
    void sendMessage(String message);
}

@Component("emailService")
public class EmailService implements MessageService {
    @Override
    public void sendMessage(String message) {
        System.out.println("Sending email: " + message);
    }
}

@Component("smsService")
public class SmsService implements MessageService {
    @Override
    public void sendMessage(String message) {
        System.out.println("Sending SMS: " + message);
    }
}

在上面的代码中,EmailServiceSmsService都被定义为Bean,并且分别指定了Bean的名称(emailServicesmsService)。

现在,假设我们有一个MessageClient类,它需要注入一个MessageService类型的Bean。如果没有@Qualifier注解,Spring会报错,因为它不知道应该注入EmailService还是SmsService

@Component
public class MessageClient {
    // 使用@Qualifier注解明确指定注入的Bean名称
    @Autowired
    @Qualifier("emailService")
    private MessageService messageService;

    public void sendMessage(String message) {
        messageService.sendMessage(message);
    }
}

在上面的代码中,@Qualifier("emailService")明确指定了注入的Bean是名称为emailServiceMessageService

测试代码

public class Main {
    public static void main(String[] args) {
        ApplicationContext context = new AnnotationConfigApplicationContext(MessageClient.class);
        MessageClient client = context.getBean(MessageClient.class);
        client.sendMessage("Hello, World!");
    }
}