08-仓储与映射-DDD领域驱动设计


title: "08 仓储(Repository)与映射"


学习目标

  • 理解仓储(Repository)的本质:用"集合式接口"表达聚合的持久化,隐藏数据访问细节
  • 能解释"仓储接口在领域层、实现放基础设施层"的原因(依赖规则 + 可测试性)
  • 能识别"查询/读模型"与"聚合仓储"应当分离的场景(避免仓储膨胀)

核心概念

仓储是什么

仓储为聚合提供类似集合(Collection)的操作语义:

  • 保存聚合(save)
  • 通过标识加载聚合(findById)
  • 删除聚合(delete)

仓储不是 DAO 的同义词:DAO 往往面向表/行;仓储面向聚合。

本书示例:领域层 OrderRepository + 基础设施层 OrderRepositoryImpl。

映射(Mapping)是什么

在 DDD 分层里,经常需要把领域对象与持久化对象(PO/Entity)互相转换:

  • Domain Model(Order/VO) ↔ Persistence Object(OrderPO/OrderItemPO)

映射逻辑通常属于基础设施层(或专门的 mapper 层),避免领域层被 ORM/JSON 等技术细节污染。

示例:OrderRepositoryImpl 内部实现了 toOrderPO(...)、toOrder(...) 等转换。

课堂讲授:为什么仓储接口应该属于领域层

如果你把仓储接口放在基础设施层,那么领域层就会出现:

  • 对基础设施层的依赖(违反依赖规则)
  • 难以替换实现(内存/数据库/远程服务)
  • 难以测试(领域/应用层测试必须引入基础设施)

把接口放在领域层意味着:领域模型定义"我需要什么能力";基础设施层负责"我如何实现"。

伪代码示例:仓储的"集合式接口"

示例:OrderRepository。

text 复制代码
interface OrderRepository {
  save(order: Order)
  findById(orderNumber: OrderNumber): Optional<Order>
  findByCustomerId(customerId: CustomerId): List<Order>
  delete(orderNumber: OrderNumber)
}

课堂提醒:findByCustomerId 这类"列表查询"在真实项目里容易让仓储膨胀。是否放在仓储,要看它是否仍然符合"按聚合加载"的目的;更复杂的查询通常会走 CQRS/读模型(本书 16 章选读)。

伪代码示例:映射(Domain ↔ PO)

示例:仓储实现把领域对象映射为 PO,再用 restore(...) 之类的工厂方法恢复聚合。

text 复制代码
class OrderRepositoryImpl implements OrderRepository {
  save(order):
    po = toOrderPO(order)
    store.put(order.orderNumber.value, po)

  findById(orderNumber):
    po = store.get(orderNumber.value)
    if po is null: return empty
    return Optional.of(toOrder(po))

  toOrder(po):
    items = loadItemPOs(po.orderId).map(toOrderItem)
    return Order.restore(
      OrderNumber.of(po.orderId),
      CustomerId.of(po.customerId),
      Status.valueOf(po.status),
      items,
      po.createTime
    )
}

常见误区

  • 误区 1:仓储返回/接收 PO 而不是聚合:领域层会被持久化模型"绑架"
  • 误区 2:仓储方法无限膨胀:什么查询都往里塞,最终变成"万能查询服务"
  • 误区 3:把跨聚合的事务写进仓储:仓储应该关注一个聚合的持久化,不负责业务编排
  • 误区 4:把 ORM 注解塞进领域模型:导致领域模型依赖框架,测试与迁移困难

课堂练习

  1. 请解释:为什么要用 restore(...) 来恢复聚合,而不是直接 new Order(...)?
  2. 假设新增一个查询需求:"按订单状态分页查询订单",你会放在 OrderRepository 吗?给出你的理由,并提供一个替代方案(例如读模型/查询服务接口)。
  3. 画出一张"依赖方向图":Domain(接口)← Infrastructure(实现),并指出如果反过来会发生什么。

自测题

  1. 仓储与 DAO 的区别是什么?
  2. 为什么说"仓储面向聚合"?
  3. 映射逻辑应该放在哪里?为什么不应该放在领域层?

延伸阅读

相关推荐
FRing035 分钟前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
学长毕设31 分钟前
基于SpringBoot非遗文化展示与传播平台设计与实现-附源码
java·spring boot·后端
金銀銅鐵2 小时前
用 Swing 重做操作数栈演示
java·jvm·后端
琳少_2 小时前
java程序开发笔记
java·开发语言·数据库·笔记
七夜zippoe3 小时前
Agent 告警设计:分级告警、智能降噪与值班排班
开发语言·ai·agent·告警·智能降噪·值班排班
Flynn Liang3 小时前
大模型成本优化:基于 Redis 的可验证语义缓存架构
人工智能·redis·缓存·架构·ai agent·智能体
叼烟扛炮4 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
严肃小白兔4 小时前
PHP 8.6 正式发布:部分函数应用、原生 I/O 轮询与新特性实战解析
开发语言·php
郝学胜-神的一滴5 小时前
Effective Python 条款36:优雅拼装迭代器与生成器
开发语言·数据结构·人工智能·python·numpy·scikit-learn
文丑颜不良啊5 小时前
LeetCode3401~3420题目解析
java·leetcode