Skip to content

单体常规规范

「单体常规」是 Structure 生态的历史默认形态,采用 4 模块 + Manager 模式,适合小型工具、内部服务和管理后台。

1. 模块结构

structure-{X}/
├── structure-{X}-api/                 # 控制层(controller/ + 启动类)
├── structure-{X}-biz/                 # 业务层(service/ + manager/ + mapper/ + entity/ + assembler/ + config/)
├── structure-{X}-common/              # 公共层(dto/ + vo/ + query/ + enums/ + exception/ + constant/)
└── structure-{X}-dependencies/        # 父 POM
模块职责
*-api控制层,处理 HTTP 请求
*-biz业务逻辑层(含 Manager 数据管理层)
*-common公共组件(DTO / VO / Query / 枚举 / 异常 / 常量)
*-dependenciesMaven 依赖管理

2. Manager 模式(持久化)

单体形态使用 Manager 模式,不套用 DDD 的 RepositoryFacade / Delegate

java
public interface IExampleManager extends IService<Example> {
}

@Service
@RequiredArgsConstructor
public class ExampleManagerImpl extends ServiceImpl<ExampleMapper, Example> implements IExampleManager {
}
  • Entity 直接使用 @TableId / @TableField / @TableLogic 注解,不分离 Entity/PO
  • Entity 兼做领域对象。
  • Service 通过 I{X}Manager 完成数据访问,禁止直接注入 Mapper。

3. CRUD 模板

控制器 / 服务 / Manager / Mapper / Entity / Assembler / 枚举的完整代码模板见 CRUD 代码模板规范

4. 必须遵守的通用规范

单体形态仍需遵守所有通用规范

5. 适用场景与限制

  • 适用:小型工具、内部服务、管理后台。
  • 不适用:多业务领域、长期演进、需要拆微服务的场景 → 请选用 分布式多模块 DDD 7+1

6. 相关页面