KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Builder in stappen via interfaces

Een builder in stappen via interfaces verdeelt het maken van een object in getypeerde stappen. Elke methode die naar de volgende stap overgaat, retourneert de interface van die stap. Daardoor is `build()` in een gewone aanroepketen pas beschikbaar nadat de vereiste invoer is opgegeven. Dit vervangt de runtimevalidatie van die invoer niet.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

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

Een builder in stappen via interfaces is een ontwerppatroon, geen afzonderlijke constructie van de Java-taal. Interfaces beschrijven de beschikbare bewerkingen per stap. Het retourtype van een methode leidt de aanroeper naar de volgende stap; de implementatie kan één object zijn dat alle stapinterfaces implementeert.

In het voorbeeld retourneert builder() een Start, host(String) retourneert een PortStep en port(int) retourneert een Ready. Alleen Ready declareert build(). Daarom compileert builder().build() niet, terwijl builder().host("localhost").port(8080).build() een Endpoint maakt. Een gewone fluent builder ondersteunt kettingaanroepen, maar alleen this retourneren dwingt deze volgorde niet af.

De types dwingen hier de volgorde van aanroepen af, niet de geldigheid van argumenten. De methoden controleren nog steeds of host niet leeg is en of port binnen het toegestane bereik valt. De bescherming geldt bij het gebruik van de gedeclareerde staptypes: expliciete casts kunnen de bedoelde route omzeilen, omdat het object elke stap implementeert. Daarom controleert build() ook of de vereiste waarden aanwezig zijn.

De private implementatie verbergt details, maar de veranderlijke builder is niet bedoeld om tussen threads te delen. Bewaarde verwijzingen naar eerdere stappen kunnen deze nog steeds wijzigen; stappen worden niet precies één keer verbruikt. De resulterende Endpoint slaat eigen final-velden op. Gebruik dit patroon voor enkele betekenisvolle stappen; veel combinaties van vereiste velden kunnen het aantal interfaces flink vergroten.

Voorbeelden

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().
    }
}

Resultaat

localhost:8080

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen