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

创建订单请求从哪里开始

创建订单请求从哪里开始

创建订单并不是从领域对象开始,而是从系统边界上的 HTTP Request 开始。本节把一条创建请求拆成“传输对象 → 参数校验 → 应用层输入”的过程,重点说明哪些信息应在接口层完成整理,哪些内容不该直接泄漏到领域层。

学习目标

  • 能区分 HTTP 请求模型与应用层输入对象的职责
  • 能把外部请求稳定地转换为 CreateOrderCommand
  • 能识别 Controller 中应保留和应避免的逻辑

从 HTTP 边界接住外部数据

客户端提交的 JSON 属于接口协议,它关心字段名、序列化格式和 HTTP 状态码等传输细节。应用层需要的却是一个明确的用例输入,例如“为某个客户创建一张包含若干商品的订单”。因此,Controller 的首要职责不是创建领域对象,而是把外部协议转换为应用层能理解的输入。

请求体可以长这样:

json
{
  "customerId": "C-1001",
  "items": [
    {"productId": "P-2001", "quantity": 2}
  ]
}

这段 JSON 是接口数据结构,不是领域模型。Web 框架通常先把它反序列化为接口层的 Request DTO,再由边界代码转换为应用层命令。验证时可以确认请求字段能被正确绑定,并且缺失必填字段时由接口层返回协议级错误。

转换成应用层输入

下面用纯 Java 演示 HTTP 请求完成反序列化之后的转换。示例刻意不引入 Spring 或其他 Web 框架,以便只观察“接口 DTO → 应用命令”这一职责边界。

java
import java.util.List;

public class RequestMappingDemo {

    public record CreateOrderRequest(String customerId, List<ItemRequest> items) {
        public record ItemRequest(String productId, int quantity) {}
    }

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

    public static CreateOrderCommand toCommand(CreateOrderRequest request) {
        // 边界层只做结构转换,不在这里创建 Order 聚合或访问数据库。
        List<CreateOrderCommand.Line> lines = request.items().stream()
            .map(item -> new CreateOrderCommand.Line(
                item.productId(),
                item.quantity()
            ))
            .toList();

        return new CreateOrderCommand(request.customerId(), lines);
    }

    public static void main(String[] args) {
        // 模拟 Web 框架已经把 HTTP JSON 反序列化为 Request DTO。
        CreateOrderRequest request = new CreateOrderRequest(
            "C-1001",
            List.of(new CreateOrderRequest.ItemRequest("P-2001", 2))
        );

        CreateOrderCommand command = toCommand(request);
        System.out.println(command.customerId());
        System.out.println(command.lines().get(0).productId());
        System.out.println(command.lines().get(0).quantity());
    }
}

编译并运行:

bash
javac RequestMappingDemo.java && java RequestMappingDemo

预期输出:

text
C-1001
P-2001
2

输出证明 Request DTO 中的客户与商品项已经转换为应用命令;真实项目中下一步才是把 CreateOrderCommand 交给应用服务。

HTTP 创建订单请求进入应用层的数据流

图中的关键点是:跨层时传递的是经过转换的用例输入,而不是把 HTTP DTO 一路向下传。这样应用层不会依赖 JSON 字段、Controller 注解或 Web 框架。

哪些校验放在接口层

接口层适合处理“请求是否可被系统接受”的基础校验,例如缺少必填字段、JSON 类型错误、无法解析的数字格式。真正的业务规则仍应由领域对象或领域服务判断。

例如,“quantity 必须能解析为整数”属于接口约束;“单个订单最多允许购买多少件某商品”通常属于业务规则。前者可以在请求绑定阶段拒绝,后者不应写进 Controller,否则相同规则在消息消费、批处理等其他入口中无法复用。

Controller 最终应该有多薄

理想的 Controller 只完成四件事:接收请求、做协议级校验、转换为应用层输入、把应用服务结果映射为 HTTP 响应。它不应该知道订单聚合内部怎样生成订单项,也不应该知道仓储最终使用 JPA、MyBatis 还是远程服务。

当边界保持清晰后,同一个 CreateOrderCommand 可以来自 HTTP、消息队列或测试代码,应用层仍然按同一用例执行。这正是“请求从哪里开始”的关键:请求从接口层进入,但业务流程从应用层输入开始。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建订单请求从哪里开始

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

登录哪都通