Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes