架构与系统设计 / 系统课时
实体的方法应该写什么
实体的方法应该写什么
实体的方法不应只是给字段换个名字的 setter,而应把“什么状态下允许做什么”写成业务行为。下面用订单支付、发货和取消说明:实体如何在修改自身状态前检查规则,并保证任何一次调用都不会把对象推进到非法状态。
学习目标
- 判断哪些业务规则应该进入实体方法
- 用状态转换保护实体自身的不变量
- 区分实体行为与应用服务的职责
实体方法的核心是维护不变量
实体拥有身份,也拥有一组必须始终成立的业务约束。所谓不变量,就是无论从哪个入口操作对象,规则都不能被绕过。例如订单已经发货后不能取消,未支付的订单不能直接发货。
因此,实体方法应该优先表达业务动作,如 pay()、ship()、cancel(),而不是暴露 setStatus() 让外部任意写状态。方法内部先检查当前状态和必要条件,只有规则成立才修改数据;失败时立即拒绝操作。
适合放进实体的方法通常具有三个特征:规则主要依赖实体自己的状态或值对象;违反规则会让实体进入非法状态;动作能用领域语言自然命名。反过来,查询数据库、调用支付网关、发送消息等外部协作不属于实体自身职责。
用订单状态变化保护规则
订单的核心状态可以简化为 CREATED、PAID、SHIPPED 和 CANCELED。合法转换并不是任意组合,而是由业务动作决定。

下面的完整 Java 示例把这些转换直接封装在实体中。外部代码只能调用业务方法,无法直接改写状态。
public class OrderEntityDemo {
enum Status {
CREATED, PAID, SHIPPED, CANCELED
}
static final class Order {
private final String orderId;
private Status status = Status.CREATED;
Order(String orderId) {
if (orderId == null || orderId.isBlank()) {
throw new IllegalArgumentException("订单号不能为空");
}
this.orderId = orderId;
}
void pay() {
// 支付只允许从已创建状态进入已支付状态。
if (status != Status.CREATED) {
throw new IllegalStateException("只有待支付订单可以支付");
}
status = Status.PAID;
}
void ship() {
// 发货依赖订单已经完成支付这一业务前置条件。
if (status != Status.PAID) {
throw new IllegalStateException("只有已支付订单可以发货");
}
status = Status.SHIPPED;
}
void cancel() {
// 已发货订单一旦取消会破坏订单生命周期约束,因此直接拒绝。
if (status == Status.SHIPPED) {
throw new IllegalStateException("已发货订单不能取消");
}
if (status == Status.CANCELED) {
throw new IllegalStateException("订单已经取消");
}
status = Status.CANCELED;
}
Status status() {
return status;
}
}
public static void main(String[] args) {
Order order = new Order("O-1001");
order.pay();
order.ship();
System.out.println("状态: " + order.status());
try {
order.cancel();
} catch (IllegalStateException e) {
System.out.println("拒绝取消: " + e.getMessage());
}
}
}预期输出
状态: SHIPPED
拒绝取消: 已发货订单不能取消这里最重要的不是使用枚举,而是任何调用方都必须经过实体定义的合法入口。即使以后接口、定时任务和消息消费者都能操作订单,也不能绕过同一组规则。
判断方法该不该放进实体
可以按下面的顺序判断一个行为是否应该由实体承担:
- 这个行为是否会改变实体自身状态,或依赖实体当前状态做判断。
- 如果绕过这个行为,是否可能得到业务上不合法的实体。
- 这个行为是否主要依赖实体内部信息,而不是多个聚合、远程服务或数据库查询。
例如“订单发货前必须已支付”应由订单实体保护;“调用物流服务创建运单”则需要外部系统参与,通常由应用服务组织。应用服务可以先加载订单、调用 order.ship(),再保存订单并触发后续集成操作。
避免把所有逻辑都塞进实体
“富领域模型”不等于“实体知道一切”。实体负责本聚合内部的一致性和业务行为,应用层负责流程编排,仓储和外部服务负责持久化与集成。把边界守住后,实体的方法会更像业务语言,同时也更容易测试:只需构造对象并调用方法,就能验证规则是否被正确保护。