SuperAPI AI 工具集

eliteforge-java-coding-spec

编程与开发

查看项目

更新于 10-16 08:34

技能介绍

用途:在 Java 开发任务中依据 EliteForge Java 编码规范 v1.0.0 提供明确的决策指引,说明什么应做、什么禁止、必须使用何种写法,并引用规范条款(如 §3.2 POJO类)。

主要能力与执行原则:标注禁止的条款任何场景不得妥协,标注必须的条款不得降级替代;代码示例优先从 references/java-coding-spec-v1.md 对应条款提取,不自行臆造;检索时先用 spec 行号定位再局部读取,避免整篇加载;回答中标注对应条款编号。

使用方式:可用 cat references/toc.md 查看行号索引;用 rg -n "禁止|必须|推荐|使用|Spring|POJO|枚举|日志|事务|并发|MyBatis|服务间调用|Maven|国际化|网关|接口管理|工程" references/java-coding-spec-v1.md 按关键字定位;用 sed -n '100,200p' references/java-coding-spec-v1.md 按行号读取条款。

高频结论示例:枚举用 Enum 后缀并 implements BizEnum,配 @Getter/@RequiredArgsConstructor(§3.3);POJO 用 UpperCamelCase、Serializable、serialVersionUID、@Accessors(chain=true)(§3.2);工具类用 Apache Commons/JDK/统一框架,禁止 hutool(§3.4);日志用 @Slf4j 加占位符,禁止 e.printStackTrace()(§3.6);禁止在循环/递归中调接口,必须封装批量接口(§3.5);线程池用 ThreadPoolExecutor 与 TransmittableThreadLocal,禁止 Executors(§3.7);事务为 public 方法、seata TCC、围住最小必要代码(§3.9);禁止 RestTemplate,必须用 RestClient(§3.10);Bean 注入用 @RequiredArgsConstructor,禁止 @Autowired(§3.10);服务间调用用 HttpExchangeClient + RestClient(§3.11);版本要求 JDK21 + Maven 3.9.10+ 并使用 maven wrapper(§3.12);接口前缀 /api、/inner-api、/open-api(§7.1)。

适用场景:Java 编码规范查询、代码风格与写法决策、分层与模块结构、接口路径与出参入参约束等。

限制:规范未覆盖的场景需标注“需用户补充或需外部确认”;涉及版本号时引用规范原文,不臆造;具体安装命令、收费与价格等信息暂未提供。