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

CKTIS / Java

Imutabilidade profunda e cópia defensiva

Um campo `final` não torna imutável o conteúdo de um array. As cópias defensivas à entrada e à saída impedem alterações ao estado do objeto através de referências partilhadas.

Versão: Java SE 21

Sintaxe

Java SE 21 design pattern, not a language construct: `private final int[] values;` with `this.values = input.clone();` in the constructor and `return values.clone();` in the accessor. This isolates a one-dimensional primitive array. For nested mutable state, copy or convert each mutable part to an immutable value. `List.copyOf(source)` takes an unmodifiable snapshot of list membership and order; `Collections.unmodifiableList(source)` provides an unmodifiable view of the backing list. Neither copies the element objects.

A imutabilidade profunda significa que o estado lógico de um objeto não pode mudar após a construção, nem mesmo através de objetos aninhados. Um campo de referência final não pode receber outra referência, mas o array para o qual aponta continua a poder ser alterado. O método de acesso predefinido de um record também não copia um componente mutável.

Faz cópias defensivas nas duas fronteiras. À entrada, copia os dados mutáveis antes de os guardar, para que alterações ao argumento não afetem o objeto. À saída, devolve uma cópia ou um valor imutável em vez de expor um objeto interno mutável. Guarda a cópia interna num campo private e não a alteres após a construção.

Para int[], basta clone(), porque os elementos são valores primitivos. Para int[][], clone() cria apenas um novo array exterior; os arrays interiores continuam partilhados. A cópia de um array de objetos também conserva as referências aos elementos. Copia as partes mutáveis relevantes ou converte-as em valores imutáveis.

Collections.unmodifiableList(source) fornece uma vista não modificável que reflete as alterações à lista subjacente. List.copyOf(source) fornece um instantâneo não modificável dos elementos e da sua ordem, mas não copia os próprios objetos. Em ambos os casos, os elementos mutáveis ainda podem mudar e as operações de alteração na lista devolvida lançam UnsupportedOperationException. List.copyOf lança NullPointerException se a origem ou algum elemento for null.

Exemplos

public final class IntSnapshot {
    private final int[] values;

    public IntSnapshot(int[] input) {
        this.values = input.clone();
    }

    public int[] values() {
        return values.clone();
    }

    public static void main(String[] args) {
        int[] input = {7};
        IntSnapshot snapshot = new IntSnapshot(input);

        input[0] = 99;
        System.out.println(snapshot.values()[0]);

        int[] returned = snapshot.values();
        returned[0] = 42;
        System.out.println(snapshot.values()[0]);
    }
}

Resultado

7
7

Espera-se `7` duas vezes. O programa altera primeiro o elemento do array de entrada para `99` e depois o do array devolvido para `42`. Nenhuma das escritas altera o estado de `IntSnapshot`.

Lições relacionadas

  • Java · Lição 1 · Avançado · Versão: 2
  • Java · Lição 2 · Avançado · Versão: 2

Fontes