Java 泛型最佳实践
该技能用于审查和改进 Java 代码,通过全面的泛型最佳实践来强制实现编译期类型安全,并支持灵活、可复用的 API。
适用范围
- 类型安全:避免原始类型、消除不安全的类型转换。
- 代码复用:使用泛型方法与泛型类型适配多种类型上下文。
- API 清晰度:应用 PECS 通配符——生产者使用 ? extends,消费者使用 ? super。
- 性能优化:消除装箱与类型转换开销。
- 菱形运算符:用于类型推断。
- 类型擦除意识:涉及类型令牌(type tokens)、工厂模式、数组创建等场景。
覆盖的泛型主题还包括:泛型继承与型变(不变、协变、逆变)、使用 @SafeVarargs 防止堆污染、通配符捕获辅助方法、用于流式构建器的自限定泛型(CRTP)、与 Comparator<? super T> 和 Function<? super T, ? extends R> 配合的通配符 API 设计、数组与泛型的协变陷阱、使用 TypeReference/TypeToken 进行序列化、消除未检查警告、泛型命名惯例(T、E、K/V、?)、类型安全的异构容器,以及与 Record、密封类型和模式匹配的集成。
前置条件
在应用任何更改之前,先运行 ./mvnw compile 或 mvn compile。如果编译失败,必须立即停止,不得继续——编译失败是阻断条件。
多步骤范围
- 步骤 1:验证项目可编译。
- 步骤 2:分析 Java 代码,按影响(CRITICAL、MAINTAINABILITY、PERFORMANCE、TYPE_SAFETY)和领域(原始类型、通配符误用、有界参数机会、类型擦除问题、现代特性集成缺口)对泛型问题进行分类。
- 步骤 3:通过正确的参数化消除原始类型和不安全类型转换。
- 步骤 4:应用 PECS 通配符与有界类型参数,构建灵活的 API。
- 步骤 5:为类型擦除场景引入菱形运算符、泛型方法与类型令牌。
- 步骤 6:将泛型与 Record、密封类型和模式匹配集成。
- 步骤 7:使用 ./mvnw clean verify 验证所有更改可编译且所有测试通过。
应用更改之前
阅读参考资料以获取详细示例、正反模式与约束。
参考资料
详细指导、示例与约束见 references/128-java-generics.md。