Java 后端 / 系统课时

划分接口、应用与基础设施层

划分接口、应用与基础设施层

本课把一个用户创建用例拆成接口层、应用层、领域层和基础设施层,明确每层能做什么、不能做什么,并通过可运行示例验证依赖方向,避免 Controller、Service 与 Repository 相互渗透。

学习目标

  • 说清接口层、应用层、领域层和基础设施层的职责边界
  • 按“外层依赖内层”的方向组织代码与接口
  • 用一个完整用例检查跨层调用是否合理

先确定四层职责

分层不是把类放进不同目录,而是限制变化传播。HTTP 协议变化不应迫使领域对象重写,数据库从 MySQL 切换到其他实现时,也不应修改核心业务规则。

层次 主要职责 不应承担
接口层 接收请求、完成参数转换、调用用例、组装响应 编写业务规则、直接操作数据库
应用层 编排用例、控制事务边界、协调领域对象与外部端口 保存复杂业务判断、依赖具体中间件
领域层 表达实体、值对象、不变量、领域服务和仓储抽象 处理 HTTP、JSON、SQL 等技术细节
基础设施层 实现持久化、消息、缓存、第三方调用等适配器 决定业务流程和业务状态转换

推荐按业务模块组织,再在模块内部划层。例如用户模块可使用 user/api、user/application、user/domain 和 user/infrastructure,这样既保留业务聚合度,也能看清依赖边界。

固定依赖方向

接口层可以调用应用层,应用层可以调用领域层;基础设施层通过实现领域层或应用层定义的端口接入系统。领域层不反向依赖 Controller、JPA Repository 或消息客户端。

四层架构依赖方向

判断依赖是否正确,可以问一个简单问题:如果把数据库实现删除,领域模型和应用用例能否继续编译。若答案是否定,通常说明具体技术类型已经越过边界。

用一个创建用户用例验证

下面的单文件示例用普通 Java 模拟四层协作。真实 Spring Boot 项目可把 UserController 替换为 @RestController,把内存仓储替换为 JPA 适配器,但调用方向保持不变。

java
import java.util.LinkedHashMap;
import java.util.Map;

public class LayeredArchitectureDemo {
    public static void main(String[] args) {
        UserRepository repository = new InMemoryUserRepository();
        CreateUserService service = new CreateUserService(repository);
        UserController controller = new UserController(service);

        System.out.println(controller.create("U-001", "Alice"));
    }

    record CreateUserCommand(String id, String name) {
    }

    static final class UserController {
        private final CreateUserService service;

        UserController(CreateUserService service) {
            this.service = service;
        }

        String create(String id, String name) {
            // 接口层只负责把输入转换为应用层命令
            User user = service.handle(new CreateUserCommand(id, name));
            return "201 CREATED userId=" + user.id() + " name=" + user.name();
        }
    }

    static final class CreateUserService {
        private final UserRepository repository;

        CreateUserService(UserRepository repository) {
            this.repository = repository;
        }

        User handle(CreateUserCommand command) {
            // 应用层编排用例,不关心数据保存到哪里
            User user = User.create(command.id(), command.name());
            repository.save(user);
            return user;
        }
    }

    record User(String id, String name) {
        static User create(String id, String name) {
            if (id == null || id.isBlank()) {
                throw new IllegalArgumentException("id must not be blank");
            }
            if (name == null || name.isBlank()) {
                throw new IllegalArgumentException("name must not be blank");
            }
            return new User(id, name);
        }
    }

    interface UserRepository {
        void save(User user);
    }

    static final class InMemoryUserRepository implements UserRepository {
        private final Map<String, User> storage = new LinkedHashMap<>();

        @Override
        public void save(User user) {
            // 基础设施层实现仓储端口,可独立替换为数据库适配器
            storage.put(user.id(), user);
        }
    }
}

预期输出

text
201 CREATED userId=U-001 name=Alice

示例中,创建规则位于 User,用例顺序位于 CreateUserService,存储方式位于 InMemoryUserRepository。任何一层都没有越权读取另一层的内部细节。

落地时检查越界

出现以下情况时,应优先调整边界,而不是继续增加工具类:

  • Controller 直接注入 JPA Repository,并在接口方法里判断业务状态
  • Application Service 到处拼装 SQL、HTTP 请求或消息体
  • Domain 对象只有 getter/setter,所有规则都堆在 Service
  • Infrastructure 通过回调决定订单、用户等核心对象的状态
  • 两层互相注入,形成循环依赖

重构时先把业务规则移入领域对象,再为外部能力定义端口,最后由基础设施层实现端口。这样改动范围最小,也更容易进行单元测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

划分接口、应用与基础设施层

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

登录哪都通