WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Das Schlüsselwort record

Das Schlüsselwort record: Eine record-Deklaration erzeugt eine nominale Datenklasse, deren Komponenten private final-Felder, Zugriffsmethoden und kanonischen Konstruktor bestimmen.

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

Syntax

record

Eine record-Deklaration erzeugt eine nominale Datenklasse, deren Komponenten private final-Felder, Zugriffsmethoden und kanonischen Konstruktor bestimmen.

Nutze record für transparente Werte; schreibe den kompakten kanonischen Konstruktor als Name { ... }, um Parameter vor automatischer Feldzuweisung zu prüfen oder zu normalisieren.

Ein kompakter kanonischer Konstruktor hat keine Parameterliste und darf Komponentenfelder nicht explizit zuweisen; flaches final friert veränderliche Objekte nicht ein.

Ein Record ist implizit final und erweitert java.lang.Record; eigene Zugriffsmethoden oder equals müssen Invariant und Wertsemantik bewahren.

Der kompakte kanonische Konstruktor erzeugt Range[start=2, end=7], size=5 und components=2; umgekehrt folgt invalid=reversed.

Beispiele

public class Main { record Range(int start,int end){ Range { if(start>end)throw new IllegalArgumentException("reversed"); } int size(){return end-start;} } public static void main(String[] a){var r=new Range(2,7);System.out.println(r);System.out.println("size="+r.size());System.out.println("components="+Range.class.getRecordComponents().length);try{new Range(5,1);}catch(IllegalArgumentException e){System.out.println("invalid="+e.getMessage());}} }

Ergebnis

Range[start=2, end=7]
size=5
components=2
invalid=reversed

Der kompakte kanonische Konstruktor erzeugt Range[start=2, end=7], size=5 und components=2; umgekehrt folgt invalid=reversed.

Quellen