[arch] 整洁架构-COLA

[Alice52]

• client: 独立(只需要依赖组件)
• domain: 独立
• infrastructure: 实现domain(可以使用 client)
• app: 实现client | 依赖 infrastructure->domain
• adapter: 使用 app -> app

[Alice52]

COLA架构: 框架(提升应用质量)

层次	包名	功能	extra	必选
Adapter 层(VO/DTO)	openapi	封装 http, rpc 接口		否
	controller	处理 http 请求	浏览器	否
	scheduler	处理定时任务	定时任务	否
	consumer	处理外部 message	消息	否
App 层(DTO)	executor	处理 request, 包括 command 和 query		是
	service	与 domain 交互负责编排任务		是
Domain 层(Entity)	gateway	领域网关, 解耦利器	粗略的理解成一种SPI	是
	model	领域模型		否
	ability	领域能力, DomainManager	领域对外暴露的服务能力	否
Infra 层(DO)	gatewayimpl	网关实现		是
	mapper	ibatis 数据库映射		否
	config	配置信息		否
Driven adapter	db	数据库		否
	search	搜索引擎		否
	rpc	外部接口		否
Client SDK	api	服务对外透出的 API		是
	dto	服务对外的 DTO		是

COLA组件: 框架功能(可复用组件 + 提升研发效率)

组件名称	功能	依赖
cola-component-catchlog-starter	异常处理和日志组件	exception、dto 组件
cola-component-domain-starter	Spring 托管的领域实体组件	无
cola-component-dto	定义了 DTO 格式, 包括分页	无
cola-component-exception	定义了异常格式, 主要有 BizException 和 SysException
cola-component-extension-starter	扩展点组件	无
cola-component-statemachine	状态机组件	无
cola-component-test-container	测试容器组件	无

[Alice52]

相关细节

1. 包的划分: 综合考虑功能和领域两个维度包结构定义
   

   

2. 防腐层: Anti-Corruption

   • ddd的概念: 应用不要直接依赖外域的信息，要把外域的信息转换成自己领域上下文（Context）的实体再去使用，从而实现本域和外部依赖的解耦

   • 在 COLA 中将数据库等都泛化为外部依赖, 利用依赖倒置(变成了不直接依赖数据库等-依赖数据库的抽象), 统一使用gateway来实现业务领域和外部依赖的解耦: Domain层定义Gateway + Infrastructure提供实现

     
     

     • pros: 降低了对外域信息依赖的耦合
     • pros: 是通过上下文映射, 确保本领域边界上下文下领域知识的完整性，实现了统一语言

[Alice52]

client - app - adaptor

1. client 定义接口(类似与openapi定义|类似于app实现的接口)

   interface CustomerServiceI {
     listByName();
   }

2. app实现接口

   @Service
   public class CustomerServiceImpl implements CustomerServiceI {
       @Resource private CustomerListByNameQryExe customerListByNameQryExe;
       @Override
       public MultiResponse<CustomerDTO> listByName(CustomerListByNameQry customerListByNameQry) {
           return customerListByNameQryExe.execute(customerListByNameQry);
       }
   }

3. adaptor 调用 client 接口提供controller/openapi等服务

   @RestController
   public class CustomerController {
       @Autowired private CustomerServiceI customerService;
       @GetMapping(value = "/customer")
       public MultiResponse<CustomerDTO> listCustomerByName(@RequestParam(required = false) String name){
           CustomerListByNameQry customerListByNameQry = new CustomerListByNameQry();
           customerListByNameQry.setName(name);
           return customerService.listByName(customerListByNameQry);
       }
   }