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

领域实体只有 Getter Setter 有什么问题

领域实体只有 Getter Setter 有什么问题

当领域实体只保存字段并暴露 Getter、Setter 时,真正的业务规则通常会被挤到 Service、Controller 甚至脚本里。短期看写得快,长期却很难保证“任何入口都只能产生合法状态”。本节用订单取消规则说明如何把状态变化重新收回实体。

学习目标

  • 识别只有 Getter、Setter 的贫血领域模型及其风险
  • 理解实体为什么应该保护自身不变量和状态转换
  • 能把外部直接改字段改造成有业务含义的方法

问题不在 Getter Setter 本身

Getter、Setter 并非天然错误。真正的问题是:业务状态只能通过无约束 Setter 改写,而实体自己不判断是否合法。

例如订单规定“已发货不能取消”。如果实体只有 setStatus(),调用方就可以在任何地方写入 CANCELLED。于是业务规则只能靠调用者自觉遵守。Web 接口做了一次校验,不代表定时任务、消息消费者和后台管理接口也会做同样校验。

这会产生两个直接后果:规则散落在多个应用入口里,修改规则时容易漏改;实体可以处于业务上不可能存在的状态,错误往往直到保存数据库或后续处理时才暴露。

看一次非法状态是怎样产生的

下面的完整 Java 示例同时演示贫血实体和把规则收回实体后的差异。

java
public class OrderDomainDemo {
    enum Status {
        PAID, SHIPPED, CANCELLED
    }

    static class AnemicOrder {
        private Status status;

        AnemicOrder(Status status) {
            this.status = status;
        }

        Status getStatus() {
            return status;
        }

        void setStatus(Status status) {
            this.status = status;
        }
    }

    static class Order {
        private Status status;

        Order(Status status) {
            this.status = status;
        }

        Status getStatus() {
            return status;
        }

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

    public static void main(String[] args) {
        AnemicOrder anemic = new AnemicOrder(Status.SHIPPED);
        anemic.setStatus(Status.CANCELLED);
        System.out.println("anemic=" + anemic.getStatus());

        Order rich = new Order(Status.SHIPPED);
        try {
            rich.cancel();
        } catch (IllegalStateException e) {
            System.out.println("rich=" + e.getMessage());
        }
    }
}

预期输出

text
anemic=CANCELLED
rich=shipped order cannot be cancelled

第一条输出说明:Setter 只负责赋值,它不知道 SHIPPED -> CANCELLED 是否符合业务。第二个实体则把“取消订单”建模成 cancel(),调用者表达的是业务意图,而不是指定最终字段值。

实体要保护的是不变量

DDD 中更重要的不是“把方法放进实体”,而是让实体在任何公开操作完成后仍满足必须成立的业务约束,也就是不变量。

例如订单可以要求:已发货不能取消、已取消不能再次支付、金额不能为负数。这样的规则应尽量靠实体的构造方法和业务方法统一保护,而不是由每个调用方重复判断。

因此,重构贫血实体时通常可以按这个顺序处理:

  1. 找出外部代码直接修改的关键业务字段。
  2. 为合法变化命名,例如 cancel()、confirmPayment()、changeShippingAddress()。
  3. 把状态检查和必要计算移动到这些方法内部。
  4. 缩小关键 Setter 的可见性,或直接删除它们。
  5. 让应用层负责组织流程,而不是替实体决定内部状态。

哪些逻辑不该硬塞进实体

实体适合处理依赖自身状态即可判断的规则。如果一个操作需要调用外部支付网关、查询其他聚合、发送消息或管理事务,它通常不应直接在实体里完成。

例如“订单能否取消”的状态规则可以放在实体中;“取消后退款并发送通知”的流程更适合由应用服务协调。这样既能保证实体状态合法,又不会让领域对象依赖数据库、HTTP 客户端或消息中间件。

判断贫血模型最实用的问题不是“这个类有几个方法”,而是:绕过这些业务方法,调用者还能否轻易制造非法状态。如果答案是能,就应该优先把关键状态变化收回领域实体。

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

目录与阅读设置

阅读设置

17

记录一个想法

领域实体只有 Getter Setter 有什么问题

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

登录哪都通