CKTIS / Java
Constructeur canonique compact d’un record
En Java SE 21, le constructeur canonique compact d’un record valide ou normalise les arguments avant que Java affecte leurs valeurs aux champs des composants.
Version : Java SE 21
Syntaxe
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)`.En Java SE 21, public Person { ... } déclare le constructeur canonique d’un record public sans parenthèses ni liste de paramètres. Les types, les noms et l’ordre des paramètres proviennent de l’en-tête du record. L’appel new Person(...) prend toujours des arguments pour tous les composants.
Dans le corps, firstName désigne le paramètre, pas le champ. On peut réaffecter le paramètre, mais affecter un champ de composant, comme dans this.firstName = firstName, est une erreur de compilation, tout comme return ou un appel explicite de constructeur par this(...) ou super(...). Si le corps se termine normalement, Java affecte les valeurs courantes des paramètres aux champs privés final, dans l’ordre de l’en-tête. Si le corps lève une exception, ces affectations n’ont pas lieu.
Un record n’a qu’un constructeur canonique : on le déclare sous forme compacte ou avec la liste complète des paramètres et l’initialisation explicite des champs. Si aucune des deux formes n’est déclarée, Java fournit le constructeur canonique. Un constructeur canonique explicite ne peut pas être moins accessible que le record.
La forme compacte ne modifie pas le contrat des méthodes du record. Les accesseurs publics générés, comme firstName(), renvoient les valeurs des champs. Le equals généré exige la même classe de record et l’égalité de tous les composants. Le hashCode généré utilise tous les composants et doit être identique pour deux records égaux. Le toString généré contient le nom du record ainsi que les noms et les représentations textuelles des valeurs des composants ; son format exact n’est pas garanti. Un record reconstruit à partir des résultats de ses propres accesseurs doit être égal à l’original.
Exemples
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());
}
}
}
Résultat
firstName: Ada equal copy: true same hash: true null rejected: email invalid age rejected: age must be non-negative
`Person` refuse `null` pour chacun des trois paramètres de type référence au moyen de `Objects.requireNonNull` (`NullPointerException`), retire les espaces blancs en début et en fin de `firstName` avec `strip()` et refuse un âge négatif avec `IllegalArgumentException`. Le format de l’adresse e-mail n’est pas vérifié. La console montre la valeur normalisée stockée, l’égalité de la copie, la concordance des codes de hachage et le rejet d’un `email` nul et d’un âge négatif.
Leçons associées
- Java · Leçon 8 · Avancé · Version : 2