CKTIS / Java
DTO und Domänenobjekt: explizite Abbildung
Trenne die Daten an einer Schnittstelle vom Zustand und Verhalten der Domäne. Bilde fünf Felder explizit ab und erstelle unabhängige Momentaufnahmen ohne `passwordHash`.
Version: Java SE 21
Syntax
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 ist ein Domänenobjekt: Es hält Zustand und bietet fachliche Operationen wie rename an. UserDto ist ein Data Transfer Object (DTO) und legt fest, welche Daten eine Schnittstelle passieren, etwa in einer API-Antwort. Es enthält genau fünf Felder: id, username, email, displayName und active. passwordHash wird nicht maskiert, sondern vollständig weggelassen.
toDto wählt die Felder explizit aus und erzeugt einen neuen Record. fromDto liest dieselben Werte über die Zugriffsmethoden des Records und erzeugt ein neues User-Objekt. Das DTO ist eine unabhängige Momentaufnahme, keine laufend aktualisierte Sicht: Eine Namensänderung wirkt sich nicht auf ein bestehendes DTO aus. Records sind nur oberflächlich unveränderlich. Primitive Werte und unveränderliche String-Objekte teilen hier keinen veränderlichen Zustand. Bei veränderlichen Komponenten sind bei Bedarf defensive Kopien nötig, auch bei der Rückgabe von Werten.
Die Abbildung funktioniert in beide Richtungen, ist aber nicht vollständig umkehrbar: Der Weg vom DTO zum Domänenobjekt und zurück erhält die fünf Werte, kann aber weggelassenen Zustand nicht wiederherstellen. *** ist nur ein Platzhalter im Beispiel, kein echter Passwort-Hash und kein Anmeldemechanismus. Validiere in produktivem Code eingehende Daten, ändere vorhandene Objekte über zulässige Domänenoperationen und verwalte Zugangsdaten getrennt.
Beispiele
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));
}
}
Ergebnis
original=Ada Lovelace snapshot=Ada rebuilt=Ada sameDto=true placeholder=true
Speichere den Code als `Main.java` und führe ihn mit `java Main.java` unter JDK 21 aus. Nach der Umbenennung zeigt das Original `Ada Lovelace`; die Momentaufnahme und das daraus erzeugte Objekt zeigen weiter `Ada`. `sameDto=true` betrifft nur die fünf DTO-Felder; `placeholder=true` bestätigt den Platzhalter.
Zugehörige Lektionen
- Java · Lektion 10 · Fortgeschritten · Version: 2
Quellen
- 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