【架构设计】阿里开源架构Cola4.0的项目实践：订单系统

项目介绍

使用SpringBoot+MybaitsPlus+Cola（整洁面向对象分层架构）4.0重构订单功能

项目地址

Gitee：https://gitee.com/charles_ruan/smile-cola

Github：https://github.com/charles0719/smile-cola

项目核心API

• 新增

POST http://localhost:8080/order/add

{
    "orderInfo": "订单1号1112",
    "orderNo": "111211",
    "description": "我是一个订单"
}

• 修改

POST http://localhost:8080/order/edit

{
    "id": "1",
    "orderInfo": "订单1号1112",
    "orderNo": "111211",
    "description": "我是一个订单"
}

• 访问详情

GET http://localhost:8080/order/1

• 分页查询

POST http://localhost:8080/order/page

{
    "pageSize": 10,
    "pageIndex": 1
}

Cola架构介绍

核心组件

交互过程

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-UEXDAnov-1684299282884)(assets/README/cola-交互.png)]

COLA 规范

规范	用途	解释
xxxCO	Client Object	客户对象，用于传输数据，等同于DTO
xxxCmd	Client Request	Cmd代表Command，表示一个写请求
xxxQuery	Client Request	Query，表示一个读请求
xxxCmdExe	Command Executor	命令模式，每一个写请求对应一个执行器
xxxQueryExe	Query Executor	命令模式，每一个读请求对应一个执行器
xxxVO	Value Object	值对象
xxxEntity	Entity	领域实体
xxxDO	Data Object	数据对象，用于持久化
xxxInterceptor	Command Interceptor	拦截器，用于处理切面逻辑
IxxxService	API Service	xxxServiceI 不太习惯，就把 I 放在前边吧
xxxDomainService	Domain Service	需要多个领域对象协作时，使用DomainService
xxxValidator	Validator	校验器，用于校验的类
xxxAssembler	Assembler	组装器，DTO <—> Entity，用于Application层
xxxConvertor	Convertor	转化器，Entity <—> DO，用于Infrastructure层

模块规范

使用COLA

COLA 开源地址： https://github.com/alibaba/COLA

安装 cola archetype
下载cola-archetypes下的源码到本地，然后本地运行mvn install安装。

安装 cola components
下载cola-components下的源码到本地，然后本地运行mvn install安装。

创建应用

mvn archetype:generate  -DgroupId=com.charles -DartifactId=smile -Dversion=1.0.0-SNAPSHOT -Dpackage=com.charles.smile -DarchetypeArtifactId=cola-framework-archetype-web -DarchetypeGroupId=com.alibaba.cola -DarchetypeVersion=4.0.0 -DarchetypeCatalog=internal

参考

• https://github.com/alibaba/COLA
• https://github.com/AmosWang0626/think-cola
• https://gitee.com/j3code/lucky-draw-v1
• 复杂度应对之道 - COLA应用架构
• COLA 4.0：应用架构的最佳实践