CKTIS / Java
DTO i domenski objekt: eksplicitno mapiranje
Odvoji podatke koji prolaze kroz sučelje od stanja i ponašanja domene. Eksplicitno mapiraj pet polja kako bi nastale neovisne snimke bez `passwordHash`.
Verzija: Java SE 21
Sintaksa
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 je domenski objekt: čuva stanje i nudi domenske operacije kao što je rename. UserDto je objekt za prijenos podataka (DTO): određuje koji podaci prolaze kroz sučelje, primjerice u odgovoru API-ja. Ima točno pet polja: id, username, email, displayName i active. passwordHash nije maskiran, nego je potpuno izostavljen iz DTO-a.
toDto eksplicitno odabire polja i stvara novi zapis (record). fromDto čita iste vrijednosti putem pristupnih metoda zapisa i stvara novi objekt User. DTO je neovisna snimka stanja, a ne pogled koji se stalno osvježava: promjena imena korisnika ne mijenja postojeći DTO. Zapis je samo plitko nepromjenjiv. Primitivne vrijednosti i nepromjenjivi objekti String ovdje ne dijele promjenjivo stanje. Ako dodaš promjenjive komponente, po potrebi napravi zaštitne kopije, uključujući pri izlaganju vrijednosti.
Mapiranje radi u oba smjera, ali nije potpuno reverzibilno: prelazak iz DTO-a u domenu i natrag čuva pet vrijednosti, ali ne vraća izostavljeno stanje. *** je samo zamjenska vrijednost za demonstraciju, a ne stvarna sažeta vrijednost lozinke niti mehanizam prijave. U produkciji provjeravaj ulazne podatke, ažuriraj postojeće objekte dopuštenim domenskim operacijama i zasebno upravljaj vjerodajnicama.
Primjeri
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));
}
}
Rezultat
original=Ada Lovelace snapshot=Ada rebuilt=Ada sameDto=true placeholder=true
Spremi kod kao `Main.java` i pokreni `java Main.java` s JDK-om 21. Nakon promjene imena izvornik prikazuje `Ada Lovelace`, dok snimka i ponovno izgrađeni objekt i dalje prikazuju `Ada`. `sameDto=true` odnosi se samo na pet polja DTO-a; `placeholder=true` potvrđuje upotrebu zamjenske vrijednosti.
Povezane lekcije
- Java · Lekcija 10 · Napredno · Verzija: 2
Izvori
- 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