CKTIS / Java
Компактен каноничен конструктор на запис
В Java SE 21 компактният каноничен конструктор на запис проверява или нормализира аргументите, преди Java да присвои стойностите им на полетата на компонентите.
Версия: Java SE 21
Синтаксис
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)`.В Java SE 21 public Person { ... } в публичен запис (record) декларира каноничния му конструктор без скоби и списък с параметри. Типовете, имената и редът на параметрите идват от заглавната част на записа. Извикването new Person(...) продължава да изисква аргументи за всички компоненти.
В тялото firstName означава параметъра, а не полето. Стойността на параметъра може да се промени, но присвояване на поле на компонент, като this.firstName = firstName, е грешка при компилация, както и return или явно извикване на конструктор чрез this(...) или super(...). Само ако тялото завърши нормално, Java присвоява текущите стойности на параметрите на частните полета final в реда от заглавната част. Ако тялото хвърли изключение, тези присвоявания не се извършват.
Записът има само един каноничен конструктор: той може да се декларира в компактна форма или с пълен списък с параметри и явно инициализиране на полетата. Ако нито една от двете форми не е декларирана, Java предоставя каноничния конструктор. Явно декларираният каноничен конструктор не може да е по-ограничен по достъп от записа.
Компактната форма не променя договора на методите на записа. Генерираните публични методи за достъп, като firstName(), връщат стойностите на полетата. Генерираният equals изисква записите да са от един и същ клас и всички компоненти да са равни. Генерираният hashCode използва всички компоненти и трябва да дава еднакви стойности за равни записи. Генерираният toString включва името на записа, имената на компонентите и текстовите представяния на стойностите им; точният формат не е гарантиран. Запис, създаден от резултатите на собствените си методи за достъп, трябва да е равен на оригинала.
Примери
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());
}
}
}
Резултат
firstName: Ada equal copy: true same hash: true null rejected: email invalid age rejected: age must be non-negative
`Person` отхвърля `null` за всеки от трите референтни параметъра чрез `Objects.requireNonNull` (`NullPointerException`), премахва празните знаци в началото и края на `firstName` чрез `strip()` и отхвърля отрицателна възраст с `IllegalArgumentException`. Форматът на имейл адреса не се проверява. Конзолата показва съхранената нормализирана стойност, равенството на копието, съвпадението на хеш кодовете и отхвърлянето на `null` за `email` и на отрицателна възраст.
Свързани уроци
- Java · Урок 8 · Напреднало · Версия: 2