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

CKTIS / Java

Copia defensiva de colecciones

Copia la lista en el constructor y en `getRoles()` para que el código llamante no pueda modificar la lista almacenada en el DTO. `final` por sí solo no basta.

Versión: Java SE 21

Sintaxis

private final List<String> roles;

RolesDto(List<String> roles) {
    this.roles = new ArrayList<>(roles);
}

public List<String> getRoles() {
    return new ArrayList<>(roles);
}

La copia defensiva de colecciones protege el estado de un objeto frente a cambios mediante una referencia compartida. En un objeto de transferencia de datos (DTO), el constructor guarda new ArrayList<>(roles) en lugar de conservar la lista recibida. Cada llamada a getRoles() devuelve una lista nueva y modificable. Ambas copias conservan el orden de los elementos. final impide asignar otra lista al campo, pero no impide operaciones como add o set sobre la propia lista.

new ArrayList<>(roles) crea una copia superficial: las listas son objetos distintos, pero hacen referencia a los mismos elementos. Esto basta con String, porque las cadenas son inmutables. Si los elementos son mutables, un cambio en su estado puede verse desde ambas listas. Si también debes aislar ese estado, cópialo tanto en la entrada como en la salida o usa tipos de elementos inmutables.

Si el código llamante no necesita editar el resultado y no se permite null, guarda List.copyOf(roles) en el constructor y devuelve esa lista directamente. Los cambios posteriores en la lista de origen no se reflejan en el resultado, y copyOf no tiene por qué crear una instancia nueva. Los métodos de modificación del resultado lanzan UnsupportedOperationException; un origen o un elemento null provoca NullPointerException. El resultado sigue siendo superficial. En cambio, Collections.unmodifiableList(roles) crea una vista no modificable, no una copia: los cambios en la lista de origen siguen siendo visibles en ella.

Ejemplos

import java.util.ArrayList;
import java.util.List;

public class Main {
    static final class RolesDto {
        private final List<String> roles;

        RolesDto(List<String> roles) {
            this.roles = new ArrayList<>(roles);
        }

        public List<String> getRoles() {
            return new ArrayList<>(roles);
        }
    }

    public static void main(String[] args) {
        List<String> input = new ArrayList<>(List.of("reader"));
        RolesDto dto = new RolesDto(input);
        input.add("admin");

        List<String> returned = dto.getRoles();
        returned.set(0, "owner");

        System.out.println(input);
        System.out.println(returned);
        System.out.println(dto.getRoles());
    }
}

Resultado

[reader, admin]
[owner]
[reader]

`input.add("admin")` solo modifica la lista de entrada, y `returned.set(0, "owner")` solo modifica la copia de la primera llamada a `getRoles()`. La segunda llamada sigue devolviendo `[reader]`.

Lecciones relacionadas

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

Fuentes