Skip to content

Starter 模块

Starter 是 x-boot-cloud 的基础能力层。它们把多个服务都会用到的配置、自动装配、拦截器和工具统一封装,让业务服务关注领域本身。

模块清单

模块作用
x-boot-core核心工具类、枚举、常量和基础模型
x-boot-starter-web统一响应、全局异常处理、Web 安全能力
x-boot-starter-satokenSa-Token 认证与权限集成
x-boot-starter-redisRedis 与 Redisson 集成
x-boot-starter-rate-limit-redis基于 Redis 的分布式限流
x-boot-starter-crudMyBatis-Plus CRUD 增强
x-boot-starter-cloudSpring Cloud 配置增强
x-boot-starter-dubboDubbo RPC 接入
x-boot-starter-aopAOP 切面能力
x-boot-starter-i18n国际化支持
x-boot-starter-tenant多租户上下文与隔离支持
x-boot-starter-rocketmq-aliyun阿里云 ONS / RocketMQ 接入
x-boot-starter-aiOllama、OpenAI、DeepSeek 与 OpenAI-compatible 模型接入
x-boot-job-coreXXL-Job 任务调度核心能力
x-boot-starter-test项目测试辅助能力

使用方式

业务模块通过 Maven 依赖需要的 Starter,并使用项目统一的配置和自动装配约定。新增 Starter 时应:

  1. x-boot-starters 下建立独立模块。
  2. 将自动配置类放在清晰的包边界内。
  3. META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 中注册自动配置。
  4. 为核心行为添加针对性的单元测试。
  5. 在模块 POM 和根聚合 POM 中保持依赖关系一致。

设计边界

Starter 负责“可复用的基础能力”,不负责具体业务领域。例如,Redis Starter 提供缓存和分布式锁接入,但用户、订单或知识库的缓存规则应由对应业务 Service 决定。

以工程化方式构建可演进的 Java 微服务系统