架构与系统设计 / 系统课时
DO、PO 和 Domain Entity 怎么区分
DO、PO 和 Domain Entity 怎么区分
在 DDD 项目里,最容易混淆的不是类名,而是对象承担的职责。本篇用订单示例区分 DO、PO 与 Domain Entity,重点说明为什么持久化结构不应直接决定领域模型,以及三者发生变化时各自应该由谁承受。
学习目标
- 能根据职责而不是类名判断 DO、PO 与 Domain Entity
- 能解释持久化对象与领域实体为什么不必一一对应
- 能识别把数据库字段直接泄漏到领域模型中的常见问题
先看职责,不先看缩写
PO(Persistence Object)直接服务于持久化映射,字段通常贴近表结构,例如主键、外键、状态码、冗余列和审计时间。它关注的是“怎样存、怎样读”,而不是业务行为是否完整。
Domain Entity 属于领域层,用身份标识表达一个持续存在的业务对象,并通过方法维护业务不变量。它关注“这个对象允许发生什么”,而不是字段如何落库。
DO 在不同团队里含义并不统一。常见约定是 Data Object,用来承载数据库或数据访问层的数据;也有团队把 DO 写成 Domain Object。看到 DO 时应先查项目约定和包位置,不能仅凭缩写判断它属于哪一层。
| 对象 | 主要职责 | 常见位置 | 是否应包含业务规则 |
|---|---|---|---|
| PO | 映射持久化结构 | infrastructure / persistence | 否 |
| DO(Data Object) | 承载数据访问结果 | infrastructure / dao | 通常否 |
| Domain Entity | 表达业务身份与行为 | domain | 是 |
持久化模型不必等于领域模型
假设数据库为了查询方便,把订单金额拆成 amount 与 currency 两列,并用字符串保存状态。领域层则可以把金额建模为 Money 值对象,把状态变化约束封装在实体方法中。两边字段数量和类型不同并不是问题,反而能让数据库设计和业务模型独立演进。
下面的完整 Java 示例刻意让 PO 保持“扁平”,而领域实体通过行为维护状态约束。
public class Main {
enum OrderStatus {
CREATED, PAID
}
record OrderPO(long id, long amountCents, String currency, String status) {}
record Money(long cents, String currency) {
Money {
if (cents < 0) {
throw new IllegalArgumentException("amount must be non-negative");
}
}
}
static final class Order {
private final long id;
private final Money total;
private OrderStatus status;
Order(long id, Money total, OrderStatus status) {
this.id = id;
this.total = total;
this.status = status;
}
void pay() {
if (status != OrderStatus.CREATED) {
throw new IllegalStateException("only CREATED order can be paid");
}
status = OrderStatus.PAID;
}
String snapshot() {
return id + ":" + total.cents() + ":" + total.currency() + ":" + status;
}
}
static Order toDomain(OrderPO po) {
return new Order(
po.id(),
new Money(po.amountCents(), po.currency()),
OrderStatus.valueOf(po.status())
);
}
public static void main(String[] args) {
OrderPO po = new OrderPO(1001L, 2599L, "CNY", "CREATED");
Order order = toDomain(po);
order.pay();
System.out.println(order.snapshot());
}
}预期输出
1001:2599:CNY:PAID这个示例里,OrderPO 没有 pay(),因为“订单能否支付”不是数据库映射职责;Order 也没有表名、列名或 ORM 注解,因为这些信息不属于领域规则。
一一对应通常是偶然,不是目标
简单 CRUD 场景中,PO 与 Entity 可能暂时字段相同,但这只是当前实现恰好一致。随着业务增长,领域模型可能合并多个表的数据,也可能只使用一张表的部分字段;反过来,数据库还可能增加索引辅助列、审计列或反范式字段,而领域层完全不需要知道。
因此不要为了“少写转换代码”强制两者共享同一个类。共享类会让表结构调整影响领域层,也会诱使 ORM 注解、可空字段和数据库默认值进入业务模型。
判断一个类属于哪边
遇到一个名为 OrderDO 或 OrderPO 的类,可以按三个问题判断:它是否直接对应表或查询结果;它是否携带 ORM、序列化或数据库字段约束;它的核心方法是在维护业务规则,还是只在存取数据。前两项明显成立时,它更接近持久化对象;第三项明显成立时,它更接近领域实体。
真正需要稳定的是职责边界,而不是缩写。PO 或 Data Object 可以随存储方案变化,Domain Entity 则应围绕业务语言和不变量演进,两者通过明确的转换连接即可。