Spring Boot2.x教程：（十）从Field injection is not recommended谈谈依赖注入

欧阳方超2024-11-06 17:28

从Field injection is not recommended谈谈依赖注入

大家好，我是欧阳方超，可以扫描下方二维码关注我的公众号"欧阳方超"，后续内容将在公众号首发。

1、问题引入

在使用Spring框架时，我们经常会看到IDE给出这样的警告：

bash 复制代码 
Field injection is not recommended

这通常出现在我们使用@Autowired注解直接注入字段时：

bash 复制代码 
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;  // Field injection
}

2、依赖注入的三种方式

在Spring中，依赖注入(DI)主要有三种方式，我们先来了解一下。

2.1、字段注入（Field Injection）

字段注入是一种依赖注入的方式，通过直接将依赖项（如服务或组件）注入到类的字段中。通常，这种方式通过使用注解（如 @Autowired）来实现。例如：

bash 复制代码 
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
}

2.2、构造器注入（Constructor Injection）

通过构造器传递依赖项是最推荐的方式。这种方式可以确保所有必需的依赖项在对象创建时就被提供，并且可以轻松进行单元测试。

bash 复制代码 
@Service
public class UserService {
    private final UserRepository userRepository;

    @Autowired  // 在Spring 4.3+，当类只有一个构造器时，@Autowired可以省略
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
}

2.3、setter注入（Setter Injection）

Setter 注入是一种依赖注入的方式，通过公开的 setter 方法将依赖项注入到对象中。这种方式允许在对象创建后动态地设置依赖项，提供了比字段注入更好的灵活性和可测试性。Setter 注入通常与 Spring 框架一起使用，依赖项通过 @Autowired 注解标记的 setter 方法进行注入。

bash 复制代码 
@Service
public class UserService {
    private UserRepository userRepository;

    @Autowired
    public void setUserRepository(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
}

3、为什么不推荐字段注入

3.1、违反单一职责原则

字段注入（Field Injection）在依赖注入的实现中常常被认为违反了单一职责原则（Single Responsibility Principle, SRP）。单一职责原则是面向对象设计中的一个重要原则，旨在确保一个类应该只有一个原因去改变，即一个类应该仅承担一个责任。

使用字段注入时，类的职责往往会变得模糊。具体来说，类不仅需要处理其核心业务逻辑，还需要负责管理其依赖关系的生命周期和注入。这种责任的混淆使得类变得更加复杂，难以理解和维护。

bash 复制代码 
public class UserService {
    @Autowired
    private UserRepository userRepository; // 依赖关系的管理

    public void createUser(User user) {
        // 业务逻辑
    }
}

在这个例子中，UserService 类不仅负责用户相关的业务逻辑，还需要处理 UserRepository 的依赖关系。这使得 UserService 的职责超出了其核心功能。

3.2、无法创建不可变对象

使用字段注入时：

bash 复制代码 
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
}

这种方式下，userRepository无法声明为final，意味着字段可能在运行时被修改、无法保证线程安全、对象状态可能发生变化。

3.3、可测试性差

在单元测试中，我们通常希望能够控制被测试对象的所有依赖项，以便验证其行为。使用字段注入时，无法通过构造函数或方法直接传递模拟对象，这会导致下面的问题。

无法直接提供模拟对象：

由于依赖项是通过字段自动注入的，无法在创建被测试对象时直接提供一个模拟（mock）对象。这意味着必须依赖 Spring 的上下文来创建对象，而这通常会引入不必要的复杂性。

需要 Spring 上下文：

由于依赖项是通过 Spring 容器管理的，需要启动 Spring 上下文才能进行测试。这会增加测试的开销，并可能导致测试运行速度变慢。

难以隔离测试：

字段注入使得类与 Spring 框架紧密耦合，这使得单元测试难以隔离被测类和其依赖项，从而降低了测试的独立性。

4、推荐使用构造器注入的原因

4.2、明确的依赖关系

bash 复制代码 
@Service
public class UserService {
    private final UserRepository userRepository;
    private final EmailService emailService;

