CKTIS / Java
DTO et objet métier : conversion explicite
Séparez les données qui franchissent une interface de l’état et du comportement métier. Convertissez explicitement cinq champs pour créer des instantanés indépendants sans `passwordHash`.
Version : Java SE 21
Syntaxe
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 est un objet métier : il conserve un état et expose des opérations métier comme rename. UserDto est un objet de transfert de données (DTO) : il définit les données qui franchissent une interface, par exemple dans une réponse d’API. Il contient exactement cinq champs : id, username, email, displayName et active. passwordHash n’est pas masqué, mais entièrement omis du DTO.
toDto sélectionne explicitement les champs et crée un nouveau record. fromDto lit les mêmes valeurs via les accesseurs du record et instancie un nouveau User. Le DTO est un instantané indépendant, pas une vue dynamique : renommer l’utilisateur ne change pas un DTO existant. Un record n’est immuable qu’en surface. Ici, les valeurs primitives et les objets String immuables ne partagent aucun état mutable. Si des composants sont mutables, faites des copies défensives au besoin, y compris lorsque vous exposez leurs valeurs.
La conversion fonctionne dans les deux sens, mais elle n’est pas entièrement réversible : l’aller-retour du DTO vers le domaine puis vers le DTO conserve les cinq valeurs sans pouvoir retrouver l’état omis. *** est une valeur de remplacement pour la démonstration, ni un vrai condensat de mot de passe ni un mécanisme de connexion. En production, validez les données entrantes, mettez à jour les objets existants par des opérations métier autorisées et gérez les données d’authentification séparément.
Exemples
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));
}
}
Résultat
original=Ada Lovelace snapshot=Ada rebuilt=Ada sameDto=true placeholder=true
Enregistrez le code dans `Main.java` et lancez `java Main.java` avec le JDK 21. Après le changement de nom, l’original affiche `Ada Lovelace`, mais l’instantané et l’objet reconstruit affichent toujours `Ada`. `sameDto=true` ne concerne que les cinq champs du DTO ; `placeholder=true` confirme l’emploi de la valeur de remplacement.
Leçons associées
- Java · Leçon 10 · Avancé · Version : 2
Sources
- 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