MyGit
🚩收到GitHub仓库的更新通知

alibaba/COLA

Fork: 2944 Star: 11270 (更新于 2024-05-06 19:08:39)

license: LGPL-2.1

Language: Java .

🥤 COLA: Clean Object-oriented & Layered Architecture

最后发布版本: COLA4.3.2 ( 2023-05-11 19:32:15)

GitHub网址

✨免费申请网站SSL证书,支持多域名和泛域名,点击查看

🥤 COLA v4

Fast CI Multiply Java versions CI License Java support Maven Central GitHub Releases GitHub Stars GitHub Forks user repos GitHub issues GitHub Contributors gitpod: Ready to Code

COLA 是 Clean Object-Oriented and Layered Architecture的缩写,代表“整洁面向对象分层架构”。 目前COLA已经发展到COLA v4

COLA分为两个部分,COLA架构和COLA组件。

一、COLA架构

COLA 概述

架构意义 就是 要素结构:

  • 要素 是 组成架构的重要元素;
  • 结构 是 要素之间的关系。

应用架构意义 就在于

  • 定义一套良好的结构;
  • 治理应用复杂度,降低系统熵值;
  • 从随心所欲的混乱状态,走向井井有条的有序状态。

arch why

COLA架构就是为此而生,其核心职责就是定义良好的应用结构,提供最佳应用架构的最佳实践。通过不断探索,我们发现良好的分层结构,良好的包结构定义,可以帮助我们治理混乱不堪的业务应用系统。

cure

经过多次迭代,我们定义出了相对稳定、可靠的应用架构:COLA v4

cola arch

COLA Archetypes

好的应用架构,都遵循一些共同模式,不管是六边形架构、洋葱圈架构、整洁架构、还是COLA架构,都提倡以业务为核心,解耦外部依赖,分离业务复杂度和技术复杂度等

COLA架构区别于这些架构的地方,在于除了思想之外,我们还提供了可落地的工具和实践指导。

为了能够快速创建满足COLA架构的应用,我们提供了两个archetype,位于cola-archetypes目录下:

  1. cola-archetype-service:用来创建纯后端服务的archetype
  2. cola-archetype-web:用来创建adapter和后端服务一体的web应用archetype

二、COLA组件

此外,我们还提供了一些非常有用的通用组件,这些组件可以帮助我们提升研发效率。

这些功能组件被收拢在cola-components目录下面。到目前为止,我们已经沉淀了以下组件:

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

三、如何使用COLA

1. 创建应用

执行以下命令:

mvn archetype:generate \
    -DgroupId=com.alibaba.cola.demo.web \
    -DartifactId=demo-web \
    -Dversion=1.0.0-SNAPSHOT \
    -Dpackage=com.alibaba.demo \
    -DarchetypeArtifactId=cola-framework-archetype-web \
    -DarchetypeGroupId=com.alibaba.cola \
    -DarchetypeVersion=4.3.2

命令执行成功的话,会看到如下的应用代码结构:

demo struture

2. 运行应用

  • 项目目录下运行mvn install(如果不想运行测试,可以加上-DskipTests参数)。
  • 进入start目录,执行mvn spring-boot:run
    运行成功的话,可以看到SpringBoot启动成功的界面。
  • 生成的应用中,已经实现了一个简单的Rest请求,可以在浏览器中输入 http://localhost:8080/helloworld 进行测试。

如果要生成不是web工程而是service工程也类似,执行的是下面的命令:

mvn archetype:generate \
    -DgroupId=com.alibaba.cola.demo.service \
    -DartifactId=demo-service \
    -Dversion=1.0.0-SNAPSHOT \
    -Dpackage=com.alibaba.demo \
    -DarchetypeArtifactId=cola-framework-archetype-service \
    -DarchetypeGroupId=com.alibaba.cola \
    -DarchetypeVersion=4.3.2

版本迭代

4.0.0 版本

https://blog.csdn.net/significantfrank/article/details/110934799

3.1.0 版本

https://blog.csdn.net/significantfrank/article/details/109529311

  1. 进一步简化了cola-core,只保留了扩展能力。
  2. exceptioncola-core移入到cola-common
  3. archetype中的分包逻辑进行重构,改成按照domain做划分。
  4. cola-archetype-web中的controller改名为adapter,为了呼应六边形架构的命名。

3.0.0 版本

https://blog.csdn.net/significantfrank/article/details/106976804

2.0.0 版本

https://blog.csdn.net/significantfrank/article/details/100074716

1.0.0 版本

https://blog.csdn.net/significantfrank/article/details/85785565

最近版本更新:(数据更新于 2024-04-25 23:33:04)

2023-05-11 19:32:15 COLA4.3.2

2022-08-02 16:43:41 COLA4.3.1

2022-07-31 14:04:14 COLA4.3.0

2022-07-20 13:49:48 COLA4.2.2

2022-07-15 19:58:32 COLA4.2.1

2022-07-15 19:55:32 COLA4.2.0

2022-01-31 01:37:31 COLA4.1.0

2021-01-10 20:28:44 COLA4.0.1

2021-01-05 18:02:07 COLA4.0.0

2020-12-09 11:29:10 COLA3.1

主题(topics):

architecture, clean, cola

alibaba/COLA同语言 Java最近更新仓库

2024-05-14 17:46:49 elastic/elasticsearch

2024-05-13 10:00:26 TongchengOpenSource/smart-doc-gradle-plugin

2024-05-13 09:57:13 TongchengOpenSource/smart-doc

2024-05-12 16:05:29 dromara/Sa-Token

2024-05-11 22:41:27 dromara/dante-cloud

2024-05-10 09:31:57 mybatis-flex/mybatis-flex