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

分析传统订单模块的问题

分析传统订单模块的问题

传统订单模块最难重构的地方,通常不是代码行数,而是一个 OrderService 同时决定业务规则、读写数据库、调用支付系统并控制事务。先把这些职责逐项标出来,才能决定哪些逻辑应进入领域层、哪些保留在应用层、哪些下沉到基础设施层。

学习目标

  • 从单个 Service 方法中识别业务规则、持久化、外部调用与事务编排
  • 判断不同职责更适合放在领域层、应用层还是基础设施层
  • 找出远程调用与数据库事务混在一起时的主要风险

先看一个典型的传统 Service

下面的示例可以直接编译运行。为了聚焦职责划分,仓储和支付网关使用内存实现,但调用形态与真实数据库、第三方支付接口一致。

java
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);
    }
}

预期输出

text
charge order=1001, amount=88.00
status=PAID

这段代码能工作,但 pay 方法承担了四类职责。只看“代码是否运行”很难发现问题,重构时应改为看“某段逻辑因为什么原因而变化”。

传统订单 Service 中四类职责混杂示意图

按变化原因拆解职责

状态判断 order.status != CREATED 表达的是“什么订单允许支付”,它应由订单模型保护,而不是由调用者记住规则。否则批处理、管理后台或另一个接口都可能绕过同一约束。

repository.findById 与 repository.save 是持久化动作。领域层可以依赖仓储抽象,但数据库连接、ORM、SQL 与表结构属于基础设施实现,不能反向渗入订单对象。

paymentGateway.charge 是外部系统交互。应用层负责决定何时调用它,具体 HTTP、SDK、签名和重试细节属于基础设施层。这样支付供应商变化时,不必修改订单业务规则。

事务边界通常围绕一个应用用例建立,例如“加载订单 → 执行业务行为 → 保存订单”。但不应默认让数据库事务长时间包住远程支付调用,否则网络抖动会延长锁持有时间,还会出现“支付成功但数据库回滚”之类的跨系统不一致问题。

用一张责任清单确认重构方向

现有代码 它真正表达的职责 重构后的主要位置
检查订单状态是否允许支付 领域不变量 领域层
修改订单状态 聚合行为 领域层
加载、保存订单 用例所需的持久化协作 应用层调用仓储抽象,基础设施层实现
调用支付平台 用例编排与外部协作 应用层编排,基础设施层实现网关
开启、提交数据库事务 一次用例的一致性边界 应用层

判断传统 Service 是否需要重构,不看它叫不叫 Service,而看它是否同时拥有过多变化原因。先把业务决策、流程编排和技术细节分开,后续建立订单领域模型时才能真正把规则迁移,而不是只把原方法机械拆成更多类。

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

目录与阅读设置

阅读设置

17

记录一个想法

分析传统订单模块的问题

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

登录哪都通