架构与系统设计 / 系统课时
分析传统订单模块的问题
分析传统订单模块的问题
传统订单模块最难重构的地方,通常不是代码行数,而是一个 OrderService 同时决定业务规则、读写数据库、调用支付系统并控制事务。先把这些职责逐项标出来,才能决定哪些逻辑应进入领域层、哪些保留在应用层、哪些下沉到基础设施层。
学习目标
- 从单个 Service 方法中识别业务规则、持久化、外部调用与事务编排
- 判断不同职责更适合放在领域层、应用层还是基础设施层
- 找出远程调用与数据库事务混在一起时的主要风险
先看一个典型的传统 Service
下面的示例可以直接编译运行。为了聚焦职责划分,仓储和支付网关使用内存实现,但调用形态与真实数据库、第三方支付接口一致。
import java.math.BigDecimal;
import java.util.HashMap;
import java.util.Map;
public class LegacyOrderDemo {
enum Status { CREATED, PAID, CANCELLED }
static class Order {
final long id;
final BigDecimal amount;
Status status;
Order(long id, BigDecimal amount, Status status) {
this.id = id;
this.amount = amount;
this.status = status;
}
}
interface OrderRepository {
Order findById(long id);
void save(Order order);
}
interface PaymentGateway {
void charge(long orderId, BigDecimal amount);
}
static class OrderService {
private final OrderRepository repository;
private final PaymentGateway paymentGateway;
OrderService(OrderRepository repository, PaymentGateway paymentGateway) {
this.repository = repository;
this.paymentGateway = paymentGateway;
}
// 假设应用框架把这个用例方法作为数据库事务边界。
void pay(long orderId) {
Order order = repository.findById(orderId);
// 业务状态判断、远程支付与持久化被挤在同一个方法中。
if (order.status != Status.CREATED) {
throw new IllegalStateException("order cannot be paid");
}
paymentGateway.charge(order.id, order.amount);
order.status = Status.PAID;
repository.save(order);
}
}
public static void main(String[] args) {
Map<Long, Order> store = new HashMap<>();
store.put(1001L, new Order(1001L, new BigDecimal("88.00"), Status.CREATED));
OrderRepository repository = new OrderRepository() {
public Order findById(long id) { return store.get(id); }
public void save(Order order) { store.put(order.id, order); }
};
PaymentGateway gateway = (id, amount) ->
System.out.println("charge order=" + id + ", amount=" + amount);
new OrderService(repository, gateway).pay(1001L);
System.out.println("status=" + store.get(1001L).status);
}
}预期输出
charge order=1001, amount=88.00
status=PAID这段代码能工作,但 pay 方法承担了四类职责。只看“代码是否运行”很难发现问题,重构时应改为看“某段逻辑因为什么原因而变化”。

按变化原因拆解职责
状态判断 order.status != CREATED 表达的是“什么订单允许支付”,它应由订单模型保护,而不是由调用者记住规则。否则批处理、管理后台或另一个接口都可能绕过同一约束。
repository.findById 与 repository.save 是持久化动作。领域层可以依赖仓储抽象,但数据库连接、ORM、SQL 与表结构属于基础设施实现,不能反向渗入订单对象。
paymentGateway.charge 是外部系统交互。应用层负责决定何时调用它,具体 HTTP、SDK、签名和重试细节属于基础设施层。这样支付供应商变化时,不必修改订单业务规则。
事务边界通常围绕一个应用用例建立,例如“加载订单 → 执行业务行为 → 保存订单”。但不应默认让数据库事务长时间包住远程支付调用,否则网络抖动会延长锁持有时间,还会出现“支付成功但数据库回滚”之类的跨系统不一致问题。
用一张责任清单确认重构方向
| 现有代码 | 它真正表达的职责 | 重构后的主要位置 |
|---|---|---|
| 检查订单状态是否允许支付 | 领域不变量 | 领域层 |
| 修改订单状态 | 聚合行为 | 领域层 |
| 加载、保存订单 | 用例所需的持久化协作 | 应用层调用仓储抽象,基础设施层实现 |
| 调用支付平台 | 用例编排与外部协作 | 应用层编排,基础设施层实现网关 |
| 开启、提交数据库事务 | 一次用例的一致性边界 | 应用层 |
判断传统 Service 是否需要重构,不看它叫不叫 Service,而看它是否同时拥有过多变化原因。先把业务决策、流程编排和技术细节分开,后续建立订单领域模型时才能真正把规则迁移,而不是只把原方法机械拆成更多类。