CKTIS / Java
Kompaktni kanonični konstruktor zapisa
V Javi SE 21 kompaktni kanonični konstruktor zapisa preveri ali normalizira argumente, preden Java njihove vrednosti priredi poljem komponent.
Različica: 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)`.V Javi SE 21 zapis public Person { ... } v javnem zapisu deklarira njegov kanonični konstruktor brez oklepajev in seznama parametrov. Tipi, imena in vrstni red parametrov izhajajo iz glave zapisa. Klic new Person(...) še vedno zahteva argumente za vse komponente.
V telesu konstruktorja firstName označuje parameter, ne polja. Parametru lahko prirediš novo vrednost, vendar je prireditev polju komponente, kot je this.firstName = firstName, napaka pri prevajanju, prav tako return ali izrecen klic konstruktorja z this(...) ali super(...). Šele ko se telo normalno konča, Java trenutne vrednosti parametrov priredi zasebnim poljem final po vrstnem redu iz glave. Če telo sproži izjemo, do teh prireditev ne pride.
Zapis ima samo en kanonični konstruktor: deklariraš ga v kompaktni obliki ali s celotnim seznamom parametrov in izrecno inicializacijo polj. Če ni deklarirana nobena od obeh oblik, Java zagotovi kanonični konstruktor. Izrecno deklarirani kanonični konstruktor ne sme biti manj dostopen od zapisa.
Kompaktna oblika ne spremeni pogodbe metod zapisa. Generirane javne dostopne metode, kot je firstName(), vrnejo vrednosti polj. Generirana metoda equals zahteva isti razred zapisa in enakost vseh komponent. Generirana metoda hashCode uporablja vse komponente in mora za enaka zapisa vrniti isto vrednost. Generirana metoda toString vsebuje ime zapisa, imena komponent in besedilne predstavitve njihovih vrednosti; natančna oblika ni zagotovljena. Zapis, znova ustvarjen iz rezultatov njegovih lastnih dostopnih metod, mora biti enak izvirniku.
Primeri
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` z `Objects.requireNonNull` zavrne `null` pri vsakem od treh referenčnih parametrov (`NullPointerException`), z `strip()` odstrani bele znake na začetku in koncu `firstName` ter z `IllegalArgumentException` zavrne negativno starost. Oblike e-poštnega naslova ne preverja. Konzola prikaže shranjeno normalizirano vrednost, enakost kopije, ujemanje zgoščevalnih kod ter zavrnitev vrednosti `null` za `email` in negativne starosti.
Povezane lekcije
- Java · Lekcija 8 · Napredna · Različica: 2