CKTIS / Java
Records et valeurs agrégées en Java
Records et valeurs agrégées en Java: Un record Java 21 est une classe d’agrégat nominale et superficiellement immuable : sa liste de composants détermine champs private final, accesseurs publics, constructeur canonique, equals, hashCode et toString.
Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntaxe
records aggregatesUn record Java 21 est une classe d’agrégat nominale et superficiellement immuable : sa liste de composants détermine champs private final, accesseurs publics, constructeur canonique, equals, hashCode et toString.
Utilise un record pour valeurs, messages et clés dont l’état est un ensemble fixe de composants ; place validation et normalisation dans le constructeur canonique ou compact.
La référence d’un composant est final mais son objet peut rester mutable ; un composant tableau emploie equals du tableau, fondé sur l’identité, et non Arrays.equals.
Un record est implicitement final et étend directement java.lang.Record ; les champs du constructeur compact sont affectés après son corps et ne peuvent y être affectés explicitement, tandis qu’un record imbriqué est implicitement static.
Le record affiche Point[x=2, y=3], equal=true et sum=5 ; les copies défensives conservent snapshot=[1, 2], tandis que equals du tableau donne same-contents-equal=false.
Exemples
import java.util.Arrays;
public class Main {
record Point(int x, int y) {
Point {
if (x < 0 || y < 0) throw new IllegalArgumentException("negative");
}
int sum() { return x + y; }
}
record Snapshot(String name, int[] values) {
Snapshot { values = values.clone(); }
@Override public int[] values() { return values.clone(); }
}
public static void main(String[] args) {
var point = new Point(2, 3);
System.out.println(point);
System.out.println("equal=" + point.equals(new Point(2, 3)));
System.out.println("sum=" + point.sum());
int[] source = {1, 2};
var snapshot = new Snapshot("v1", source);
source[0] = 9;
snapshot.values()[1] = 8;
System.out.println("snapshot=" + Arrays.toString(snapshot.values()));
System.out.println("same-contents-equal=" + snapshot.equals(new Snapshot("v1", new int[]{1, 2})));
}
}
Résultat
Point[x=2, y=3] equal=true sum=5 snapshot=[1, 2] same-contents-equal=false
Le record affiche Point[x=2, y=3], equal=true et sum=5 ; les copies défensives conservent snapshot=[1, 2], tandis que equals du tableau donne same-contents-equal=false.