CKTIS / Java
DTO y objeto de dominio: mapeo explícito
Separa los datos que cruzan una interfaz del estado y el comportamiento del dominio. Mapea cinco campos de forma explícita para crear instantáneas independientes sin `passwordHash`.
Versión: Java SE 21
Sintaxis
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 es un objeto de dominio: mantiene estado y ofrece operaciones de dominio como rename. UserDto es un objeto de transferencia de datos (DTO) que define qué datos cruzan una interfaz, por ejemplo en una respuesta de API. Tiene exactamente cinco campos: id, username, email, displayName y active. passwordHash no se enmascara: se omite por completo del DTO.
toDto selecciona los campos explícitamente y crea un nuevo record. fromDto lee los mismos valores mediante los métodos de acceso del record y construye un nuevo User. El DTO es una instantánea independiente, no una vista dinámica: cambiar el nombre del usuario no altera un DTO existente. La inmutabilidad del record es superficial. Aquí, los valores primitivos y los objetos String inmutables no comparten estado mutable. Si añades componentes mutables, haz copias defensivas cuando sea necesario, también al exponer sus valores.
El mapeo funciona en ambos sentidos, pero no es totalmente reversible: ir del DTO al dominio y volver conserva los cinco valores, pero no recupera el estado omitido. *** es solo un valor de sustitución para la demostración, no un hash de contraseña real ni un mecanismo de inicio de sesión. En producción, valida los datos de entrada, actualiza los objetos existentes mediante operaciones de dominio permitidas y gestiona las credenciales por separado.
Ejemplos
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));
}
}
Resultado
original=Ada Lovelace snapshot=Ada rebuilt=Ada sameDto=true placeholder=true
Guarda el código como `Main.java` y ejecuta `java Main.java` con el JDK 21. Tras el cambio de nombre, el original muestra `Ada Lovelace`, mientras que la instantánea y el objeto reconstruido siguen mostrando `Ada`. `sameDto=true` solo se refiere a los cinco campos del DTO; `placeholder=true` confirma el uso del valor de sustitución.
Lecciones relacionadas
- Java · Lección 10 · Avanzado · Versión: 2
Fuentes
- 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