领域驱动设计(DDD)【9】之代码初始部分实现和问题解决

贫血模型和充血模型

• 贫血模型（Anemic Domain Model）指领域对象中只有数据，没有行为，由于过于单薄，就好像人贫血了一样，显得不太健康。这种风格违背了面向对象的原则。
• 富领域模型（Rich Domain Model）：领域对象里既包含数据，也包含行为。
• 充血模型与富领域模型不同，为避免混淆，把贫血模型称为面向过程或者过程式编程，把富领域模型称为面向对象或对象式编程。
• 面向对象和面向过程的关系图：
  
• 在纯粹的面向对象和纯粹的面向过程之间有一个广阔的“灰色地带”变化非常多，难以穷尽。这两个极端都不是我们要追求的，我们要做的是找到其中的一个平衡点。
• 寻找平衡点的原则：在领域对象不直接或间接访问数据库的前提下，尽量面向对象。

软件开发中的"开卡"和"验卡"

• 开卡(Kick-off)：在正式开始开发一个用户故事或功能前，开发团队与业务代表(如产品负责人、领域专家)进行的确认会议。
• 验卡(Desk Check)：在代码开发完成后但尚未提交正式测试前，开发人员与测试人员或业务代表进行的快速验证。
• 经过讨论，发现之前项目中新增几个业务规则，如同一个组织里，不能有两个同名的下级组织。也就是说，假如“金融开发中心”下面已经有“开发一组”了，那么新加的开发组，不能也叫“开发一组”。

规则编号	模块	规则描述	示例	影响的主要功能
R008	组织管理	对上下级组织的规定： * 开发组上下级只能是研发中心 * 开发组和直层部门没有下级	在企业下增加研发中心A是可以的，但想在企业下直接增加研发组B，则无法做到	组织修改组织
R013	组织管理	企业是在创造中的时候建立好的，因此不能单独创建企业	–	组织修改组织
R014	组织管理	组织必须有组织类别	–	组织修改组织
R015	组织管理	组织类别必须有效	–	组织修改组织
R016	组织管理	组织负责人不可为空，如果有的话，则必须是一个在职员工（含试用期）	创建某组织时，指定了李国庆作为负责人，但在系统中，李国庆已离职，系统提示错误	组织修改组织
R017	组织管理	上级组织必须有效（不能为撤销状态）	–	组织修改组织
R018	组织管理	组织必须有名称	–	组织修改组织
R019	组织管理	同一级组织的下级组织不能重名	“金融研发中心”下已经有了“研发一组”，不允许在该中心下新建一个也叫“研发一组”的研发组	所有操作
R020	组织管理	租户必须有效	–	组织修改组织

• 通过表格分析发现，我们需要在实体中增加状态属性来表达“有效”、“终止”等状态。租户、组织、组织类别、员工、客户、合同、项目等实体中都增加状态，并且在数据库里添加相应的字段。

面向过程代码

• 总体逻辑如上图
  第一步，适配器层里的 OrgController 通过 Restful API 接收到添加组织的请求，请求数据封装在 OrgDto 里。
  第二步，Controller 以 OrgDto 为参数，调用应用层里的 OrgService 服务中的 addOrg() 方法进行处理。
  第三步，OrgService 对参数进行校验，过程中会调用适配器层里的 Repository 来访问数据库。
  第四步，OrgService 创建领域层里的 Org 对象，也就是组织对象。
  第五步，OrgService 调用 OrgRepository 把组织对象存到数据库，并回填组织 id。
  第六步，OrgService 把组织对象装配成 DTO，返回给控制器，控制器再返回给前端。整个过程还是比较直白的，目前主要逻辑都集中在 OrgService 里，也就是第三步到第六步。

• 领域层组织对象类com/yang/system/domain/orgMng/Org.java

@Data
public class Org {private Long id;private Long tenantId;private Long superiorId;private String orgTypeCode;private Long leaderId;private String name;private OrgStatus status;// 使用枚举类型private LocalDateTime createdAt;private Long createdBy;private LocalDateTime lastUpdatedAt;private Long lastUpdatedBy;public Org() {status = OrgStatus.EFFECTIVE;  //组织的初始状态默认为有效}
}

• 应用层组织对象类com/yang/system/application/orgMng/OrgDto.java

@Data
public class OrgDto {private Long id;private Long tenantId;private Long superiorId;private String orgTypeCode;private Long leaderId;private String name;private String status;private LocalDateTime createdAt;private Long createdBy;private LocalDateTime lastUpdatedAt;private Long lastUpdatedBy;
}

• 状态枚举类com/yang/system/domain/orgMng/OrgStatus.java（解决层间依赖后的位置）

