CKTIS / Java
DTO e objeto de domínio: mapeamento explícito
Separa os dados que atravessam uma interface do estado e comportamento do domínio. Mapeia explicitamente cinco campos para criar instantâneos independentes sem `passwordHash`.
Versão: Java SE 21
Sintaxe
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 é um objeto de domínio: guarda estado e disponibiliza operações de domínio como rename. UserDto é um objeto de transferência de dados (DTO): define os dados que atravessam uma interface, por exemplo numa resposta de uma API. Tem exatamente cinco campos: id, username, email, displayName e active. passwordHash não é mascarado, mas omitido por completo do DTO.
toDto seleciona os campos explicitamente e cria um novo record. fromDto lê os mesmos valores através dos métodos de acesso do record e cria um novo User. O DTO é um instantâneo independente, não uma vista dinâmica: alterar o nome do utilizador não modifica um DTO existente. Um record só é superficialmente imutável. Aqui, os valores primitivos e os objetos String imutáveis não partilham estado mutável. Se acrescentares componentes mutáveis, usa cópias defensivas quando necessário, incluindo ao expor os valores.
O mapeamento funciona nos dois sentidos, mas não é totalmente reversível: passar do DTO para o domínio e voltar preserva os cinco valores, mas não recupera o estado omitido. *** é apenas um marcador para a demonstração, não um hash real da palavra-passe nem um mecanismo de início de sessão. Em produção, valida os dados recebidos, atualiza os objetos existentes através de operações de domínio permitidas e gere as credenciais em separado.
Exemplos
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 o código em `Main.java` e executa `java Main.java` com o JDK 21. Após a alteração do nome, o original mostra `Ada Lovelace`, mas o instantâneo e o objeto reconstruído continuam a mostrar `Ada`. `sameDto=true` refere-se apenas aos cinco campos do DTO; `placeholder=true` confirma o uso do marcador.
Lições relacionadas
- Java · Lição 10 · Avançado · Versão: 2
Fontes
- 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