CKTIS / Java
Kompaktný kanonický konštruktor záznamu
V Jave SE 21 kompaktný kanonický konštruktor záznamu overuje alebo normalizuje argumenty predtým, ako Java priradí ich hodnoty do polí komponentov.
Verzia: 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)`.V Jave SE 21 zápis public Person { ... } vo verejnom zázname deklaruje jeho kanonický konštruktor bez zátvoriek a zoznamu parametrov. Typy, názvy a poradie parametrov vyplývajú z hlavičky záznamu. Volanie new Person(...) stále vyžaduje argumenty pre všetky komponenty.
V tele konštruktora označuje firstName parameter, nie pole. Hodnotu parametra možno zmeniť, no priradenie do poľa komponentu, napríklad this.firstName = firstName, je chyba pri kompilácii, rovnako ako return alebo explicitné volanie konštruktora cez this(...) či super(...). Až keď sa telo skončí normálne, Java priradí aktuálne hodnoty parametrov do súkromných polí final v poradí z hlavičky. Ak telo vyvolá výnimku, tieto priradenia nenastanú.
Záznam má iba jeden kanonický konštruktor: možno ho deklarovať v kompaktnej podobe alebo s úplným zoznamom parametrov a explicitnou inicializáciou polí. Ak nie je deklarovaná ani jedna forma, Java kanonický konštruktor doplní. Explicitne deklarovaný kanonický konštruktor nesmie byť menej prístupný ako záznam.
Kompaktná forma nemení kontrakt metod záznamu. Generované verejné prístupové metódy, napríklad firstName(), vracajú hodnoty polí. Generovaná metóda equals vyžaduje rovnakú triedu záznamu a rovnosť všetkých komponentov. Generovaná metóda hashCode využíva všetky komponenty a pre rovnaké záznamy musí vrátiť rovnakú hodnotu. Generovaná metóda toString obsahuje názov záznamu, názvy komponentov a textové reprezentácie ich hodnôt; presný formát nie je zaručený. Záznam vytvorený z výsledkov vlastných prístupových metód sa musí rovnať pôvodnému záznamu.
Prí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ýsledok
firstName: Ada equal copy: true same hash: true null rejected: email invalid age rejected: age must be non-negative
`Person` odmieta `null` pri každom z troch referenčných parametrov pomocou `Objects.requireNonNull` (`NullPointerException`), odstráni biele znaky na začiatku a konci `firstName` pomocou `strip()` a odmietne záporný vek výnimkou `IllegalArgumentException`. Formát e-mailu neoveruje. Konzola zobrazí uloženú normalizovanú hodnotu, rovnosť kópie, zhodu hašovacích kódov a odmietnutie hodnoty `null` v `email` aj záporného veku.
Súvisiace lekcie
- Java · Lekcia 8 · Pokročilá · Verzia: 2