SuperAPI AI 工具集

java-best-practices

编程与开发

查看项目

更新于 10-15 22:13

技能介绍

用途:该技能用于在编写或重构 Java 代码时套用 Effective Java 的核心模式,产出更健壮、易维护的代码,优先级标注为 P1(HIGH)。

主要能力与规范: 不可变性:优先使用不可变对象,字段用 final,集合用不可修改集合。 访问修饰符:最小化可见性,默认包级私有,字段一律 private,仅 API 契约用 public。 组合优于继承:优先 Has-A 而非 Is-A,避免过深的继承层级。 构造器:用静态工厂方法(如 User.of())替代复杂构造器。 Builder 模式:参数达到 4 个及以上时使用。 异常:可恢复错误用受检异常,编程错误用非受检异常。 快速失败:方法开头用 Objects.requireNonNull 校验参数。 接口:面向接口编程(List、Map),而非实现(ArrayList)。 依赖注入:通过构造器注入依赖,不在内部自行创建。 方法引用:可读时用 String::toUpperCase 替代 s -> s.toUpperCase()。

反模式:不返回 null,改用 Optional 或空集合;不写空 catch,需记录日志或重新抛出;避免上帝类,按单一职责拆分;不用魔法数字,提取具名常量;避免 public static 可变字段造成全局状态。

使用方式与适用场景:适用于 Java 项目的编码、代码评审与重构,作为代理技能在相关任务中触发。资料未提供具体安装命令、调用示例或平台配置,暂未提供。

限制:以上为规范清单,未说明支持的 Java 版本、工具链集成方式及自动化校验能力,暂未提供。