Java 后端 / 系统课时

使用构造器注入依赖

使用构造器注入依赖

本课用一个可测试的用户查询服务演示构造器注入:依赖在对象创建时一次性交齐,业务类不依赖隐藏的容器状态,并能在单元测试中直接替换仓储实现。

学习目标

  • 使用构造器声明服务的必需依赖
  • 理解构造器注入与单一职责、不可变性的关系
  • 不启动 Spring 容器也能完成服务单元测试

为什么优先使用构造器注入

构造器参数就是对象的依赖清单。只要 UserService 创建成功,就能确定它持有可用的 UserRepository;字段可以声明为 final,避免运行过程中被替换。相比字段注入,这种方式不会隐藏依赖,也不会让业务对象只能由 Spring 反射创建。

构造器注入在运行与测试中的两条装配路径

编写服务与仓储接口

下面是片段示例,文件应分别放入现有 Spring Boot 3 项目的 com.example.user 包;测试依赖由 spring-boot-starter-test 提供。

java
// User.java
package com.example.user;

public record User(Long id, String name) {}

// UserRepository.java
package com.example.user;

import java.util.Optional;

public interface UserRepository {
    Optional<User> findById(Long id);
}

// UserService.java
package com.example.user;

import org.springframework.stereotype.Service;

@Service
public class UserService {
    private final UserRepository userRepository;

    // 必需依赖只在构造时注入,创建后的引用保持不变
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public String getDisplayName(Long id) {
        return userRepository.findById(id)
                .map(User::name)
                .orElseThrow(() -> new IllegalArgumentException("用户不存在: " + id));
    }
}

// UserServiceTest.java
package com.example.user;

import org.junit.jupiter.api.Test;

import java.util.Optional;

import static org.junit.jupiter.api.Assertions.assertEquals;

class UserServiceTest {
    @Test
    void shouldReturnDisplayName() {
        // 使用 lambda 充当仓储替身,不需要启动 Spring 容器
        UserRepository fakeRepository =
                id -> Optional.of(new User(id, "Alice"));
        UserService service = new UserService(fakeRepository);

        assertEquals("Alice", service.getDisplayName(1L));
    }
}

执行指定测试:

bash
./mvnw -q -Dtest=UserServiceTest test && printf 'TEST_OK\n'

预期输出:

text
TEST_OK

让依赖边界反映单一职责

服务只负责“读取用户并转换为展示名称”,数据从哪里来由 UserRepository 决定。这样,数据库访问、远程接口或内存实现都可以替换,而服务逻辑不需要修改。测试只关心服务契约,因此执行速度快,失败原因也更集中。

当一个构造器出现大量无关参数时,通常不是注入方式的问题,而是类承担了过多职责。应先按业务能力拆分服务,再考虑聚合少量真正相关的协作者,不要用字段注入掩盖复杂度。

处理多实现与循环依赖

同一接口只有一个 Bean 时,Spring 会按类型完成注入。存在多个实现时,应通过 @Primary 指定默认实现,或在构造器参数上使用 @Qualifier 明确选择,避免依赖解析含糊。

如果启动时报告循环依赖,不要改回字段注入或滥用延迟加载。循环通常说明两个服务互相承担对方职责,应提取第三个协调组件、领域事件或更稳定的下层接口来打破双向引用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用构造器注入依赖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通