CKTIS / Java
Copia difensiva delle collezioni
Copia la lista nel costruttore e in `getRoles()` per impedire al chiamante di modificare la lista memorizzata nel DTO. `final` da solo non basta.
Versione: Java SE 21
Sintassi
private final List<String> roles;
RolesDto(List<String> roles) {
this.roles = new ArrayList<>(roles);
}
public List<String> getRoles() {
return new ArrayList<>(roles);
}La copia difensiva delle collezioni protegge lo stato di un oggetto dalle modifiche tramite un riferimento condiviso. In un oggetto di trasferimento dati (DTO), il costruttore memorizza new ArrayList<>(roles) invece di conservare la lista ricevuta. Ogni chiamata a getRoles() restituisce una nuova lista modificabile. Entrambe le copie mantengono l’ordine degli elementi. final impedisce di assegnare un’altra lista al campo, ma non impedisce operazioni come add o set sulla lista stessa.
new ArrayList<>(roles) crea una copia superficiale: le liste sono oggetti distinti, ma fanno riferimento agli stessi elementi. Con String questo basta, perché le stringhe sono immutabili. Se gli elementi sono mutabili, una modifica al loro stato può essere visibile da entrambe le liste. Se occorre isolare anche quello stato, copialo sia in ingresso sia in uscita oppure usa tipi di elementi immutabili.
Se il chiamante non deve modificare il risultato e null non è ammesso, memorizza List.copyOf(roles) nel costruttore e restituisci direttamente quella lista. Le modifiche successive alla lista di origine non si riflettono nel risultato e copyOf non deve necessariamente creare una nuova istanza. I metodi di modifica del risultato lanciano UnsupportedOperationException; una sorgente o un elemento null causa NullPointerException. Il risultato resta superficiale. Invece, Collections.unmodifiableList(roles) crea una vista non modificabile, non una copia: le modifiche alla lista di origine rimangono visibili nella vista.
Esempi
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());
}
}Risultato
[reader, admin] [owner] [reader]
`input.add("admin")` modifica solo la lista di ingresso e `returned.set(0, "owner")` modifica solo la copia della prima chiamata a `getRoles()`. La seconda chiamata restituisce ancora `[reader]`.
Lezioni correlate
- Java · Lezione 10 · Avanzato · Versione: 2