Skip to content

接入已有项目 ​

已有 Spring Boot 项目可以先复用稳定契约,再逐步采用 starter。不要为了使用一个断言或分页类型,先把整个应用重写成七模块。

先导入 BOM ​

Gradle:

kotlin
repositories {
    mavenCentral()
    // 内部制品仓库按团队约定加入
}

dependencies {
    implementation(platform("com.kjs.wuli3:wuli3-dependencies:1.0.1-SNAPSHOT"))
    implementation("com.kjs.wuli3:wuli3-core")
}

Maven:

xml
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.kjs.wuli3</groupId>
      <artifactId>wuli3-dependencies</artifactId>
      <version>1.0.1-SNAPSHOT</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

BOM 管版本,具体依赖仍由应用声明。只发布 BOM 不足以运行 starter;外部项目必须能解析对应模块和它们的传递依赖。

按边界选择 starter ​

先解决的问题先接入之后确认
错误、断言、ID、时间wuli3-core错误模块命名和对外可见性
HTTP 上下文、统一响应wuli3-web-spring-boot-starter认证来源和原有响应兼容
数据库分页与 MyBatis-Pluswuli3-mysql-spring-boot-starter表结构、事务和排序白名单
Redis 缓存或锁wuli3-redis-spring-boot-starterTTL、失效、降级和命名空间
本地/事务/远程事件wuli3-event-spring-boot-startertransport、幂等、重试与投递语义

连接地址、凭据、表结构、消息拓扑和认证服务都属于应用或部署环境;starter 不会凭空创建这些外部事实。

渐进采用的顺序 ​

  1. 先只接入 core,让边界输入都进入统一错误链。
  2. 再接入 Web,确认认证解析器和已有响应契约。
  3. 为一个完整用例接入真实持久化,先验证归属检查、事务和分页。
  4. 需要跨执行边界时再加入上下文传播和事件 transport。
  5. 最后接入审计、指标、RPC 或对象存储,并为每个外部端口补联调验收。

按这个顺序,每一步都能通过单元测试和最小运行测试独立回滚。继续阅读 DDD 边界,理解代码应该放在哪个模块。

Wuli3 · Java 21 · Spring Boot 3.5.x