CKTIS / Java
DTO и домейнен обект: явно преобразуване
Отделете данните, които преминават през интерфейс, от състоянието и поведението на домейна. Преобразувайте явно пет полета, за да създадете независими моментни снимки без `passwordHash`.
Версия: Java SE 21
Синтаксис
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 е домейнен обект: пази състояние и предоставя домейн операции като rename. UserDto е обект за пренос на данни (DTO): определя кои данни преминават през интерфейс, например в отговор от API. Има точно пет полета: id, username, email, displayName и active. passwordHash не се маскира, а изобщо не присъства в DTO.
toDto явно избира полетата и създава нов запис (record). fromDto прочита същите стойности чрез методите за достъп на записа и създава нов обект User. DTO е независима моментна снимка, а не изглед, който се обновява: преименуването на потребителя не променя вече създаден DTO. Неизменяемостта на записа е само повърхностна. Тук примитивните стойности и неизменяемите обекти String не споделят изменяемо състояние. При изменяеми компоненти използвайте защитни копия, когато е необходимо, включително при предоставяне на стойностите.
Преобразуването работи в двете посоки, но не е напълно обратимо: преминаването от DTO към домейна и обратно запазва петте стойности, но не възстановява пропуснатото състояние. *** е само заместваща стойност за демонстрацията, а не истински хеш на парола или механизъм за вход. В реална система валидирайте входните данни, обновявайте съществуващите обекти чрез разрешени домейн операции и управлявайте данните за вход отделно.
Примери
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));
}
}
Резултат
original=Ada Lovelace snapshot=Ada rebuilt=Ada sameDto=true placeholder=true
Запишете кода като `Main.java` и изпълнете `java Main.java` с JDK 21. След преименуването оригиналът показва `Ada Lovelace`, а моментната снимка и новосъздаденият обект все още показват `Ada`. `sameDto=true` се отнася само за петте полета на DTO; `placeholder=true` потвърждава използването на заместващата стойност.
Свързани уроци
- Java · Урок 10 · Напреднало · Версия: 2
Източници
- 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