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

接口层到底负责什么

接口层到底负责什么

接口层解决的是“外部世界如何调用系统”的问题。它接收 HTTP、消息或命令行等外部输入,把协议数据转换成应用层能够理解的请求,再把执行结果转换成外部响应,但不应该决定订单能否取消、折扣如何计算这类核心业务规则。

学习目标

  • 说清接口层在一次请求链路中的职责边界
  • 区分协议转换、输入校验与业务规则
  • 能把外部请求转换为应用层命令并组装响应

把外部协议翻译成应用输入

接口层处在系统内部模型与外部协议之间。以 HTTP 接口为例,它通常负责读取路径参数、查询参数、请求体和认证上下文,并将字符串、JSON 等协议数据转换成应用层需要的类型。

完成调用后,接口层还要把应用层返回的数据转换成 HTTP 状态码、响应 DTO 或错误结构。因此,接口层可以知道 HTTP、JSON、Header 等概念,而领域层通常不应该知道这些协议细节。

接口层在外部协议与应用层之间的请求响应转换链路

图中的关键不是调用方向本身,而是模型转换发生在哪里:外部协议模型在接口层结束,应用层从命令或查询对象开始,领域对象不需要直接暴露给客户端。

一个最小的接口层示例

下面用纯 Java 模拟一个创建订单入口。Controller 只检查必填字段和数字格式,再完成 Request DTO 到应用命令的转换;订单数量是否符合业务限制并不在这里判断。

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

预期输出

text
201 Created: orderId=ORD-1001

实际使用 Spring MVC、Jakarta REST 等框架时,框架会负责 HTTP 路由和序列化,但职责划分不变:Controller 结束于协议适配和应用用例调用,不继续向领域规则内部延伸。

哪些逻辑不属于接口层

判断一段代码是否越界,可以看它是否表达了业务事实。诸如“已发货订单不能取消”“VIP 客户享受特定折扣”“库存不足不得创建订单”即使只有一行,也属于业务规则,不应该因为最先在 Controller 中拿到数据就写在那里。

接口层适合处理的内容包括请求字段是否缺失、字符串能否转换为数字、协议版本是否受支持以及应用异常如何映射为响应。需要跨协议保持一致的业务判断,则应该进入应用层或领域层。

用变化原因判断归属

一个实用判断方法是观察代码因为什么变化而修改。因为 HTTP 状态码、JSON 字段名或消息格式变化而修改的代码,通常属于接口层;因为业务政策、订单状态或计价规则变化而修改的代码,则通常不属于接口层。

这样划分后,同一个应用用例可以同时被 REST API、消息消费者和定时任务调用。外部协议可以变化,核心业务规则仍保持稳定,这正是接口层存在的主要价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

接口层到底负责什么

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

登录哪都通