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

应用服务怎样组织创建流程

应用服务怎样组织创建流程

应用服务负责把“创建订单”这个用例串起来:准备调用所需上下文,调用领域对象执行业务行为,通过仓储保存结果,再把适合上层消费的信息返回。它的价值在于组织步骤和事务边界,而不是把领域规则搬到应用层。

学习目标

  • 能说明应用服务在创建流程中的编排职责
  • 能区分应用层编排与领域层业务规则
  • 能实现“创建 → 保存 → 返回结果”的最小完整流程

应用服务负责用例编排

收到 CreateOrderCommand 后,应用服务通常按固定顺序工作:准备用例需要的上下文或外部数据,调用领域模型创建聚合,通过仓储持久化,再生成返回对象。这里的“固定顺序”是用例流程,而不是订单自身的业务规则。

创建订单应用服务编排流程

应用服务可以调用仓储接口,但不应该知道 SQL、表结构或 ORM Session;它调用的是领域或应用层定义的抽象,具体实现由基础设施层提供。

用一个完整示例看清职责

下面用纯 Java 构造一个最小可运行示例。为了聚焦分层职责,仓储使用内存实现,但应用服务只依赖 OrderRepository 接口,因此替换成数据库实现时不需要改用例流程。

java
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.UUID;

public class OrderApplicationDemo {

    public record CreateOrderCommand(String customerId, List<Line> lines) {
        public record Line(String productId, int quantity) {}
    }

    public record CreateOrderResult(String orderId) {}

    public static final class Order {
        private final String id;
        private final String customerId;
        private final List<CreateOrderCommand.Line> lines;

        private Order(String id, String customerId, List<CreateOrderCommand.Line> lines) {
            this.id = id;
            this.customerId = customerId;
            this.lines = List.copyOf(lines);
        }

        public static Order create(CreateOrderCommand command) {
            if (command.customerId() == null || command.customerId().isBlank()) {
                throw new IllegalArgumentException("customerId is required");
            }
            if (command.lines() == null || command.lines().isEmpty()) {
                throw new IllegalArgumentException("order lines are required");
            }
            if (command.lines().stream().anyMatch(line -> line.quantity() <= 0)) {
                throw new IllegalArgumentException("quantity must be positive");
            }

            // 业务规则由领域对象负责,应用服务只决定何时调用。
            return new Order(UUID.randomUUID().toString(), command.customerId(), command.lines());
        }

        public String id() {
            return id;
        }
    }

    public interface OrderRepository {
        void save(Order order);
    }

    public static final class InMemoryOrderRepository implements OrderRepository {
        private final Map<String, Order> storage = new HashMap<>();

        @Override
        public void save(Order order) {
            storage.put(order.id(), order);
        }

        public boolean exists(String orderId) {
            return storage.containsKey(orderId);
        }
    }

    public static final class CreateOrderApplicationService {
        private final OrderRepository repository;

        public CreateOrderApplicationService(OrderRepository repository) {
            this.repository = repository;
        }

        public CreateOrderResult handle(CreateOrderCommand command) {
            // 应用服务编排领域行为和持久化,不复制领域校验。
            Order order = Order.create(command);
            repository.save(order);
            return new CreateOrderResult(order.id());
        }
    }

    public static void main(String[] args) {
        InMemoryOrderRepository repository = new InMemoryOrderRepository();
        CreateOrderApplicationService service = new CreateOrderApplicationService(repository);

        CreateOrderCommand command = new CreateOrderCommand(
            "C-1001",
            List.of(new CreateOrderCommand.Line("P-2001", 2))
        );

        CreateOrderResult result = service.handle(command);

        // 用可验证的布尔值避免把随机订单 ID 写死到预期输出。
        System.out.println("created=" + repository.exists(result.orderId()));
        System.out.println("orderIdGenerated=" + !result.orderId().isBlank());
    }
}

编译并运行:

bash
javac OrderApplicationDemo.java && java OrderApplicationDemo

预期输出:

text
created=true
orderIdGenerated=true

订单 ID 是动态生成的,所以示例只验证“已生成且已经保存”,不把具体 <ID> 写进输出。

为什么领域规则不放进应用服务

如果把“客户不能为空”“数量必须大于零”都写在 CreateOrderApplicationService,应用服务就会逐渐变成业务规则集中地。以后从其他用例创建订单、恢复订单或执行领域测试时,还要复制这些判断。

让 Order.create 维护创建时必须成立的不变量,应用服务只负责调用顺序,可以把两类变化隔离开:业务规则变化主要影响领域层,用例流程变化主要影响应用层。

仓储保存为什么由应用服务触发

领域对象描述业务状态和行为,但通常不负责决定自己何时持久化。应用服务在领域行为成功后调用 repository.save(order),因此能把“创建成功后保存”明确纳入用例流程,也便于统一事务管理。真实项目若使用事务框架,通常让这一整个用例在一个应用服务事务边界内完成。

数据库细节应放在 OrderRepository 的基础设施实现里。应用服务看到的是保存聚合的抽象操作,所以无论底层使用 JPA、MyBatis 还是事件存储,用例代码都不需要知道表名、SQL 或连接配置。

返回结果只暴露用例需要的信息

应用服务不必把整个 Order 聚合直接返回给 Controller。创建接口通常只需要订单 ID、创建状态或少量展示字段,因此可以返回专门的 CreateOrderResult。

这样可以避免接口层依赖领域对象内部结构,也能防止为了适配 HTTP 响应而给领域模型添加无关字段。一个清晰的创建流程最终应形成稳定链路:应用服务负责“编排”,领域对象负责“规则”,仓储负责“持久化抽象”,基础设施负责“技术实现”。

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

目录与阅读设置

阅读设置

17

记录一个想法

应用服务怎样组织创建流程

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

登录哪都通