KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Compacte canonieke constructor van een record

In Java SE 21 valideert of normaliseert de compacte canonieke constructor van een record de argumenten voordat Java hun waarden aan de componentvelden toewijst.

Versie: 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 declareer je met public Person { ... } de canonieke constructor van een publiek record zonder haakjes of parameterlijst. De typen, namen en volgorde van de parameters volgen uit de recordheader. Bij new Person(...) geef je nog steeds voor alle componenten argumenten mee.

In de constructorbody verwijst firstName naar de parameter, niet naar het veld. Je mag de parameter een andere waarde geven, maar een toewijzing aan een componentveld, zoals this.firstName = firstName, is een compileerfout. Dat geldt ook voor return en voor een expliciete constructoraanroep met this(...) of super(...). Pas als de body normaal eindigt, wijst Java de huidige parameterwaarden toe aan de private final-velden, in de volgorde van de header. Als de body een uitzondering gooit, vinden die toewijzingen niet plaats.

Een record heeft maar één canonieke constructor: je declareert die in compacte vorm of met de volledige parameterlijst en expliciete initialisatie van de velden. Declareer je geen van beide vormen, dan levert Java de canonieke constructor. Een expliciet gedeclareerde canonieke constructor mag niet minder toegankelijk zijn dan het record.

De compacte vorm verandert het contract van de recordmethoden niet. Gegenereerde publieke toegangsmethoden zoals firstName() geven de veldwaarden terug. De gegenereerde equals vereist dezelfde recordklasse en gelijkheid van alle componenten. De gegenereerde hashCode gebruikt alle componenten en moet voor gelijke records dezelfde waarde opleveren. De gegenereerde toString bevat de recordnaam, de componentnamen en de tekstweergaven van de waarden; het exacte formaat is niet gegarandeerd. Een record dat opnieuw wordt opgebouwd uit de resultaten van zijn eigen toegangsmethoden moet gelijk zijn aan het origineel.

Voorbeelden

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

Resultaat

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

`Person` weigert `null` voor elk van de drie referentieparameters met `Objects.requireNonNull` (`NullPointerException`), verwijdert witruimte aan het begin en einde van `firstName` met `strip()` en weigert een negatieve leeftijd met `IllegalArgumentException`. Het e-mailformaat wordt niet gecontroleerd. De console toont de opgeslagen genormaliseerde waarde, de gelijkheid van de kopie, overeenkomende hashcodes en de afwijzing van `null` voor `email` en van een negatieve leeftijd.

Gerelateerde lessen

  • Java · Les 8 · Gevorderd · Versie: 2

Bronnen