CKTIS / Java
Kompaktní kanonický konstruktor záznamu
V Javě SE 21 kompaktní kanonický konstruktor záznamu ověřuje nebo normalizuje argumenty předtím, než Java přiřadí jejich hodnoty do polí komponent.
Verze: Java SE 21
Syntaxe
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)`.V Javě SE 21 zápis public Person { ... } ve veřejném záznamu deklaruje jeho kanonický konstruktor bez závorek a seznamu parametrů. Typy, názvy a pořadí parametrů vycházejí z hlavičky záznamu. Volání new Person(...) stále vyžaduje argumenty pro všechny komponenty.
V těle konstruktoru označuje firstName parametr, nikoli pole. Hodnotu parametru lze změnit, ale přiřazení do pole komponenty, například this.firstName = firstName, je chyba při překladu, stejně jako return nebo explicitní volání konstruktoru přes this(...) či super(...). Teprve když tělo skončí normálně, Java přiřadí aktuální hodnoty parametrů do soukromých polí final v pořadí z hlavičky. Pokud tělo vyvolá výjimku, k těmto přiřazením nedojde.
Záznam má jediný kanonický konstruktor: lze ho deklarovat v kompaktní podobě nebo s úplným seznamem parametrů a explicitní inicializací polí. Pokud není deklarována ani jedna z forem, Java kanonický konstruktor doplní. Explicitně deklarovaný kanonický konstruktor nesmí být méně přístupný než záznam.
Kompaktní forma nemění kontrakt metod záznamu. Generované veřejné přístupové metody, například firstName(), vracejí hodnoty polí. Generovaná metoda equals vyžaduje stejnou třídu záznamu a rovnost všech komponent. Generovaná metoda hashCode využívá všechny komponenty a pro rovné záznamy musí vrátit stejnou hodnotu. Generovaná metoda toString obsahuje název záznamu, názvy komponent a textové reprezentace jejich hodnot; přesný formát není zaručen. Záznam vytvořený z výsledků vlastních přístupových metod se musí rovnat původnímu záznamu.
Příklady
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());
}
}
}
Výsledek
firstName: Ada equal copy: true same hash: true null rejected: email invalid age rejected: age must be non-negative
`Person` odmítá `null` u každého ze tří referenčních parametrů pomocí `Objects.requireNonNull` (`NullPointerException`), odstraní bílé znaky na začátku a konci `firstName` pomocí `strip()` a odmítá záporný věk výjimkou `IllegalArgumentException`. Formát e-mailu neověřuje. Konzole ukáže uloženou normalizovanou hodnotu, rovnost kopie, shodu hašovacích kódů a odmítnutí `null` v `email` i záporného věku.
Související lekce
- Java · Lekce 8 · Pokročilá · Verze: 2