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

Repository 到底抽象了什么

Repository 到底抽象了什么

Repository 解决的不是“把 SQL 藏起来”这么简单,而是让领域代码用聚合的语言表达持久化需求:按领域标识取得聚合、保存聚合,而数据库表、ORM 映射、查询语句和连接方式留给基础设施实现。

学习目标

  • 说清 Repository 抽象的是聚合的获取与保存,而不是数据库表本身
  • 区分 Repository 与 DAO、ORM Mapper 在职责上的差异
  • 识别哪些持久化细节不应该进入领域代码

从领域代码看到的应该是聚合

以“订单”聚合为例,领域逻辑真正关心的是“取得某个订单并执行取消”,而不是“查询 orders 表,再查询 order_items 表,然后拼对象”。

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

public class RepositoryDemo {
    record OrderId(String value) {}

    static final class Order {
        private final OrderId id;
        private boolean cancelled;

        Order(OrderId id) {
            this.id = id;
        }

        void cancel() {
            this.cancelled = true;
        }

        @Override
        public String toString() {
            return id.value() + ":" + cancelled;
        }
    }

    interface OrderRepository {
        Optional<Order> findById(OrderId id);
        void save(Order order);
    }

    static final class InMemoryOrderRepository implements OrderRepository {
        private final Map<OrderId, Order> data = new HashMap<>();

        @Override
        public Optional<Order> findById(OrderId id) {
            return Optional.ofNullable(data.get(id));
        }

        @Override
        public void save(Order order) {
            data.put(order.id, order);
        }
    }

    public static void main(String[] args) {
        OrderRepository repository = new InMemoryOrderRepository();
        OrderId id = new OrderId("O-1001");
        repository.save(new Order(id));

        Order order = repository.findById(id).orElseThrow();
        order.cancel();
        repository.save(order);

        System.out.println(repository.findById(id).orElseThrow());
    }
}

预期输出:

text
O-1001:true

这个示例没有任何 SQL,却已经完整表达了领域侧的持久化意图。将内存实现替换为 JPA、MyBatis 或原生 JDBC 后,调用 Repository 的领域或应用代码仍可以保持不变。

Repository 将领域模型与持久化细节隔离

Repository 抽象的是持久化语义

Repository 通常围绕聚合根设计。它对外呈现的接口更像一个“聚合集合”:可以按领域标识取得对象,也可以保存对象状态。调用者不需要知道一个聚合最终拆成几张表、是否需要级联保存,或 ORM 如何维护关联。

这也是为什么 Repository 方法更适合使用领域概念命名。例如 findById、save、findUnpaidOrders 可以表达业务需要;而 selectOrderRow、updateOrderItemTable 已经泄漏了存储结构。

它和 DAO、Mapper 的关注点不同

对象 主要面向 常见返回值 是否允许暴露存储细节
Repository 聚合与领域语义 聚合根、领域对象 应尽量避免
DAO 数据访问操作 数据对象、记录 可以
ORM Mapper 对象与表映射 持久化对象 通常会接触表和映射配置

项目中三者可以同时存在。基础设施层内部完全可以使用 DAO 或 Mapper 完成查询,再把结果还原成聚合;真正需要隔离的是它们不要成为领域模型的直接依赖。

不要把 Repository 变成万能查询入口

Repository 不等于“所有数据库查询都放这里”。报表、列表页、统计查询往往只需要投影数据,如果为了复用 Repository 而强行加载完整聚合,会增加映射成本,也模糊聚合边界。

判断一个方法是否适合放进 Repository,可以先问两个问题:它是否围绕某个聚合根?调用者是否需要获得或保存该聚合的一致状态?如果答案都是否定的,更适合交给独立查询服务或读取模型。

Repository 的价值最终体现在依赖方向上:领域代码依赖的是“如何取得和保存聚合”的稳定契约,而 SQL、ORM、表结构和数据库产品都成为可以替换的实现细节。

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

目录与阅读设置

阅读设置

17

记录一个想法

Repository 到底抽象了什么

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

登录哪都通