CKTIS / Java
DTO e oggetto di dominio: mappatura esplicita
Separa i dati che attraversano un’interfaccia dallo stato e dal comportamento del dominio. Mappa esplicitamente cinque campi per creare istantanee indipendenti senza `passwordHash`.
Versione: Java SE 21
Sintassi
record UserDto(long id, String username, String email, String displayName, boolean active) {}
static UserDto toDto(User user) {
return new UserDto(user.id, user.username, user.email, user.displayName, user.active);
}
static User fromDto(UserDto dto) {
return new User(dto.id(), dto.username(), dto.email(), dto.displayName(), dto.active(), "***");
}User è un oggetto di dominio: mantiene uno stato ed espone operazioni di dominio come rename. UserDto è un oggetto di trasferimento dati (DTO): definisce quali dati attraversano un’interfaccia, ad esempio in una risposta API. Ha esattamente cinque campi: id, username, email, displayName e active. passwordHash non viene mascherato: è del tutto assente dal DTO.
toDto seleziona esplicitamente i campi e crea un nuovo record. fromDto legge gli stessi valori tramite i metodi di accesso del record e costruisce un nuovo User. Il DTO è un’istantanea indipendente, non una vista dinamica: cambiare il nome dell’utente non modifica un DTO esistente. L’immutabilità di un record è solo superficiale. Qui, i valori primitivi e gli oggetti String immutabili non condividono alcuno stato mutabile. Se aggiungi componenti mutabili, usa copie difensive dove necessario, anche quando esponi i valori.
La mappatura funziona in entrambe le direzioni, ma non è completamente reversibile: passare dal DTO al dominio e tornare al DTO preserva i cinque valori, ma non recupera lo stato omesso. *** è un segnaposto dimostrativo, non un vero hash della password né un meccanismo di accesso. In produzione, convalida i dati in ingresso, aggiorna gli oggetti esistenti tramite operazioni di dominio consentite e gestisci le credenziali separatamente.
Esempi
public class Main {
static final class User {
private final long id;
private final String username;
private final String email;
private String displayName;
private final boolean active;
private final String passwordHash;
User(long id, String username, String email, String displayName,
boolean active, String passwordHash) {
this.id = id;
this.username = username;
this.email = email;
this.displayName = displayName;
this.active = active;
this.passwordHash = passwordHash;
}
void rename(String name) {
displayName = name;
}
}
record UserDto(long id, String username, String email, String displayName, boolean active) {}
static UserDto toDto(User user) {
return new UserDto(user.id, user.username, user.email, user.displayName, user.active);
}
static User fromDto(UserDto dto) {
return new User(dto.id(), dto.username(), dto.email(), dto.displayName(), dto.active(), "***");
}
public static void main(String[] args) {
User original = new User(42L, "ada", "ada@example.test", "Ada", true, "demo-only");
UserDto snapshot = toDto(original);
original.rename("Ada Lovelace");
User rebuilt = fromDto(snapshot);
System.out.println("original=" + original.displayName);
System.out.println("snapshot=" + snapshot.displayName());
System.out.println("rebuilt=" + rebuilt.displayName);
System.out.println("sameDto=" + snapshot.equals(toDto(rebuilt)));
System.out.println("placeholder=" + "***".equals(rebuilt.passwordHash));
}
}
Risultato
original=Ada Lovelace snapshot=Ada rebuilt=Ada sameDto=true placeholder=true
Salva il codice in `Main.java` ed esegui `java Main.java` con JDK 21. Dopo il cambio di nome, l’originale mostra `Ada Lovelace`, mentre l’istantanea e l’oggetto ricostruito mostrano ancora `Ada`. `sameDto=true` riguarda solo i cinque campi del DTO; `placeholder=true` conferma l’uso del segnaposto.
Lezioni correlate
- Java · Lezione 10 · Avanzato · Versione: 2
Fonti
- Record (Java SE 21 & JDK 21)
- Java Language Specification, Java SE 21 Edition — §8.10 Record Classes
- String (Java SE 21 & JDK 21)
- The java Command — Using Source-File Mode to Launch Single-File Source-Code Programs
- Martin Fowler — Data Transfer Object
- OWASP API Security Top 10 — API3:2023 Broken Object Property Level Authorization