ddd中抽象实体基类通过模板方法封装生命周期管理，定义受保护状态字段与transitionto方法控制状态流转，提供oncreated/onloaded/onmodified/ondeleting等钩子供子类按需实现，并由仓储在save/find等操作中透明触发。

在领域驱动设计（DDD）中，抽象实体基类常用于统一管理实体的生命周期行为（如创建、加载、修改、删除前后的钩子）。Java 中可通过抽象类 + 模板方法模式 + 受保护的钩子方法来实现，既保持领域语义清晰，又避免强制子类重复实现通用逻辑。

定义抽象实体基类并封装生命周期状态

实体基类应继承 java.lang.Object，不依赖框架（如 JPA），但预留扩展点。使用受保护的 final 字段或枚举记录内部状态（如 PENDING、LOADED、DELETED），避免子类误改；状态变更通过受保护的模板方法控制：

• 定义 protected EntityState state = EntityState.PENDING;
• 提供 protected final void transitionTo(EntityState target) 封装状态校验与变更
• 子类不可直接赋值 state，只能通过受控方法流转

声明受保护的生命周期钩子方法

每个关键生命周期节点定义一个空的 protected void onXXX() 方法，不加默认实现（由子类按需重写），不暴露给外部调用：

• onCreated()：实体完成构造、属性初始化后触发（非构造器内调用）
• onLoaded()：从仓储加载成功后触发（含数据库/缓存还原）
• onModified()：检测到属性变更（可配合 dirty-check 或 setter 拦截）
• onDeleting()：仓储执行删除前，允许子类拒绝或预处理（如级联软删）

钩子方法不抛受检异常，避免强耦合异常处理策略；若需错误反馈，返回布尔值或抛运行时异常（如 IllegalStateException）。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

用模板方法统一流程入口

将生命周期动作封装为 public final 方法，内部调用钩子 + 状态流转，确保子类无法绕过约束：

• public final void markAsDeleted() { onDeleting(); transitionTo(EntityState.DELETED); }
• public final void reloadFromStore() { onLoaded(); transitionTo(EntityState.LOADED); }
• 构造完成后自动触发 onCreated()（可在构造器末尾或工厂方法中调用）

注意：不要在构造器中调用可被重写的方法（违反 Java 安全规范），推荐使用静态工厂方法或构建器模式完成实例化后统一调用 onCreated()。

与仓储协同实现钩子注入

仓储（Repository）是触发钩子的关键协调者。例如：

• userRepository.save(user) 在持久化前调用 user.onModified()
• userRepository.findById(id) 加载数据后立即调用 user.onLoaded()
• 钩子调用发生在仓储内部，对应用层透明，符合 DDD 分层隔离原则

避免在实体内部直接调用仓储或基础设施代码——钩子只负责领域逻辑响应，不承担技术细节。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南