Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

DTO in domenski objekt: eksplicitna preslikava

Loči podatke, ki prehajajo prek vmesnika, od stanja in vedenja domene. Z eksplicitno preslikavo petih polj ustvari neodvisne posnetke brez `passwordHash`.

Različica: Java SE 21

Sintaksa

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 domenski objekt: hrani stanje in omogoča domenske operacije, kot je rename. UserDto je objekt za prenos podatkov (DTO): določa, kateri podatki prehajajo prek vmesnika, na primer v odgovoru API-ja. Vsebuje natanko pet polj: id, username, email, displayName in active. passwordHash ni zakrit, temveč je v DTO-ju povsem izpuščen.

toDto izrecno izbere polja in ustvari nov zapis (record). fromDto prek dostopnih metod zapisa prebere iste vrednosti in ustvari nov objekt User. DTO je neodvisen posnetek, ne sproti posodobljen pogled: sprememba imena uporabnika ne spremeni obstoječega DTO-ja. Zapis je nespremenljiv le na površini. Primitivne vrednosti in nespremenljivi objekti String si tu ne delijo spremenljivega stanja. Pri spremenljivih komponentah po potrebi naredi obrambne kopije, tudi ob posredovanju vrednosti navzven.

Preslikava deluje v obe smeri, vendar ni povsem obrnljiva: preslikava iz DTO-ja v domeno in nazaj ohrani pet vrednosti, ne more pa obnoviti izpuščenega stanja. *** je le nadomestna vrednost za prikaz, ne prava zgoščena vrednost gesla ali prijavni mehanizem. V produkciji preverjaj vhodne podatke, obstoječe objekte posodabljaj z dovoljenimi domenskimi operacijami in prijavne podatke upravljaj ločeno.

Primeri

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

Rezultat

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

Shrani kodo kot `Main.java` in z JDK 21 zaženi `java Main.java`. Po preimenovanju izvirnik prikaže `Ada Lovelace`, posnetek in na novo ustvarjeni objekt pa še vedno prikažeta `Ada`. `sameDto=true` se nanaša le na pet polj DTO-ja; `placeholder=true` potrdi uporabo nadomestne vrednosti.

Povezane lekcije

  • Java · Lekcija 10 · Napredna · Različica: 2

Viri