CKTIS / Java
Costruttore canonico compatto di un record
In Java SE 21, il costruttore canonico compatto di un record convalida o normalizza gli argomenti prima che Java assegni i loro valori ai campi dei componenti.
Versione: Java SE 21
Sintassi
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)`.In Java SE 21, public Person { ... } dichiara il costruttore canonico di un record pubblico senza parentesi né elenco dei parametri. I tipi, i nomi e l’ordine dei parametri derivano dall’intestazione del record. La chiamata new Person(...) richiede comunque gli argomenti per tutti i componenti.
Nel corpo, firstName indica il parametro, non il campo. Si può riassegnare il parametro, ma assegnare un valore a un campo di componente, come in this.firstName = firstName, è un errore di compilazione, così come usare return o invocare esplicitamente un costruttore con this(...) o super(...). Solo se il corpo termina normalmente, Java assegna i valori correnti dei parametri ai campi privati final, nell’ordine dell’intestazione. Se il corpo lancia un’eccezione, tali assegnazioni non avvengono.
Un record ha un solo costruttore canonico: si dichiara in forma compatta oppure con l’elenco completo dei parametri e l’inizializzazione esplicita dei campi. Se non si dichiara nessuna delle due forme, Java fornisce il costruttore canonico. Un costruttore canonico esplicito non può essere meno accessibile del record.
La forma compatta non cambia il contratto dei metodi del record. I metodi di accesso pubblici generati, come firstName(), restituiscono i valori dei campi. Il metodo equals generato richiede la stessa classe record e l’uguaglianza di tutti i componenti. Il metodo hashCode generato usa tutti i componenti e deve restituire lo stesso valore per record uguali. Il metodo toString generato include il nome del record, i nomi dei componenti e la rappresentazione testuale dei relativi valori; il formato esatto non è garantito. Un record ricostruito con i risultati dei propri metodi di accesso deve essere uguale all’originale.
Esempi
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());
}
}
}
Risultato
firstName: Ada equal copy: true same hash: true null rejected: email invalid age rejected: age must be non-negative
`Person` rifiuta `null` per ciascuno dei tre parametri di tipo riferimento tramite `Objects.requireNonNull` (`NullPointerException`), rimuove gli spazi bianchi iniziali e finali da `firstName` con `strip()` e rifiuta un’età negativa con `IllegalArgumentException`. Non controlla il formato dell’indirizzo e-mail. La console mostra il valore normalizzato memorizzato, l’uguaglianza della copia, la corrispondenza dei codici hash e il rifiuto di un `email` nullo e di un’età negativa.
Lezioni correlate
- Java · Lezione 8 · Avanzato · Versione: 2