Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Kompaktni kanonski konstruktor zapisa

U Javi SE 21 kompaktni kanonski konstruktor zapisa provjerava ili normalizira argumente prije nego što Java njihove vrijednosti dodijeli poljima komponenata.

Verzija: Java SE 21

Sintaksa

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)`.

U Javi SE 21 zapis public Person { ... } unutar javnog zapisa deklarira njegov kanonski konstruktor bez zagrada i popisa parametara. Tipovi, imena i redoslijed parametara proizlaze iz zaglavlja zapisa. Poziv new Person(...) i dalje zahtijeva argumente za sve komponente.

U tijelu konstruktora firstName označava parametar, a ne polje. Parametru se smije dodijeliti nova vrijednost, ali dodjela polju komponente, kao u this.firstName = firstName, pogreška je pri prevođenju, kao i return ili izravan poziv konstruktora pomoću this(...) ili super(...). Tek ako tijelo završi normalno, Java dodjeljuje trenutačne vrijednosti parametara privatnim poljima final redoslijedom iz zaglavlja. Ako tijelo baci iznimku, te se dodjele ne izvršavaju.

Zapis ima samo jedan kanonski konstruktor: deklarira se u kompaktnom obliku ili s potpunim popisom parametara i eksplicitnom inicijalizacijom polja. Ako nije deklariran nijedan oblik, Java osigurava kanonski konstruktor. Eksplicitno deklarirani kanonski konstruktor ne smije biti manje dostupan od zapisa.

Kompaktni oblik ne mijenja ugovor metoda zapisa. Generirane javne pristupne metode, kao što je firstName(), vraćaju vrijednosti polja. Generirani equals zahtijeva istu klasu zapisa i jednakost svih komponenata. Generirani hashCode koristi sve komponente i mora biti isti za jednake zapise. Generirani toString uključuje ime zapisa, imena komponenata i tekstualne prikaze njihovih vrijednosti; točan format nije zajamčen. Zapis ponovno stvoren iz rezultata vlastitih pristupnih metoda mora biti jednak izvornom zapisu.

Primjeri

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

Rezultat

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

`Person` odbija `null` za svaki od tri referentna parametra pomoću `Objects.requireNonNull` (`NullPointerException`), uklanja bjeline s početka i kraja vrijednosti `firstName` pomoću `strip()` i odbija negativnu dob iznimkom `IllegalArgumentException`. Ne provjerava format adrese e-pošte. Konzola prikazuje pohranjenu normaliziranu vrijednost, jednakost kopije, podudaranje kodova raspršivanja i odbijanje vrijednosti `null` za `email` te negativne dobi.

Povezane lekcije

  • Java · Lekcija 8 · Napredno · Verzija: 2

Izvori