Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

DTO a doménový objekt: explicitní mapování

Oddělte data přenášená přes rozhraní od stavu a chování domény. Explicitním mapováním pěti polí vytvoříte nezávislé snímky dat bez `passwordHash`.

Verze: 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 je doménový objekt: uchovává stav a nabízí doménové operace, například rename. UserDto je objekt pro přenos dat (DTO): určuje, která data procházejí rozhraním, například v odpovědi API. Má přesně pět polí: id, username, email, displayName a active. passwordHash se nemaskuje, v DTO vůbec není.

toDto explicitně vybere pole a vytvoří nový záznam (record). fromDto přečte stejné hodnoty pomocí přístupových metod záznamu a vytvoří nový objekt User. DTO je nezávislý snímek, nikoli průběžně aktualizovaný pohled: změna jména uživatele existující DTO nezmění. Záznam je neměnný jen mělce. Primitivní hodnoty a neměnné objekty String zde nesdílejí žádný měnitelný stav. U měnitelných komponent podle potřeby vytvářejte obranné kopie, a to i při zpřístupňování hodnot.

Mapování funguje oběma směry, ale není plně vratné: převod z DTO do domény a zpět zachová pět hodnot, ale neobnoví vynechaný stav. *** je pouze zástupná hodnota pro ukázku, nikoli skutečný hash hesla ani mechanismus přihlašování. V produkci ověřujte vstupní data, existující objekty aktualizujte povolenými doménovými operacemi a přihlašovací údaje spravujte odděleně.

Příklady

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));
    }
}

Výsledek

original=Ada Lovelace
snapshot=Ada
rebuilt=Ada
sameDto=true
placeholder=true

Uložte kód jako `Main.java` a spusťte `java Main.java` pomocí JDK 21. Po přejmenování ukazuje původní objekt `Ada Lovelace`, zatímco snímek a nově sestavený objekt stále ukazují `Ada`. `sameDto=true` se týká jen pěti polí DTO; `placeholder=true` potvrzuje použití zástupné hodnoty.

Související lekce

  • Java · Lekce 10 · Pokročilá · Verze: 2

Zdroje