架构与系统设计 / 系统课时
创建订单请求从哪里开始
创建订单请求从哪里开始
创建订单并不是从领域对象开始,而是从系统边界上的 HTTP Request 开始。本节把一条创建请求拆成“传输对象 → 参数校验 → 应用层输入”的过程,重点说明哪些信息应在接口层完成整理,哪些内容不该直接泄漏到领域层。
学习目标
- 能区分 HTTP 请求模型与应用层输入对象的职责
- 能把外部请求稳定地转换为
CreateOrderCommand - 能识别 Controller 中应保留和应避免的逻辑
从 HTTP 边界接住外部数据
客户端提交的 JSON 属于接口协议,它关心字段名、序列化格式和 HTTP 状态码等传输细节。应用层需要的却是一个明确的用例输入,例如“为某个客户创建一张包含若干商品的订单”。因此,Controller 的首要职责不是创建领域对象,而是把外部协议转换为应用层能理解的输入。
请求体可以长这样:
{
"customerId": "C-1001",
"items": [
{"productId": "P-2001", "quantity": 2}
]
}这段 JSON 是接口数据结构,不是领域模型。Web 框架通常先把它反序列化为接口层的 Request DTO,再由边界代码转换为应用层命令。验证时可以确认请求字段能被正确绑定,并且缺失必填字段时由接口层返回协议级错误。
转换成应用层输入
下面用纯 Java 演示 HTTP 请求完成反序列化之后的转换。示例刻意不引入 Spring 或其他 Web 框架,以便只观察“接口 DTO → 应用命令”这一职责边界。
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());
}
}编译并运行:
javac RequestMappingDemo.java && java RequestMappingDemo预期输出:
C-1001
P-2001
2输出证明 Request DTO 中的客户与商品项已经转换为应用命令;真实项目中下一步才是把 CreateOrderCommand 交给应用服务。

图中的关键点是:跨层时传递的是经过转换的用例输入,而不是把 HTTP DTO 一路向下传。这样应用层不会依赖 JSON 字段、Controller 注解或 Web 框架。
哪些校验放在接口层
接口层适合处理“请求是否可被系统接受”的基础校验,例如缺少必填字段、JSON 类型错误、无法解析的数字格式。真正的业务规则仍应由领域对象或领域服务判断。
例如,“quantity 必须能解析为整数”属于接口约束;“单个订单最多允许购买多少件某商品”通常属于业务规则。前者可以在请求绑定阶段拒绝,后者不应写进 Controller,否则相同规则在消息消费、批处理等其他入口中无法复用。
Controller 最终应该有多薄
理想的 Controller 只完成四件事:接收请求、做协议级校验、转换为应用层输入、把应用服务结果映射为 HTTP 响应。它不应该知道订单聚合内部怎样生成订单项,也不应该知道仓储最终使用 JPA、MyBatis 还是远程服务。
当边界保持清晰后,同一个 CreateOrderCommand 可以来自 HTTP、消息队列或测试代码,应用层仍然按同一用例执行。这正是“请求从哪里开始”的关键:请求从接口层进入,但业务流程从应用层输入开始。