public enum OrgStatus {EFFECTIVE("生效中", 1),TERMINATING("终止中", 2);private final String description; // 描述private final int code; // 状态码// 构造函数OrgStatus(String description, int code) {this.description = description;this.code = code;}// 获取描述public String getDescription() {return description;}// 获取状态码public int getCode() {return code;}// 根据状态码获取枚举实例public static OrgStatus getByCode(int code) {for (OrgStatus status : OrgStatus.values()) {if (status.getCode() == code) {return status;}}throw new IllegalArgumentException("Invalid status code: " + code);}@Overridepublic String toString() {return this.description;}}

层间依赖原则和依赖倒置

1. 先查看被动适配器中的组织控制类com/yang/system/adapter/driven/restful/orgMng/OrgController.java

@RestController
public class OrgController {private  final OrgService orgService;@Autowiredpublic OrgController(OrgService orgService) {this.orgService = orgService;}@PostMapping("/api/organizations")public OrgDto addOrg(@RequestBody OrgDto request) {Long userId=request.getTenantId();return orgService.addOrg(request,userId);}
}

2. 再查看应用层的OrgService

@Service
public class OrgService {private final UserRepository userRepository;private final TenantRepository tenantRepository;private final OrgTypeRepositoryJdbc orgTypeRepositoryJdbc;private final OrgRepositoryJdbc orgRepositoryJdbc;private final EmpRepositoryJdbc empRepositoryJdbc;@Autowiredpublic OrgService(UserRepository userRepository,TenantRepository tenantRepository,OrgRepositoryJdbc orgRepositoryJdbc,EmpRepositoryJdbc empRepositoryJdbc,OrgTypeRepositoryJdbc orgTypeRepositoryJdbc) {this.userRepository = userRepository;this.tenantRepository = tenantRepository;this.orgRepositoryJdbc = orgRepositoryJdbc;this.empRepositoryJdbc = empRepositoryJdbc;this.orgTypeRepositoryJdbc = orgTypeRepositoryJdbc;}public OrgDto addOrg(OrgDto request, Long userId) {validate(request,userId);Org org = buildOrg(request, userId);org= orgRepositoryJdbc.save(org);return buildOrgDto(org);}private OrgDto buildOrgDto(Org org) {// 将领域对象的值赋给DTO...if (org == null) {return null;}OrgDto orgDto = new OrgDto();BeanUtils.copyProperties(org, orgDto);orgDto.setStatus(org.getStatus().name());return orgDto;}private Org buildOrg(OrgDto request, Long useId) {// 将DTO的值赋给领域对象...Org org = new Org();BeanUtils.copyProperties(request, org);org.setCreatedBy(useId);return org;}private void validate(OrgDto request, Long userId) {//进行各种业务规则的校验，会用到上面的各个Repository...}
}

问题一：OrgDto违反层间依赖原则（依赖倒置）

• OrgDto是应用服务中addOrg方法的入口参数类型，所以应用层依赖OrgDto，而OrgDto又在适配器层。换言之，应用层依赖适配器层违反了内层不能依赖外层的原则。
• 解决方法：将OrgDto移动到应用层。
  

问题二：Repository的调用违反层间依赖原则

• Repository的调用违反层间依赖原则。仓库放在适配器层，而应用层调用仓库，造成应用层对适配器层的依赖，再一次违反了层间依赖规则。
• 解决方法：
  • 第一步，从仓库抽出一个接口，原来的仓库成为了这个接口的实现类。
  • 第二步，把这个接口移动到领域层。
    
• 仓库接口都按照 XxxRepository 的形式命名。而仓库的实现是在接口名字的后面加上 Jdbc ，在目前的例子里只是用Jdbc 来做持久化。
• OrgRepository接口类的内容如下：

import java.util.Optional;public interface OrgRepository {Org save(Org org);Optional<Org> findByIdAndStatus(long tenantId, Long id,OrgStatus status);int countBySuperiorAndName(long tenantId, Long superiorId, String name);boolean existsBySuperiorAndName(Long tenant, Long superior, String name);
}

• OrgRepositoryJdbc类的实现

@Repository
public class OrgRepositoryJdbc implements OrgRepository {@Overridepublic Org save(Org org) {return null;}@Overridepublic Optional<Org> findByIdAndStatus(long tenantId, Long id, OrgStatus status) {return Optional.empty();}@Overridepublic int countBySuperiorAndName(long tenantId, Long superiorId, String name) {return 0;}@Overridepublic boolean existsBySuperiorAndName(Long tenant, Long superior, String name) {return false;}
}

---

• 解决方法原理分析：从 OrgService 到领域层中仓库接口的三个箭头。它们实际上代表了 OrgService 中用这三个接口定义的属性。由于 OrgService 可以通过属性导航到仓库，而仓库中并没有属性能够导航到 OrgService，所以关联是单向的。
• 通过抽取和移动接口，变成适配器依赖别的层，依赖关系被“倒过来”了。所以这种技巧就称为依赖倒置（dependency inversion），是面向对象设计中常见的调整依赖关系的手段。