架构与系统设计 / 系统课时
接口层到底负责什么
接口层到底负责什么
接口层解决的是“外部世界如何调用系统”的问题。它接收 HTTP、消息或命令行等外部输入,把协议数据转换成应用层能够理解的请求,再把执行结果转换成外部响应,但不应该决定订单能否取消、折扣如何计算这类核心业务规则。
学习目标
- 说清接口层在一次请求链路中的职责边界
- 区分协议转换、输入校验与业务规则
- 能把外部请求转换为应用层命令并组装响应
把外部协议翻译成应用输入
接口层处在系统内部模型与外部协议之间。以 HTTP 接口为例,它通常负责读取路径参数、查询参数、请求体和认证上下文,并将字符串、JSON 等协议数据转换成应用层需要的类型。
完成调用后,接口层还要把应用层返回的数据转换成 HTTP 状态码、响应 DTO 或错误结构。因此,接口层可以知道 HTTP、JSON、Header 等概念,而领域层通常不应该知道这些协议细节。

图中的关键不是调用方向本身,而是模型转换发生在哪里:外部协议模型在接口层结束,应用层从命令或查询对象开始,领域对象不需要直接暴露给客户端。
一个最小的接口层示例
下面用纯 Java 模拟一个创建订单入口。Controller 只检查必填字段和数字格式,再完成 Request DTO 到应用命令的转换;订单数量是否符合业务限制并不在这里判断。
public class CreateOrderControllerDemo {
record CreateOrderRequest(String customerId, String quantity) {}
record CreateOrderCommand(String customerId, int quantity) {}
record CreateOrderResult(String orderId) {}
record ApiResponse(int status, String body) {}
interface CreateOrderUseCase {
CreateOrderResult handle(CreateOrderCommand command);
}
static final class CreateOrderController {
private final CreateOrderUseCase useCase;
CreateOrderController(CreateOrderUseCase useCase) {
this.useCase = useCase;
}
ApiResponse create(CreateOrderRequest request) {
if (request.customerId() == null || request.customerId().isBlank()
|| request.quantity() == null || request.quantity().isBlank()) {
return new ApiResponse(400, "invalid request");
}
final int quantity;
try {
// 接口层负责把协议中的字符串转换为应用层需要的类型。
quantity = Integer.parseInt(request.quantity());
} catch (NumberFormatException e) {
return new ApiResponse(400, "quantity must be an integer");
}
var command = new CreateOrderCommand(request.customerId(), quantity);
var result = useCase.handle(command);
return new ApiResponse(201, "orderId=" + result.orderId());
}
}
public static void main(String[] args) {
CreateOrderUseCase useCase = command -> new CreateOrderResult("ORD-1001");
var controller = new CreateOrderController(useCase);
var response = controller.create(new CreateOrderRequest("C-01", "2"));
System.out.println(response.status() + " Created: " + response.body());
}
}预期输出
201 Created: orderId=ORD-1001实际使用 Spring MVC、Jakarta REST 等框架时,框架会负责 HTTP 路由和序列化,但职责划分不变:Controller 结束于协议适配和应用用例调用,不继续向领域规则内部延伸。
哪些逻辑不属于接口层
判断一段代码是否越界,可以看它是否表达了业务事实。诸如“已发货订单不能取消”“VIP 客户享受特定折扣”“库存不足不得创建订单”即使只有一行,也属于业务规则,不应该因为最先在 Controller 中拿到数据就写在那里。
接口层适合处理的内容包括请求字段是否缺失、字符串能否转换为数字、协议版本是否受支持以及应用异常如何映射为响应。需要跨协议保持一致的业务判断,则应该进入应用层或领域层。
用变化原因判断归属
一个实用判断方法是观察代码因为什么变化而修改。因为 HTTP 状态码、JSON 字段名或消息格式变化而修改的代码,通常属于接口层;因为业务政策、订单状态或计价规则变化而修改的代码,则通常不属于接口层。
这样划分后,同一个应用用例可以同时被 REST API、消息消费者和定时任务调用。外部协议可以变化,核心业务规则仍保持稳定,这正是接口层存在的主要价值。