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

一个应用服务方法应该对应什么

一个应用服务方法应该对应什么

应用服务的方法最好对应一次可被业务人员说清楚的“用例动作”,例如创建订单、取消订单、确认支付,而不是简单映射数据表的增删改查。这样方法名、事务边界和权限校验都能围绕同一个业务意图组织。

学习目标

  • 判断一个应用服务方法是否真正表达了独立业务用例
  • 区分应用层编排与领域对象中的业务规则
  • 用命令对象和清晰方法名组织创建、取消等业务动作

方法名先表达业务意图

应用服务面对的是调用者要完成的事情,因此命名应优先来自用例,而不是持久化动作。createOrder、cancelOrder 能直接对应用户或外部系统发起的业务请求;insertOrder、updateOrderStatus 则泄露了数据库视角。

判断粒度时可以问一个问题:调用者是否会把它当成一次完整请求发起? 如果答案是肯定的,它通常适合作为一个应用服务方法。一次“取消订单”内部可能需要读取订单、验证状态、记录取消原因并保存,但这些步骤仍属于同一个业务动作。

应用服务负责组织,领域对象负责决定

应用层的职责是接收输入、加载所需对象、调用领域行为、保存结果,并协调权限、事务或外部端口。真正决定“当前订单能不能取消”的规则,应放在订单聚合中,而不是堆进应用服务的 if 语句。

应用服务方法对应业务用例的数据流

下面的可运行 Java 示例用内存仓库演示应用服务如何只负责组织流程,而把取消规则交给 Order。

java
import java.util.HashMap;
import java.util.Map;

public class ApplicationServiceDemo {
    enum Status { CREATED, CANCELLED }

    static final class Order {
        private final String id;
        private Status status = Status.CREATED;

        Order(String id) {
            this.id = id;
        }

        void cancel() {
            if (status != Status.CREATED) {
                throw new IllegalStateException("order cannot be cancelled");
            }
            status = Status.CANCELLED;
        }

        String id() {
            return id;
        }

        Status status() {
            return status;
        }
    }

    interface OrderRepository {
        Order findById(String id);
        void save(Order order);
    }

    static final class InMemoryOrderRepository implements OrderRepository {
        private final Map<String, Order> data = new HashMap<>();

        @Override
        public Order findById(String id) {
            Order order = data.get(id);
            if (order == null) {
                throw new IllegalArgumentException("order not found: " + id);
            }
            return order;
        }

        @Override
        public void save(Order order) {
            data.put(order.id(), order);
        }
    }

    static final class OrderApplicationService {
        private final OrderRepository repository;

        OrderApplicationService(OrderRepository repository) {
            this.repository = repository;
        }

        void createOrder(String orderId) {
            repository.save(new Order(orderId));
        }

        void cancelOrder(String orderId) {
            Order order = repository.findById(orderId);
            order.cancel(); // 应用层发起领域行为,不复制取消规则
            repository.save(order);
        }
    }

    public static void main(String[] args) {
        InMemoryOrderRepository repository = new InMemoryOrderRepository();
        OrderApplicationService service = new OrderApplicationService(repository);

        service.createOrder("O-1001");
        service.cancelOrder("O-1001");

        System.out.println(repository.findById("O-1001").status());
    }
}

预期输出

text
CANCELLED

这个例子中,cancelOrder 本身没有判断订单状态是否合法。它只完成“找到订单 → 执行取消 → 保存结果”的编排,规则仍由 Order.cancel() 维护。

不要把方法拆成数据操作

如果一个应用服务暴露 loadOrder、setStatus、saveOrder 三个公开方法,再让调用方自己拼出“取消订单”,业务边界就被推给了外部。调用者不仅要知道执行顺序,还可能绕过领域规则。

反过来,也不要把所有订单行为塞进一个 handleOrder 方法,再用大量类型字段分支。这样的入口看似统一,实际会隐藏用例名称,使权限、日志、事务和测试都难以按业务动作区分。

跨多个对象时仍然围绕一个用例

一次业务动作可能需要多个仓库或外部服务。例如“确认支付”可能读取订单、校验支付结果,再推动订单进入已支付状态。此时应用服务可以承担协调,但方法仍应围绕“确认支付”这一意图,而不是按每个技术步骤拆成多个对外方法。

应用服务方法的核心不是“一次只调用一个领域对象”,而是“一次只表达一个清晰用例”。只要入口、结果和失败语义都围绕同一业务目标,内部可以有必要的协调;领域规则则继续留在聚合、领域服务或值对象中。

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

目录与阅读设置

阅读设置

17

记录一个想法

一个应用服务方法应该对应什么

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

登录哪都通