    public UserService(UserRepository userRepository, EmailService emailService) {
        this.userRepository = userRepository;
        this.emailService = emailService;
    }
}

通过构造器参数，清晰地表明类的依赖，使得代码更易于维护和理解。

4.2、不可变性保证

依赖可以声明为final，确保运行时不会被修改，保证了线程安全。

4.3、单元测试友好

bash 复制代码 
@Test
public void testUserService() {
    // 方便进行mock测试
    UserRepository mockRepo = mock(UserRepository.class);
    EmailService mockEmail = mock(EmailService.class);
    
    UserService service = new UserService(mockRepo, mockEmail);
    // 进行测试...
}

4.4、容器无关性

类可以在Spring容器之外实例化，提高了代码的可复用性。

5、最佳实践示例

bash 复制代码 
@Service
public class UserService {
    private final UserRepository userRepository;
    private final EmailService emailService;
    private final SecurityService securityService;

    public UserService(
            UserRepository userRepository,
            EmailService emailService,
            SecurityService securityService) {
        this.userRepository = Objects.requireNonNull(userRepository, "UserRepository must not be null");
        this.emailService = Objects.requireNonNull(emailService, "EmailService must not be null");
        this.securityService = Objects.requireNonNull(securityService, "SecurityService must not be null");
    }

    public User createUser(UserDTO userDTO) {
        // 使用注入的依赖
        User user = userRepository.save(userDTO.toUser());
        emailService.sendWelcomeEmail(user);
        securityService.grantDefaultPermissions(user);
        return user;
    }
}

6、Lombok的@RequiredArgsConstructor

如果依赖较多，构造器代码会比较冗长。可以使用Lombok的@RequiredArgsConstructor注解简化：

bash 复制代码 
@Service
@RequiredArgsConstructor
public class UserService {
    private final UserRepository userRepository;
    private final EmailService emailService;
    private final SecurityService securityService;
    
    // Lombok会自动生成包含所有final字段的构造器
}

7、总结

尽管字段注入在某些情况下看起来更简单，但它带来了许多潜在的问题，特别是在可测试性和可维护性方面。因此，我们建议使用构造函数或方法参数进行依赖注入，以提高代码质量和可读性。通过采取这些最佳实践，将能够编写出更加健壮、易于维护和高效的 Java 应用程序。

我是欧阳方超，把事情做好了自然就有兴趣了，如果你喜欢我的文章，欢迎点赞、转发、评论加关注。我们下次见。

相关推荐
zquwei11 分钟前
SpringCloudGateway+Nacos注册与转发Netty+WebSocket
java·网络·分布式·后端·websocket·网络协议·spring
TT哇17 分钟前
*【每日一题 提高题】[蓝桥杯 2022 国 A] 选素数
java·算法·蓝桥杯
dessler32 分钟前
Docker-run命令详细讲解
linux·运维·后端·docker
火烧屁屁啦40 分钟前
【JavaEE进阶】初始Spring Web MVC
java·spring·java-ee
w_31234541 小时前
自定义一个maven骨架 | 最佳实践
java·maven·intellij-idea
岁岁岁平安1 小时前
spring学习(spring-DI(字符串或对象引用注入、集合注入)(XML配置))
java·学习·spring·依赖注入·集合注入·基本数据类型注入·引用数据类型注入
武昌库里写JAVA1 小时前
Java成长之路（一）--SpringBoot基础学习--SpringBoot代码测试
java·开发语言·spring boot·学习·课程设计
Q_19284999061 小时前
基于Spring Boot的九州美食城商户一体化系统
java·spring boot·后端
Q_19284999061 小时前
基于Spring Boot的营销项目系统
spring boot
热门推荐
01构建高效的广告投放系统：应用架构的设计与实现02ARM学习（31）编译器对overlay方式的支持03玄机平台应急响应—webshell查杀04Cube-Studio：开源大模型全链路一站式中台05校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站06Docker 夺命连环 15 问07〔AI 绘画〕Stable Diffusion 之 解决绘制多人或面部很小的人物时面部崩坏问题 篇08基于大语言模型（LLM）的合成数据生成、策展和评估的综述09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO