Spring Boot（8）深入理解 @Autowired 注解：使用场景与实战示例

搞个引言

在 Spring 框架的开发中，依赖注入（Dependency Injection，简称 DI）是它的一个核心特性，它能够让代码更加模块化、可测试，并且易于维护。而 @Autowired 注解作为 Spring 实现依赖注入的关键工具，给咱们开发者提供了极大的便利。本文将通过具体的示例详细介绍 @Autowired 注解的多种使用场景，帮助你更好地掌握这一重要注解~

一、构造函数注入

1.1 基本原理

当一个类依赖于其他 Bean 时，使用 @Autowired 注解在构造函数上进行依赖注入是一种推荐的方式。这种方式能保证对象在创建时其依赖项就已经被正确初始化，符合依赖项不变性原则。也就是说，对象一旦创建完成，其依赖的 Bean 就不会再改变了。

1.2 示例代码

java 复制代码

// 定义一个服务接口
interface UserService {
    void saveUser();
}

// 实现服务接口
class UserServiceImpl implements UserService {
    @Override
    public void saveUser() {
        System.out.println("User saved.");
    }
}

// 定义一个控制器类，依赖 UserService
class UserController {
    private final UserService userService;

    // 使用 @Autowired 注解在构造函数上进行依赖注入
    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }

    public void handleSaveUser() {
        userService.saveUser();
    }
}

1.3 代码解释

在上述代码中，UserController 类依赖于 UserService 接口的实现类。通过在构造函数上使用 @Autowired 注解，Spring 容器会自动查找 UserService 类型的 Bean，并将其注入到 UserController 的构造函数中。这样，在创建 UserController 对象时，userService 字段就已经被正确初始化，后续可以直接使用。

1.4 使用优势

依赖不可变：使用构造函数注入，一旦对象创建完成，其依赖的 Bean 就不会再改变，保证了对象状态的一致性。
便于单元测试：在进行单元测试时，可以方便地通过构造函数传入模拟对象，提高代码的可测试性。

二、Setter 方法注入

2.1 基本原理

除了构造函数注入，@Autowired 注解还可以用于 Setter 方法上。这种方式允许在对象创建后动态地注入依赖项，适用于一些依赖项可能会在对象生命周期内发生变化的场景。

2.2 示例代码

java 复制代码

// 定义一个邮件服务接口
interface EmailService {
    void sendEmail(String message);
}

// 实现邮件服务接口
class EmailServiceImpl implements EmailService {
    @Override
    public void sendEmail(String message) {
        System.out.println("Sending email: " + message);
    }
}

// 定义一个通知服务类，依赖 EmailService
class NotificationService {
    private EmailService emailService;

    // 使用 @Autowired 注解在 Setter 方法上进行依赖注入
    @Autowired
    public void setEmailService(EmailService emailService) {
        this.emailService = emailService;
    }

    public void sendNotification(String message) {
        emailService.sendEmail(message);
    }
}

2.3 代码解释

在这个示例中，NotificationService 类依赖于 EmailService。通过在 setEmailService 方法上使用 @Autowired 注解，Spring 容器会自动查找 EmailService 类型的 Bean，并调用该 Setter 方法将其注入到 NotificationService 对象中。

2.4 使用优势

灵活性高：可以在对象创建后动态地改变依赖项，适应不同的业务需求。
部分依赖注入：当一个类有多个依赖项，但不是所有依赖项都需要在对象创建时立即注入时，使用 Setter 方法注入可以更灵活地管理依赖。

三、字段注入

3.1 基本原理

@Autowired 注解还可以直接用于类的字段上，这是一种最简单的依赖注入方式。Spring 容器会自动查找匹配类型的 Bean，并将其注入到相应的字段中。

3.2 示例代码

java 复制代码

// 定义一个日志服务接口
interface LogService {
    void log(String message);
}

// 实现日志服务接口
class LogServiceImpl implements LogService {
    @Override
    public void log(String message) {
        System.out.println("Logging: " + message);
    }
}

// 定义一个业务服务类，依赖 LogService
class BusinessService {
    // 使用 @Autowired 注解在字段上进行依赖注入
    @Autowired
    private LogService logService;

    public void doBusiness() {
        logService.log("Business operation started.");
        // 业务逻辑代码
        logService.log("Business operation completed.");
    }
}

3.3 代码解释

在 BusinessService 类中，logService 字段使用了 @Autowired 注解。Spring 容器会自动查找 LogService 类型的 Bean，并将其注入到该字段中。这样，在 doBusiness 方法中就可以直接使用 logService 进行日志记录。

