COLA

COLA 项目介绍

项目背景

COLA 是 Clean Object-Oriented and Layered Architecture 的缩写，中文名为“整洁面向对象分层架构”。该项目旨在为开发者提供一套清晰且高效的应用架构，帮助解决复杂业务系统中的混乱问题。COLA 架构已有多个版本，目前已发展至 COLA v5。

COLA 架构

COLA 概述

架构的核心在于要素和结构，即组成架构的重要元素及其相互关系。一个好的应用架构应当能够治理应用的复杂性，降低系统的熵值，从而使得应用从混乱走向有序。COLA 架构正是为此而生，其核心任务是定义良好的应用结构，提供最佳实践。

COLA 模式

COLA 架构与其他架构（如六边形架构、洋葱圈架构、整洁架构）一样，强调以业务为核心，解耦外部依赖，区分业务复杂度和技术复杂度。COLA 提供了实用的工具和实践指南，帮助开发者快速构建满足其架构理念的应用程序。

为此，COLA 提供了两种模板（archetype）：

cola-archetype-service：用于创建纯后端服务。
cola-archetype-web：用于创建包含适配器和后端服务的 Web 应用。

COLA 组件

COLA 项目还包括一组通用组件，旨在提高开发效率。这些组件包括：

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

如何使用 COLA

创建应用

用户可以通过执行命令行指令来创建新的应用程序，COLA 提供了简单的命令行支持以快速构建应用。

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=5.0.0

运行应用

在应用创建成功后，用户可以在项目目录下执行 mvn install 进行编译构建，随后进入 start 目录执行 mvn spring-boot:run 运行应用。应用启动后，可以通过浏览器访问 http://localhost:8080/helloworld 测试简单的 REST 请求。