Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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 aggregates

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.

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.

Sources