Starter 模块
Starter 是 x-boot-cloud 的基础能力层。它们把多个服务都会用到的配置、自动装配、拦截器和工具统一封装,让业务服务关注领域本身。
模块清单
| 模块 | 作用 |
|---|---|
x-boot-core | 核心工具类、枚举、常量和基础模型 |
x-boot-starter-web | 统一响应、全局异常处理、Web 安全能力 |
x-boot-starter-satoken | Sa-Token 认证与权限集成 |
x-boot-starter-redis | Redis 与 Redisson 集成 |
x-boot-starter-rate-limit-redis | 基于 Redis 的分布式限流 |
x-boot-starter-crud | MyBatis-Plus CRUD 增强 |
x-boot-starter-cloud | Spring Cloud 配置增强 |
x-boot-starter-dubbo | Dubbo RPC 接入 |
x-boot-starter-aop | AOP 切面能力 |
x-boot-starter-i18n | 国际化支持 |
x-boot-starter-tenant | 多租户上下文与隔离支持 |
x-boot-starter-rocketmq-aliyun | 阿里云 ONS / RocketMQ 接入 |
x-boot-starter-ai | Ollama、OpenAI、DeepSeek 与 OpenAI-compatible 模型接入 |
x-boot-job-core | XXL-Job 任务调度核心能力 |
x-boot-starter-test | 项目测试辅助能力 |
使用方式
业务模块通过 Maven 依赖需要的 Starter,并使用项目统一的配置和自动装配约定。新增 Starter 时应:
- 在
x-boot-starters下建立独立模块。 - 将自动配置类放在清晰的包边界内。
- 在
META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports中注册自动配置。 - 为核心行为添加针对性的单元测试。
- 在模块 POM 和根聚合 POM 中保持依赖关系一致。
设计边界
Starter 负责“可复用的基础能力”,不负责具体业务领域。例如,Redis Starter 提供缓存和分布式锁接入,但用户、订单或知识库的缓存规则应由对应业务 Service 决定。