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

复杂查询应该全部放 Repository 吗

复杂查询应该全部放 Repository 吗

Repository 的核心职责不是承接所有数据库查询,而是为领域行为提供聚合的获取与持久化边界。报表、列表、搜索这类读操作往往只需要投影后的数据,如果强行经由聚合加载,会让 Repository 接口膨胀,也增加不必要的对象重建成本。

学习目标

  • 判断一个查询是否应该由 Repository 承担
  • 区分“加载聚合执行业务行为”和“直接读取查询模型”两类需求
  • 为列表、搜索和报表设计独立的读取接口

先看 Repository 要解决的问题

在 DDD 中,Repository 面向的是聚合,而不是表。应用服务需要执行业务行为时,先通过 Repository 取得完整或足够完整的聚合,再调用领域方法,最后保存聚合。

例如“确认订单”需要订单当前状态、订单项和金额规则,这类操作的重点是维护领域不变量。Repository 应提供诸如 findById、save 这样的聚合语义,而不是暴露几十个按页面字段拼接出来的查询方法。

相反,“运营后台搜索最近 30 天待发货订单,并展示客户名、商品数、应付金额”通常只是在读取数据。它不准备修改订单,也不需要构造完整 Order 聚合。此时让 Repository 返回一个为页面定制的 DTO,会逐渐把领域持久化接口变成通用查询中心。

用意图区分两条读取路径

可以用一个简单问题判断:查询结果是否马上用于执行领域行为,并且需要由聚合保护业务规则?

  • 是:优先通过 Repository 加载聚合。
  • 否:如果只是列表、搜索、报表、统计或导出,可以走独立的查询接口,直接返回读模型。
  • 混合场景:先用查询模型筛出候选 ID,再按需要逐个加载聚合执行业务行为。

领域聚合读取与查询模型两条路径

这种拆分并不要求一定采用完整 CQRS。即使仍使用同一个数据库,也可以让写侧 Repository 和读侧 Query Service 使用不同接口,只要职责边界清楚即可。

一个可运行的最小示例

下面的 Java 17 示例同时保留两条路径:OrderRepository 返回聚合,供领域行为使用;OrderQueryService 直接返回页面需要的 OrderRow。示例用内存数据模拟持久化,重点是接口职责而不是数据库框架。

java
import java.util.List;
import java.util.Map;

public class RepositoryQueryDemo {
    record Order(String id, String status, int itemCount, int total) {
        Order confirm() {
            if (!status.equals("PENDING")) {
                throw new IllegalStateException("order is not pending");
            }
            return new Order(id, "CONFIRMED", itemCount, total);
        }
    }

    record OrderRow(String id, String status, int total) {}

    // Repository 面向聚合生命周期,接口保持领域语义。
    interface OrderRepository {
        Order findById(String id);
        void save(Order order);
    }

    // 查询接口直接返回读模型,不要求重建完整聚合。
    interface OrderQueryService {
        List<OrderRow> findPending();
    }

    static final class InMemoryStore implements OrderRepository, OrderQueryService {
        private final Map<String, Order> data = new java.util.HashMap<>();

        InMemoryStore() {
            data.put("O-1001", new Order("O-1001", "PENDING", 2, 199));
            data.put("O-1002", new Order("O-1002", "CONFIRMED", 1, 80));
        }

        public Order findById(String id) {
            return data.get(id);
        }

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

        public List<OrderRow> findPending() {
            // 这里只投影页面真正需要的字段。
            return data.values().stream()
                .filter(order -> order.status().equals("PENDING"))
                .map(order -> new OrderRow(order.id(), order.status(), order.total()))
                .toList();
        }
    }

    public static void main(String[] args) {
        InMemoryStore store = new InMemoryStore();

        System.out.println(store.findPending());

        // 发生状态变更时重新走聚合路径,让领域方法保护规则。
        Order order = store.findById("O-1001");
        store.save(order.confirm());

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

预期输出:

text
[OrderRow[id=O-1001, status=PENDING, total=199]]
CONFIRMED

第一行只是查询页面需要的字段,因此没有重建更多领域结构;第二条路径先取得 Order,再通过 confirm() 执行业务规则并保存。

复杂查询放在哪里更合适

独立查询接口可以位于应用层定义,由基础设施层实现。实现时可以使用 SQL、JPA 投影、MyBatis、查询 DSL 或搜索引擎,但这些技术细节不应反向污染领域模型。

例如,一个订单列表查询需要联结订单、客户和物流表,排序后再分页。只要它的目的只是展示,就没有必要为了“遵守 Repository 模式”先分别加载多个聚合再在内存中拼装。直接查询出 OrderRow 往往更简单,也更容易优化索引与分页。

避免两个常见极端

把所有查询都塞进 Repository,会产生大量 findByXxxAndYyy 方法,让接口围绕页面筛选条件而不是聚合语义增长。反过来,如果所有读取都绕过 Repository,应用层又可能直接拿数据库行执行业务判断,导致领域规则散落在 SQL 和服务代码中。

更稳妥的边界是:Repository 服务于聚合生命周期与领域行为,查询服务服务于读取体验与投影模型。两者可以共享数据库,却不必共享同一种对象模型。

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

目录与阅读设置

阅读设置

17

记录一个想法

复杂查询应该全部放 Repository 吗

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

登录哪都通