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

Application 包里应该放什么

Application 包里应该放什么

Application 包承接“一个用例如何完成”,负责接收输入、调用领域对象与端口、组织事务边界,并把结果整理成对外可用的数据。它不是领域规则的归宿,也不应该直接依赖数据库、消息中间件或 HTTP 客户端实现。本篇给出一套适合 Spring Boot 项目的应用层目录划分方法。

学习目标

  • 区分应用服务、命令、查询和应用层 DTO 的职责
  • 设计不会把领域逻辑和技术实现混入 Application 包的目录结构
  • 判断一个新类应该进入 Application、Domain 还是 Infrastructure

先把 Application 定义成“用例层”

应用层最稳定的划分单位不是技术组件,而是业务用例。比如“创建订单”“取消订单”“查询订单详情”都属于应用层关注的问题。Application Service 负责把这些步骤串起来:校验输入形态、加载聚合、调用领域行为、保存结果、发布必要的应用事件或返回 DTO。

真正决定“折扣怎么算”“订单何时允许取消”的规则仍应留在领域层。JPA、Kafka、Redis、第三方 HTTP SDK 等技术细节则留给 Infrastructure。这样应用层只描述业务流程,不描述技术实现。

按职责拆成四类对象

一个实用的 Application 包可以围绕以下四类对象组织:

对象 主要职责 不应该做什么
Application Service 编排一个用例,控制调用顺序 编写复杂领域规则、拼 SQL
Command 表达“要执行什么动作”的输入 承载持久化实现、返回查询视图
Query 表达“要读取什么数据”的输入 修改聚合状态
DTO 表达应用层输入或输出数据 直接充当领域实体

如果项目规模较小,可以先按职责分包,例如 application.service、application.command、application.query、application.dto。当用例持续增多时,更推荐按业务用例再细分,如 application.order.create、application.order.cancel,避免一个 service 包最终堆出几十个互不相关的类。

应用服务只做编排

下面是片段示例,依赖上下文中的 OrderRepository、Order 和 OrderId。重点不是具体框架注解,而是观察应用层只负责“取数据、调用领域行为、保存结果”。

java
package com.example.order.application.cancel;

public final class CancelOrderApplicationService {

    private final OrderRepository orderRepository;

    public CancelOrderApplicationService(OrderRepository orderRepository) {
        this.orderRepository = orderRepository;
    }

    public CancelOrderResult handle(CancelOrderCommand command) {
        Order order = orderRepository.findById(new OrderId(command.orderId()))
                .orElseThrow(() -> new IllegalArgumentException("order not found"));

        // 是否允许取消由领域对象自己判断,应用服务只负责组织步骤。
        order.cancel(command.reason());
        orderRepository.save(order);

        return new CancelOrderResult(order.id().value(), order.status().name());
    }
}

record CancelOrderCommand(String orderId, String reason) {
}

record CancelOrderResult(String orderId, String status) {
}

验证这段结构时,可以检查三个方向:handle 中没有 SQL、HTTP 或 Kafka 调用;取消规则封装在 Order.cancel;仓储通过接口依赖注入,而不是在应用层实例化具体数据库实现。满足这三点,应用层通常就保持了清晰边界。

Command、Query 与 DTO 不要混成一个万能对象

Command 表达意图,通常与写操作一一对应;Query 表达读取条件;DTO 则用于跨层传递数据。三者字段偶尔相同,也不代表应该合并成一个对象。分开后,字段变化的原因更清楚:命令因用例变化,查询因读取需求变化,DTO 因接口展示变化。

对于简单 CRUD,不必为了形式制造大量空壳类型;但只要写入流程开始出现权限、状态转换、事务或多个聚合协作,独立 Command 和 Application Service 会明显降低耦合。查询如果完全不需要加载聚合,也可以通过专门的查询端口直接读取投影数据,不必强行走领域模型。

用“变化原因”判断类该放哪里

遇到新类时,可以直接问它为什么会变化:因为业务规则变化而变,放 Domain;因为用例步骤变化而变,放 Application;因为数据库、消息系统或第三方协议变化而变,放 Infrastructure;因为 Web 接口协议变化而变,通常放接口适配层。

Application 包的目标不是“装所有业务代码”,而是让每个用例的输入、编排和输出都能被快速定位。只要坚持以用例为中心、让领域规则下沉、让技术细节外移,目录会随着功能增加而扩展,而不是变成新的杂物间。

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

目录与阅读设置

阅读设置

17

记录一个想法

Application 包里应该放什么

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

登录哪都通