CKTIS / Java
DTO in domenski objekt: eksplicitna preslikava
Loči podatke, ki prehajajo prek vmesnika, od stanja in vedenja domene. Z eksplicitno preslikavo petih polj ustvari neodvisne posnetke brez `passwordHash`.
Različica: 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: hrani stanje in omogoča domenske operacije, kot je rename. UserDto je objekt za prenos podatkov (DTO): določa, kateri podatki prehajajo prek vmesnika, na primer v odgovoru API-ja. Vsebuje natanko pet polj: id, username, email, displayName in active. passwordHash ni zakrit, temveč je v DTO-ju povsem izpuščen.
toDto izrecno izbere polja in ustvari nov zapis (record). fromDto prek dostopnih metod zapisa prebere iste vrednosti in ustvari nov objekt User. DTO je neodvisen posnetek, ne sproti posodobljen pogled: sprememba imena uporabnika ne spremeni obstoječega DTO-ja. Zapis je nespremenljiv le na površini. Primitivne vrednosti in nespremenljivi objekti String si tu ne delijo spremenljivega stanja. Pri spremenljivih komponentah po potrebi naredi obrambne kopije, tudi ob posredovanju vrednosti navzven.
Preslikava deluje v obe smeri, vendar ni povsem obrnljiva: preslikava iz DTO-ja v domeno in nazaj ohrani pet vrednosti, ne more pa obnoviti izpuščenega stanja. *** je le nadomestna vrednost za prikaz, ne prava zgoščena vrednost gesla ali prijavni mehanizem. V produkciji preverjaj vhodne podatke, obstoječe objekte posodabljaj z dovoljenimi domenskimi operacijami in prijavne podatke upravljaj ločeno.
Primeri
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
Shrani kodo kot `Main.java` in z JDK 21 zaženi `java Main.java`. Po preimenovanju izvirnik prikaže `Ada Lovelace`, posnetek in na novo ustvarjeni objekt pa še vedno prikažeta `Ada`. `sameDto=true` se nanaša le na pet polj DTO-ja; `placeholder=true` potrdi uporabo nadomestne vrednosti.
Povezane lekcije
- Java · Lekcija 10 · Napredna · Različica: 2
Viri
- 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