架构与系统设计 / 系统课时

接口层为什么不应该直接操作 Repository

接口层为什么不应该直接操作 Repository

接口层负责接收外部请求并完成协议转换,不应该顺手把 Repository 当成数据访问捷径。正确做法是让 Controller 调用应用服务,由应用层统一编排事务、权限和领域操作,Repository 只服务于领域与应用流程。

学习目标

  • 识别 Controller 直接访问 Repository 带来的职责泄漏
  • 理解应用层为什么是业务流程与事务边界的集中位置
  • 能把接口层改造成只负责协议适配的薄入口

直接访问 Repository 会破坏什么

Controller 如果直接调用 Repository,最先出现的问题通常不是“代码不能跑”,而是同一业务流程被拆散到多个入口。HTTP 接口可能先查权限再保存,MQ 消费者可能直接保存,后台任务又写一套事务逻辑。随着入口增多,校验顺序、权限规则和事务边界很容易不一致。

Repository 的职责是提供面向领域对象的持久化抽象,不是替接口层完成业务编排。接口层越过应用层后,业务流程就被外部协议绑住了:换成 MQ、RPC 或批处理入口时,要么复制逻辑,要么让不同入口产生不同语义。

Controller 越层访问 Repository 与正确分层对比

应用层应当承接流程边界

应用服务适合集中处理“完成一个用例需要哪些步骤”。它可以先做权限检查,再加载聚合,调用领域行为,最后保存,并把这些动作放进同一事务边界。Controller 只需要把 HTTP 参数转换成应用层命令,再把结果转换成响应。

下面的完整 Java 示例用内存仓储模拟一次“重命名客户”用例。Controller 不知道客户如何保存,只知道调用应用服务。

java
import java.util.HashMap;
import java.util.Map;

public class Main {
    record RenameCustomerCommand(long customerId, String newName) {}

    static final class Customer {
        private final long id;
        private String name;

        Customer(long id, String name) {
            this.id = id;
            this.name = name;
        }

        void rename(String newName) {
            if (newName == null || newName.isBlank()) {
                throw new IllegalArgumentException("name must not be blank");
            }
            this.name = newName;
        }

        long id() {
            return id;
        }

        String name() {
            return name;
        }
    }

    interface CustomerRepository {
        Customer findById(long id);
        void save(Customer customer);
    }

    static final class InMemoryCustomerRepository implements CustomerRepository {
        private final Map<Long, Customer> data = new HashMap<>();

        InMemoryCustomerRepository() {
            data.put(1L, new Customer(1L, "Alice"));
        }

        public Customer findById(long id) {
            Customer customer = data.get(id);
            if (customer == null) {
                throw new IllegalArgumentException("customer not found");
            }
            return customer;
        }

        public void save(Customer customer) {
            data.put(customer.id(), customer);
        }
    }

    static final class RenameCustomerService {
        private final CustomerRepository repository;

        RenameCustomerService(CustomerRepository repository) {
            this.repository = repository;
        }

        String handle(RenameCustomerCommand command) {
            Customer customer = repository.findById(command.customerId());
            customer.rename(command.newName());
            repository.save(customer);
            return customer.name();
        }
    }

    static final class CustomerController {
        private final RenameCustomerService service;

        CustomerController(RenameCustomerService service) {
            this.service = service;
        }

        String rename(long id, String name) {
            return service.handle(new RenameCustomerCommand(id, name));
        }
    }

    public static void main(String[] args) {
        CustomerRepository repository = new InMemoryCustomerRepository();
        RenameCustomerService service = new RenameCustomerService(repository);
        CustomerController controller = new CustomerController(service);

        System.out.println(controller.rename(1L, "Alicia"));
    }
}

预期输出:

text
Alicia

这里的关键不是类名,而是依赖方向:Controller 依赖应用服务,应用服务依赖 Repository 抽象。以后即使 HTTP Controller 被 MQ Consumer 替换,重命名客户的业务流程仍然只有一份。

哪些逻辑可以留在接口层

接口层可以处理协议相关工作,例如解析路径参数、校验 JSON 是否能反序列化、映射 HTTP 状态码、读取消息头或把 RPC DTO 转成命令。这些逻辑离开当前协议就失去意义,因此不需要塞进应用层。

真正与业务用例有关的规则,例如“谁有权执行”“一次操作要修改哪些聚合”“失败时是否整体回滚”,应该由应用层或领域层承担,而不是散落在 Controller 中。

判断是否已经越层

一个简单判断方法是:如果把 HTTP 换成 MQ 后,你需要复制 Controller 里的大量代码,说明接口层已经承载了业务流程。相反,如果新入口只需构造同一个应用命令并调用同一个应用服务,分层边界通常是健康的。

接口层保持薄并不是追求形式,而是为了让事务、权限和业务流程只存在一个可信入口。这样 Repository 才是持久化边界的一部分,而不是所有外部入口都能随意调用的数据通道。

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

目录与阅读设置

阅读设置

17

记录一个想法

接口层为什么不应该直接操作 Repository

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

登录哪都通