CKTIS / Java
Kompaktowy konstruktor kanoniczny rekordu
W Java SE 21 kompaktowy konstruktor kanoniczny rekordu sprawdza lub normalizuje argumenty przed automatycznym przypisaniem wartości do pól komponentów.
Wersja: Java SE 21
Składnia
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)`.W Java SE 21 zapis public Person { ... } wewnątrz publicznego rekordu deklaruje jego konstruktor kanoniczny bez nawiasów i bez powtarzania listy parametrów. Typy, nazwy i kolejność parametrów wynikają z nagłówka rekordu. Wywołanie new Person(...) nadal wymaga argumentów odpowiadających wszystkim komponentom.
W ciele konstruktora firstName oznacza parametr, nie pole. Można zmienić wartość parametru, lecz przypisanie do pola komponentu, np. this.firstName = firstName, jest błędem kompilacji, podobnie jak return lub jawne wywołanie konstruktora przez this(...) albo super(...). Dopiero po normalnym zakończeniu ciała Java przypisuje bieżące wartości parametrów do prywatnych pól final w kolejności z nagłówka. Jeśli ciało zgłosi wyjątek, te przypisania nie nastąpią.
Rekord ma tylko jeden konstruktor kanoniczny: można go zadeklarować w postaci kompaktowej albo z pełną listą parametrów i jawną inicjalizacją pól. Jeśli nie zadeklarujesz żadnej z tych postaci, Java dostarczy konstruktor kanoniczny. Jawny konstruktor kanoniczny nie może mieć bardziej ograniczonego dostępu niż rekord.
Kompaktowy konstruktor nie zmienia kontraktu metod rekordu. Domyślne publiczne akcesory, np. firstName(), zwracają wartości pól. Domyślne equals wymaga tej samej klasy rekordu i równości wszystkich komponentów. hashCode korzysta ze wszystkich komponentów i musi być taki sam dla równych rekordów. Domyślne toString zawiera nazwę rekordu oraz nazwy i tekstowe reprezentacje wartości komponentów; dokładny format nie jest gwarantowany. Rekord odtworzony z wyników własnych akcesorów musi być równy oryginałowi.
Przykłady
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());
}
}
}
Wynik
firstName: Ada equal copy: true same hash: true null rejected: email invalid age rejected: age must be non-negative
Konstruktor `Person` odrzuca `null` w każdym z trzech parametrów referencyjnych przez `Objects.requireNonNull` (`NullPointerException`), usuwa z `firstName` białe znaki na początku i końcu przez `strip()` i odrzuca wiek ujemny przez `IllegalArgumentException`. Nie sprawdza formatu adresu e-mail. Konsola pokazuje zapisaną wartość po normalizacji, równość kopii, zgodność kodów skrótu oraz odrzucenie `null` w `email` i ujemnego wieku.
Powiązane lekcje
- Java · Lekcja 8 · Zaawansowany · Wersja: 2