3.4 使用优势

代码简洁：无需编写构造函数或 Setter 方法，代码更加简洁明了。

3.5 使用注意事项

不利于单元测试：由于字段注入是通过反射实现的，在进行单元测试时，难以直接注入模拟对象，降低了代码的可测试性。
依赖不明确：字段注入隐藏了类的依赖关系，不利于代码的维护和理解。

四、数组和集合注入

4.1 基本原理

@Autowired 注解不仅可以注入单个 Bean，还可以注入数组或集合类型的 Bean。Spring 容器会自动查找所有匹配类型的 Bean，并将它们注入到相应的数组或集合中。

4.2 示例代码

java 复制代码

// 定义一个消息处理器接口
interface MessageHandler {
    void handleMessage(String message);
}

// 实现消息处理器接口
class EmailMessageHandler implements MessageHandler {
    @Override
    public void handleMessage(String message) {
        System.out.println("Handling email message: " + message);
    }
}

class SmsMessageHandler implements MessageHandler {
    @Override
    public void handleMessage(String message) {
        System.out.println("Handling SMS message: " + message);
    }
}

// 定义一个消息分发服务类，依赖多个 MessageHandler
class MessageDispatcherService {
    // 使用 @Autowired 注解注入 MessageHandler 数组
    @Autowired
    private MessageHandler[] messageHandlers;

    public void dispatchMessage(String message) {
        for (MessageHandler handler : messageHandlers) {
            handler.handleMessage(message);
        }
    }
}

3.3 代码解释

在 MessageDispatcherService 类中，messageHandlers 字段是一个 MessageHandler 数组，使用 @Autowired 注解进行注入。Spring 容器会自动查找所有实现了 MessageHandler 接口的 Bean，并将它们注入到该数组中。在 dispatchMessage 方法中，可以遍历数组并调用每个 MessageHandler 的 handleMessage 方法。

3.4 使用优势

方便管理多个同类型 Bean：当一个类需要依赖多个同类型的 Bean 时，使用数组或集合注入可以方便地管理这些 Bean。

五、总结

@Autowired 注解为 Spring 框架中的依赖注入提供了多种灵活的方式，包括构造函数注入、Setter 方法注入、字段注入以及数组和集合注入。在实际开发中，应根据具体的业务场景和需求选择合适的注入方式。构造函数注入适用于依赖项不变的场景，能提高代码的可测试性；Setter 方法注入提供了更高的灵活性，适用于依赖项可能动态变化的情况；字段注入虽然代码简洁，但不利于单元测试和代码维护；数组和集合注入则方便管理多个同类型的 Bean。通过合理使用 @Autowired 注解，可以让代码更加模块化、可维护和易于测试。

✍结尾

🀙🀚🀛🀜🀝🀞🀟🀠🀡🀐🀑🀒🀓🀔🀕🀖🀘🀗🀏🀎🀍🀌🀋🀊🀉🀈🀇🀆🀅🀃🀂🀁🀀🀄︎🀢🀣🀥🀤🀦🀧🀨🀩🀪

📘 妹妹听后点了点头，脸上露出了满意的笑容。她轻声说道："原来如此，谢谢你，鸽鸽。看来我不仅要多读书，还要多动手实践，提升自己才行。"

看着她那充满求知欲的眼神，我不禁感叹，学习之路虽然充满挑战，但有这样一位美丽聪慧的伙伴相伴，一切都变得格外有意义。快去和妹妹一起实践一下吧！

📘相关阅读⚡⚡

笔者綦枫Maple 的其他作品，欢迎点击查阅哦~：

📚Jmeter性能测试大全：Jmeter性能测试大全系列教程！持续更新中！

📚UI自动化测试系列： Selenium+Java自动化测试系列教程❤

📚移动端自动化测试系列：Appium自动化测试系列教程

📚Postman系列：Postman高级使用技巧系列

bash 复制代码

👨‍🎓作者：綦枫Maple
🚀博客：CSDN、掘金等
🚀CSDN技术社区：https://bbs.csdn.net/forums/testbean
🚀网易云音乐：https://y.music.163.com/m/user?id=316706413
🚫特别声明：原创不易，转载请附上原文出处链接和本文声明，谢谢配合。
🙏版权声明：文章里可能部分文字或者图片来源于互联网或者百度百科，如有侵权请联系处理。
🀐其他：若有兴趣，可以加文章结尾的Q群，一起探讨学习哦~