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

CKTIS / Java

Stopenjski graditelj prek vmesnikov

Stopenjski graditelj prek vmesnikov razdeli ustvarjanje objekta na tipizirane korake. Vsaka metoda za prehod na naslednjo stopnjo vrne vmesnik te stopnje, zato je v običajni verigi klicev `build()` na voljo šele, ko so podani zahtevani vnosi. To ne nadomesti preverjanja teh vnosov med izvajanjem.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

Start builder() → Start.host(String) : PortStep → PortStep.port(int) : Ready → Ready.build() : Endpoint

Stopenjski graditelj prek vmesnikov je vzorec načrtovanja, ne posebna konstrukcija jezika Java. Vmesniki opisujejo razpoložljive operacije v posameznih stopnjah. Povratni tip metode usmerja klicatelja na naslednjo stopnjo; implementacija je lahko en sam objekt, ki implementira vse vmesnike stopenj.

V primeru builder() vrne Start, host(String) vrne PortStep, port(int) pa vrne Ready. Samo Ready deklarira build(). Zato se builder().build() ne prevede, medtem ko builder().host("localhost").port(8080).build() ustvari Endpoint. Običajen fluent graditelj omogoča veriženje klicev, vendar samo vračanje this tega vrstnega reda ne uveljavlja.

Tipi tukaj uveljavljajo vrstni red klicev, ne pa veljavnosti argumentov. Metode še vedno preverjajo, ali host ni prazen in ali je port v dovoljenem obsegu. Zaščita velja pri uporabi deklariranih tipov stopenj: z izrecno pretvorbo tipa je mogoče zaobiti predvideno pot, ker objekt implementira vse stopnje. Zato build() dodatno preveri, ali so zahtevane vrednosti prisotne.

Zasebna implementacija skrije podrobnosti, vendar spremenljivi graditelj ni namenjen skupni rabi med nitmi. Ohranjeni sklici na prejšnje stopnje ga lahko še vedno spreminjajo; stopnje se ne porabijo natanko enkrat. Nastali Endpoint shrani svoja polja final. Ta vzorec uporabite za nekaj pomembnih korakov; veliko kombinacij zahtevanih polj lahko znatno poveča število vmesnikov.

Primeri

public final class Main {
    public interface Start {
        PortStep host(String host);
    }

    public interface PortStep {
        Ready port(int port);
    }

    public interface Ready {
        Endpoint build();
    }

    public static final class Endpoint {
        private final String host;
        private final int port;

        private Endpoint(String host, int port) {
            this.host = host;
            this.port = port;
        }

        @Override
        public String toString() {
            return host + ":" + port;
        }
    }

    private static final class Builder implements Start, PortStep, Ready {
        private String host;
        private int port;

        @Override
        public PortStep host(String host) {
            if (host == null || host.isBlank()) {
                throw new IllegalArgumentException("host must not be blank");
            }
            this.host = host;
            return this;
        }

        @Override
        public Ready port(int port) {
            if (port < 1 || port > 65535) {
                throw new IllegalArgumentException("port out of range");
            }
            this.port = port;
            return this;
        }

        @Override
        public Endpoint build() {
            if (host == null || port == 0) {
                throw new IllegalStateException("missing required values");
            }
            return new Endpoint(host, port);
        }
    }

    public static Start builder() {
        return new Builder();
    }

    public static void main(String[] args) {
        Endpoint endpoint = builder().host("localhost").port(8080).build();
        System.out.println(endpoint);
        // builder().build(); // Does not compile: Start has no build().
    }
}

Rezultat

localhost:8080

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri