WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Records und Aggregatwerte in Java

Records und Aggregatwerte in Java: Ein Record in Java 21 ist eine nominale, flach unveränderliche Aggregatklasse: Seine Komponentenliste bestimmt private final-Felder, öffentliche Zugriffsmethoden, kanonischen Konstruktor sowie equals, hashCode und toString.

Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntax

records aggregates

Ein Record in Java 21 ist eine nominale, flach unveränderliche Aggregatklasse: Seine Komponentenliste bestimmt private final-Felder, öffentliche Zugriffsmethoden, kanonischen Konstruktor sowie equals, hashCode und toString.

Nutze einen Record für Werte, Nachrichten und Schlüssel mit festem Komponentensatz; Validierung und Normalisierung gehören in den kanonischen oder kompakten Konstruktor.

Eine Komponentenreferenz ist final, ihr Ziel kann aber veränderlich bleiben; eine Array-Komponente nutzt Array-equals nach Identität statt Arrays.equals.

Ein Record ist implizit final und erweitert direkt java.lang.Record; beim kompakten Konstruktor werden Felder nach dem Rumpf gesetzt und dürfen dort nicht explizit zugewiesen werden, ein verschachtelter Record ist implizit static.

Der Record gibt Point[x=2, y=3], equal=true und sum=5 aus; defensive Kopien bewahren snapshot=[1, 2], während Array-equals same-contents-equal=false ergibt.

Beispiele

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})));
    }
}

Ergebnis

Point[x=2, y=3]
equal=true
sum=5
snapshot=[1, 2]
same-contents-equal=false

Der Record gibt Point[x=2, y=3], equal=true und sum=5 aus; defensive Kopien bewahren snapshot=[1, 2], während Array-equals same-contents-equal=false ergibt.

Quellen