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

Domain 包里应该放哪些类

Domain 包里应该放哪些类

domain 包不是“除 Controller 以外的业务代码收纳箱”,而是承载领域模型及其规则的核心区域。本课把 aggregate、entity、valueobject、service、repository、event 六类常见代码放回各自职责中,并说明哪些技术类不应进入 Domain。

学习目标

  • 能区分聚合、实体、值对象、领域服务、仓储接口和领域事件的职责
  • 能判断一个类应该进入 domain,还是留在 application 或 infrastructure
  • 能避免把持久化实现、框架注解和外部系统客户端混入领域模型

Domain 的判断标准

判断一个类是否属于 domain,先问它是否表达业务概念、业务约束或领域协作。如果删掉 Spring、数据库和消息中间件后,这段代码仍然有意义,它通常更接近领域层;如果它主要解决 SQL、HTTP、序列化或框架接入问题,就更可能属于基础设施层。

因此,Order、Money、OrderRepository 这样的名字可以进入领域层,但 OrderJpaRepository、OrderMapper.xml、KafkaOrderPublisher 这类实现技术细节的代码不应放进去。

Domain 包常见类型与关系

常见子包分别负责什么

aggregate 用来放聚合根以及与聚合边界直接相关的对象。聚合根负责维护一致性规则,外部代码应通过它修改聚合内部状态,而不是绕过它直接改内部实体。

entity 放具有持续身份的领域对象;valueobject 放由属性值定义、通常不可变的对象,例如金额、地址、订单项快照。若一个实体只在某个聚合内部有意义,也可以和聚合放得更近,不必机械地把所有实体集中到全局 entity 包。

service 放无法自然归属于某个实体或值对象的领域规则,例如需要同时比较多个聚合或执行领域计算的无状态服务。应用服务负责“先做什么、后做什么”,领域服务负责“业务规则本身怎么判断”。

repository 在领域层通常只放接口,表达领域需要怎样取回或保存聚合;具体的 JPA、MyBatis、MongoDB 实现放到 infrastructure。event 则存放已经发生的领域事实,例如 OrderCancelled,用于解耦聚合与后续处理逻辑。

仓储接口应该保持领域语言

下面是片段示例,假设 Order 聚合和 OrderId 值对象已经存在。它展示的是领域层接口的形状,不包含数据库实现,因此不能作为独立程序运行。

java
package com.example.order.domain.repository;

import com.example.order.domain.aggregate.Order;
import com.example.order.domain.valueobject.OrderId;

import java.util.Optional;

public interface OrderRepository {
    Optional<Order> findById(OrderId orderId);

    void save(Order order);
}

这个接口只表达“按订单标识查找聚合”和“保存聚合”两个领域需求,没有 EntityManager、SQL、Mapper 或 Spring Data 的实现细节。基础设施层可以用 JPA、MyBatis 或其他技术实现它,而应用层只依赖这个领域接口。

不应该放进 Domain 的代码

Controller、请求 DTO、事务编排通常属于接口层或应用层;数据库实体映射、Repository 实现、MQ Producer、Redis 客户端和第三方 SDK 适配器属于基础设施层。把这些类混入 domain 会让领域模型被框架生命周期和技术约束牵着走。

最终判断标准应始终回到职责:Domain 保存业务规则和领域抽象,Application 组织用例,Infrastructure 处理技术实现。只要这条边界清楚,具体子包名称可以根据项目规模适度调整。

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

目录与阅读设置

阅读设置

17

记录一个想法

Domain 包里应该放哪些类

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

登录哪都通