Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Constructor canónico compacto de un record

En Java SE 21, el constructor canónico compacto de un record valida o normaliza los argumentos antes de que Java asigne sus valores a los campos de los componentes.

Versión: Java SE 21

Sintaxis

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 { ... } declara el constructor canónico de un record público sin paréntesis ni lista de parámetros. Los tipos, los nombres y el orden de los parámetros se derivan de la cabecera del record. La llamada a new Person(...) sigue recibiendo argumentos para todos los componentes.

Dentro del cuerpo, firstName designa el parámetro, no el campo. Se puede reasignar el parámetro, pero asignar un campo de componente, como en this.firstName = firstName, es un error de compilación, igual que usar return o invocar explícitamente un constructor mediante this(...) o super(...). Solo si el cuerpo termina normalmente, Java asigna los valores actuales de los parámetros a los campos privados final en el orden de la cabecera. Si el cuerpo lanza una excepción, no se realizan esas asignaciones.

Un record tiene un solo constructor canónico: se declara en forma compacta o con la lista completa de parámetros y la inicialización explícita de los campos. Si no se declara ninguna de las dos formas, Java proporciona el constructor canónico. Un constructor canónico explícito no puede ser menos accesible que el record.

La forma compacta no cambia el contrato de los métodos del record. Los métodos de acceso públicos generados, como firstName(), devuelven los valores de los campos. El equals generado exige la misma clase de record y la igualdad de todos los componentes. El hashCode generado usa todos los componentes y debe coincidir para records iguales. El toString generado incluye el nombre del record, los nombres de los componentes y la representación textual de sus valores; el formato exacto no está garantizado. Un record reconstruido con los resultados de sus propios métodos de acceso debe ser igual al original.

Ejemplos

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` rechaza `null` en cada uno de los tres parámetros de referencia mediante `Objects.requireNonNull` (`NullPointerException`), elimina los espacios en blanco iniciales y finales de `firstName` con `strip()` y rechaza una edad negativa con `IllegalArgumentException`. No comprueba el formato del correo electrónico. La consola muestra el valor normalizado que se guarda, la igualdad de la copia, la coincidencia de los códigos hash y el rechazo de un `email` nulo y una edad negativa.

Lecciones relacionadas

  • Java · Lección 8 · Avanzado · Versión: 2

Fuentes