Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Defensywne kopiowanie kolekcji

Kopiuj listę w konstruktorze i w metodzie `getRoles()`, aby kod wywołujący nie mógł zmieniać listy przechowywanej w DTO. Samo `final` nie wystarcza.

Wersja: Java SE 21

Składnia

private final List<String> roles;

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

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

Defensywne kopiowanie kolekcji chroni stan obiektu przed zmianami przez współdzieloną referencję. W obiekcie do przenoszenia danych (DTO) konstruktor zapisuje new ArrayList<>(roles), zamiast zachować listę przekazaną przez wywołującego. Metoda getRoles() przy każdym wywołaniu zwraca nową, modyfikowalną listę. Obie kopie zachowują kolejność elementów. final zapobiega przypisaniu innej referencji do pola, ale nie blokuje operacji takich jak add czy set na samej liście.

new ArrayList<>(roles) tworzy kopię płytką: listy są osobnymi obiektami, ale wskazują na te same elementy. W przypadku String to wystarcza, ponieważ napisy są niemutowalne. Jeśli elementy są mutowalne, zmiana ich stanu może być widoczna przez obie listy. Gdy trzeba odizolować także stan elementów, kopiuj go na wejściu i wyjściu albo użyj niemutowalnych typów elementów.

Jeśli wywołujący nie musi edytować wyniku, a null nie jest dozwolone, możesz zapisać w konstruktorze List.copyOf(roles) i zwracać tę listę bez kolejnego kopiowania. Późniejsze zmiany listy źródłowej nie są widoczne w wyniku, a copyOf nie musi tworzyć nowej instancji. Modyfikatory wyniku zgłaszają UnsupportedOperationException; źródło lub element równy null powoduje NullPointerException. Wynik nadal jest płytki. Z kolei Collections.unmodifiableList(roles) tworzy niemodyfikowalny widok, a nie kopię: zmiany listy źródłowej są w nim widoczne.

Przykłady

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

Wynik

[reader, admin]
[owner]
[reader]

`input.add("admin")` zmienia tylko listę wejściową, a `returned.set(0, "owner")` tylko kopię zwróconą przez pierwsze wywołanie `getRoles()`. Drugie wywołanie nadal zwraca listę `[reader]`.

Powiązane lekcje

  • Java · Lekcja 10 · Zaawansowany · Wersja: 2

Źródła