Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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