Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Immutabilité profonde et copie défensive

Un champ `final` ne fige pas le contenu d’un tableau. Les copies défensives à l’entrée et à la sortie protègent l’état de l’objet contre les modifications via des références partagées.

Version : Java SE 21

Syntaxe

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.

L’immutabilité profonde signifie que l’état logique d’un objet ne peut plus changer après sa construction, même par l’intermédiaire d’objets imbriqués. Un champ de référence final ne peut pas être réaffecté, mais le tableau référencé reste modifiable. De même, l’accesseur par défaut d’un record ne copie pas un composant mutable.

Effectuez des copies défensives aux deux frontières. À l’entrée, copiez les données mutables avant de les stocker pour qu’une modification de l’argument n’affecte pas l’objet. À la sortie, renvoyez une copie ou une valeur immuable plutôt que d’exposer un objet interne mutable. Conservez la copie interne dans un champ private et ne la modifiez pas après la construction.

Pour int[], clone() suffit, car les éléments sont des valeurs primitives. Pour int[][], clone() ne crée qu’un nouveau tableau externe : les tableaux internes restent partagés. La copie d’un tableau d’objets conserve également les références aux éléments. Copiez les parties mutables concernées ou convertissez-les en valeurs immuables.

Collections.unmodifiableList(source) fournit une vue non modifiable qui reflète les changements de la liste sous-jacente. List.copyOf(source) fournit un instantané non modifiable des éléments et de leur ordre, sans copier les objets eux-mêmes. Dans les deux cas, les éléments mutables peuvent encore changer et les opérations de modification sur la liste renvoyée lèvent UnsupportedOperationException. List.copyOf lève NullPointerException si la source ou un élément vaut null.

Exemples

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]);
    }
}

Résultat

7
7

Le résultat attendu est `7` deux fois. Le programme met d’abord l’élément du tableau d’entrée à `99`, puis celui du tableau renvoyé à `42`. Aucune de ces écritures ne change l’état de `IntSnapshot`.

Leçons associées

  • Java · Leçon 1 · Avancé · Version : 2
  • Java · Leçon 2 · Avancé · Version : 2

Sources