Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

DTO a model domenowy: jawne mapowanie

Oddziel dane przesyłane przez granicę systemu od stanu i zachowania domeny. Jawnie mapuj pięć pól, tworząc niezależne migawki bez `passwordHash`.

Wersja: Java SE 21

Składnia

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 to obiekt domenowy: przechowuje stan i udostępnia operacje domenowe, takie jak rename. UserDto to obiekt transferu danych (DTO), czyli kontrakt przekazywania danych przez granicę, np. do klienta API. Ma dokładnie pięć pól: id, username, email, displayName i active. passwordHash pozostaje poza DTO: pole nie jest maskowane, lecz całkowicie pominięte.

toDto jawnie wybiera pola i tworzy nowy rekord. fromDto odczytuje te same wartości za pomocą akcesorów rekordu i tworzy nowy obiekt User. DTO jest niezależną migawką, a nie widokiem aktualizowanym na bieżąco: rename zmienia tylko nazwę wyświetlaną (displayName) w obiekcie User, nie zmieniając pola username ani wcześniej utworzonego DTO. Rekord jest niezmienny tylko płytko; tutaj typy proste i niezmienne obiekty String nie współdzielą mutowalnego stanu. Dla mutowalnych składników trzeba zadbać o kopie ochronne, również przy udostępnianiu wartości, jeśli to konieczne.

Mapowanie działa w obu kierunkach, ale nie jest odwracalne w pełni: przejście z DTO do domeny i z powrotem zachowuje pięć wartości, lecz nie odzyskuje pominiętego stanu. *** to wyłącznie wartość zastępcza na potrzeby demonstracji, nie prawdziwy skrót hasła ani mechanizm logowania. W aplikacji produkcyjnej waliduj dane wejściowe, aktualizuj istniejący obiekt za pomocą dozwolonych operacji domenowych i zarządzaj danymi uwierzytelniającymi osobno.

Przykłady

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

Wynik

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

Zapisz kod jako `Main.java` i uruchom `java Main.java` w JDK 21. Po zmianie nazwy oryginał ma wartość `Ada Lovelace`, a migawka i odtworzony obiekt nadal mają `Ada`. `sameDto=true` dotyczy tylko pięciu pól DTO, a `placeholder=true` wskazuje użycie wartości zastępczej.

Powiązane lekcje

  • Java · Lekcja 10 · Zaawansowany · Wersja: 2

Źródła