CKTIS / Java
Construtor canónico compacto de um record
Em Java SE 21, o construtor canónico compacto de um record valida ou normaliza os argumentos antes de o Java atribuir os seus valores aos campos dos componentes.
Versão: Java SE 21
Sintaxe
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)`.Em Java SE 21, public Person { ... } declara o construtor canónico de um record público sem parênteses nem lista de parâmetros. Os tipos, os nomes e a ordem dos parâmetros vêm do cabeçalho do record. A chamada new Person(...) continua a receber argumentos para todos os componentes.
No corpo, firstName designa o parâmetro e não o campo. É possível reatribuir o parâmetro, mas uma atribuição a um campo de componente, como this.firstName = firstName, é um erro de compilação, tal como return ou uma chamada explícita a um construtor com this(...) ou super(...). Só quando o corpo termina normalmente é que o Java atribui os valores atuais dos parâmetros aos campos privados final, pela ordem do cabeçalho. Se o corpo lançar uma exceção, essas atribuições não ocorrem.
Um record tem apenas um construtor canónico: pode ser declarado na forma compacta ou com a lista completa de parâmetros e a inicialização explícita dos campos. Se nenhuma das formas for declarada, o Java fornece o construtor canónico. Um construtor canónico explícito não pode ser menos acessível do que o record.
A forma compacta não altera o contrato dos métodos do record. Os métodos de acesso públicos gerados, como firstName(), devolvem os valores dos campos. O equals gerado exige a mesma classe de record e a igualdade de todos os componentes. O hashCode gerado usa todos os componentes e tem de coincidir para records iguais. O toString gerado inclui o nome do record, os nomes dos componentes e as representações textuais dos valores; o formato exato não é garantido. Um record reconstruído a partir dos resultados dos seus próprios métodos de acesso tem de ser igual ao original.
Exemplos
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());
}
}
}
Resultado
firstName: Ada equal copy: true same hash: true null rejected: email invalid age rejected: age must be non-negative
`Person` rejeita `null` em cada um dos três parâmetros de referência com `Objects.requireNonNull` (`NullPointerException`), remove os espaços em branco no início e no fim de `firstName` com `strip()` e rejeita uma idade negativa com `IllegalArgumentException`. Não valida o formato do endereço de correio eletrónico. A consola mostra o valor normalizado guardado, a igualdade da cópia, a coincidência dos códigos hash e a rejeição de um `email` nulo e de uma idade negativa.
Lições relacionadas
- Java · Lição 8 · Avançado · Versão: 2