128-java-generics

Review and improve Java code using comprehensive generics best practices that enforce compile-time type safety and enable flexible, reusable APIs.

Prerequisites: Run ./mvnw compile or mvn compile before applying any change. If compilation fails, stop immediately and do not proceed — compilation failure is a blocking condition.

Core areas: Type safety (avoiding raw types, eliminating unsafe casts), code reusability (generic methods and types for multiple type contexts), API clarity (PECS wildcards — ? extends for producers, ? super for consumers), performance optimization (eliminating boxing/casting overhead), diamond operator for type inference, type erasure awareness (type tokens, factory patterns, array creation), generic inheritance...

當您需要審查、改進或重構 Java 程式碼以提高泛型品質時使用，包括避免原始類型、應用通配符的 PECS（生產者擴展消費者超級）原則、使用有界類型參數、設計有效的泛型方法、利用菱形運算子、理解類型擦除含義、正確處理泛型繼承、使用 @SafeVarargs 防止堆化記錄，以及將類型符號相匹配、泛型java 技能專案的一部分 來源：jabrena/cursor-rules-java。