Framework
服务端基础设施。独立运行，不依赖 Admin 或 Generate。
coco-framework稳定版 v2.0.3
Coco Framework
Spring Boot 服务端基础设施框架
一个 Starter 接入统一响应、异常处理与 TraceId。按需选择数据、流控和平台能力，业务代码仍是普通 Java 与 Spring。
<dependency>
<groupId>io.github.patton174</groupId>
<artifactId>coco-spring-boot-starter</artifactId>
</dependency>
# features are opt-in
coco:
idempotency:
enabled: true
@CocoIdempotent(namespace = "orders")
OrderResponse create(@RequestBody CreateOrder cmd) {
return orders.create(cmd);
}
引入 Starter
- 17主干功能标识
- 1Starter 接入
- Java 17+业务编译目标
- Apache-2.0开源许可
清晰分层，业务保持自由。
Controller 还是普通 Spring 代码。用户、组织、认证提供者和事务边界由你决定。
统一响应、全局异常与 TraceId 默认生效。数据库、Redis、认证、租户及其他外部服务仍需按需配置。
架构与设计边界- 业务应用
领域模型 · Controller · 事务
- Starter
统一接入 · 自动装配
- Features
按需选择的基础设施能力
- Foundation
公共契约 · 上下文 · 日志
从一个接口开始。
打开快速开始指南引入依赖
采用 coco-parent，添加 Starter；版本以正式发布记录为准。
选择能力
通过 YAML 调整功能开关，配置需要的数据库或外部服务。
启动应用
编写普通 Spring Controller，运行 Spring Boot 应用。
验证响应
请求接口，检查统一响应、异常输出与 TraceId。