WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Kompakter kanonischer Konstruktor eines Records

In Java SE 21 prüft oder normalisiert der kompakte kanonische Konstruktor eines Records seine Argumente, bevor Java deren Werte den Komponentenfeldern zuweist.

Version: Java SE 21

Syntax

record R(T1 c1, T2 c2) {
    R {
        // Validate or normalize c1 and c2.
    }
}

For a public record, declare the compact constructor as `public R { ... }`. There is no parameter list in the declaration; the call still supplies all components, as in `new R(v1, v2)`.

In Java SE 21 deklariert public Person { ... } in einem öffentlichen Record dessen kanonischen Konstruktor ohne Klammern und ohne Parameterliste. Typen, Namen und Reihenfolge der Parameter ergeben sich aus dem Record-Kopf. Beim Aufruf new Person(...) sind weiterhin Argumente für alle Komponenten nötig.

Im Rumpf bezeichnet firstName den Parameter, nicht das Feld. Der Parameter darf neu zugewiesen werden. Eine Zuweisung an ein Komponentenfeld wie this.firstName = firstName ist dagegen ein Kompilierfehler, ebenso return oder ein expliziter Konstruktoraufruf mit this(...) oder super(...). Erst wenn der Rumpf normal endet, weist Java die aktuellen Parameterwerte in der Reihenfolge des Record-Kopfs den privaten final-Feldern zu. Wird eine Ausnahme ausgelöst, unterbleiben diese Zuweisungen.

Ein Record hat nur einen kanonischen Konstruktor: entweder in kompakter Form oder mit vollständiger Parameterliste und expliziter Initialisierung der Felder. Ist keine der beiden Formen deklariert, stellt Java den kanonischen Konstruktor bereit. Ein explizit deklarierter kanonischer Konstruktor darf nicht weniger zugänglich sein als der Record.

Die kompakte Form ändert den Vertrag der Record-Methoden nicht. Generierte öffentliche Zugriffsmethoden wie firstName() liefern die Feldwerte. Das generierte equals verlangt dieselbe Record-Klasse und Gleichheit aller Komponenten. Das generierte hashCode berücksichtigt alle Komponenten und liefert für gleiche Records denselben Wert. Das generierte toString enthält den Record-Namen sowie die Namen und Textdarstellungen der Komponentenwerte; das genaue Format ist nicht garantiert. Ein aus den Ergebnissen seiner eigenen Zugriffsmethoden neu erzeugter Record muss dem Original gleich sein.

Beispiele

import java.util.Objects;

public record Person(String firstName, String lastName, String email, int age) {
    public Person {
        firstName = Objects.requireNonNull(firstName, "firstName").strip();
        Objects.requireNonNull(lastName, "lastName");
        Objects.requireNonNull(email, "email");
        if (age < 0) {
            throw new IllegalArgumentException("age must be non-negative");
        }
    }

    public static void main(String[] args) {
        Person person = new Person("  Ada  ", "Lovelace", "ada@example.test", 36);
        Person copy = new Person(person.firstName(), person.lastName(),
                                 person.email(), person.age());

        System.out.println("firstName: " + person.firstName());
        System.out.println("equal copy: " + person.equals(copy));
        System.out.println("same hash: " + (person.hashCode() == copy.hashCode()));

        try {
            new Person("Ada", "Lovelace", null, 36);
        } catch (NullPointerException e) {
            System.out.println("null rejected: " + e.getMessage());
        }
        try {
            new Person("Ada", "Lovelace", "ada@example.test", -1);
        } catch (IllegalArgumentException e) {
            System.out.println("invalid age rejected: " + e.getMessage());
        }
    }
}

Ergebnis

firstName: Ada
equal copy: true
same hash: true
null rejected: email
invalid age rejected: age must be non-negative

`Person` weist `null` bei jedem der drei Referenzparameter mit `Objects.requireNonNull` zurück (`NullPointerException`), entfernt mit `strip()` Leerraum am Anfang und Ende von `firstName` und lehnt ein negatives Alter mit `IllegalArgumentException` ab. Das E-Mail-Format wird nicht geprüft. Die Konsole zeigt den gespeicherten normalisierten Wert, die Gleichheit der Kopie, übereinstimmende Hashcodes und die Ablehnung von `null` für `email` sowie eines negativen Alters.

Zugehörige Lektionen

  • Java · Lektion 8 · Fortgeschritten · Version: 2

Quellen