SuperAPI AI 工具集

java-component-patterns

编程与开发

查看项目

更新于 10-16 05:47

技能介绍

用途:为纯 Java 组件(SDK、工具库)提供 Maven 封装规范,权威参照 openclaw-java-sdk/pom.xml,完整模板见 assets/pom-template.xml。与 spring-boot-starter-patterns 的区别是无 parent、不依赖 Spring。

主要能力:无 parent 独立 POM,插件与依赖版本全部自管;使用 maven.compiler.release 而非 source/target;licenses/scm/developers 三段元数据(Central 发布必需);多 JDK 分支 feature/{line},分支间仅 pom 差异;组件间同线依赖(feature/1.0.x 只依赖 1.0.x 线)。

必要用法:元素顺序为坐标→name/url/description/version/packaging→licenses→scm→developers→properties(三段式)→dependencyManagement→dependencies→distributionManagement→build→profiles。properties 分基础、Dependency versions、Maven Plugin versions 三段。Jackson 用 BOM 统一管理:properties 定义 jackson-bom.version,dependencyManagement 中 import,dependencies 不写 version;禁止在 dependencyManagement 放无 version 的 Jackson 条目。java.version 写 1.8 而非 8。Apache License URL 用 https。分支模型:1.0.x 对应 JDK8/1.8/Jackson 2.18.9;2.0.x 对应 JDK17/17/2.22.1;3.0.x~3.5.x 对应 JDK21/21/3.2.1(tools.jackson)。版本格式 {line}.x.{yyyyMMdd} 与 -SNAPSHOT。新建流程 8 步:复制模板→替换占位符→按分支填 version/java.version→核对三段式→源码三件套(Client/Config/能力域)→测试→mvn clean verify→多分支创建。质量门禁:JaCoCo BUNDLE LINE ≥ 0.90 且 haltOnFailure=true,JUnit 5 + AssertJ,Javadoc 英语。

适用场景:封装纯 Java SDK 或工具库、多 JDK 线维护、发布到 Central。

限制:不适用于 Spring Boot starter 或强依赖 Spring 生态的库;Maven 4 下 model 4.0.0 零改动兼容,仅新特性需升级 4.1.0。具体版本号与命令以资料为准,未提供的信息暂未提供。