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...

Da utilizzare quando è necessario rivedere, migliorare o effettuare il refactoring del codice Java per la qualità dei generici, ad esempio evitando i tipi grezzi, applicando il principio PECS (Producer Extends Consumer Super) per i caratteri jolly, utilizzando parametri di tipo limitato, progettando metodi generici efficaci, sfruttando l'operatore diamante, comprendendo le implicazioni sulla cancellazione dei tipi, gestendo correttamente l'ereditarietà generica, prevenendo l'inquinamento dell'heap con @SafeVarargs e integrando i generici con le moderne funzionalità Java come record, tipi sigillati e corrispondenza di modelli. Parte del progetto skills-for-java Fonte: jabrena/cursor-rules-java.