CKTIS / Java
Stupnjeviti graditelj pomoću sučelja
Stupnjeviti graditelj pomoću sučelja dijeli stvaranje objekta na tipizirane korake. Svaka metoda za prijelaz u sljedeću fazu vraća sučelje te faze, pa je u običnom nizu poziva `build()` dostupan tek nakon unosa potrebnih vrijednosti. To ne zamjenjuje provjeru tih vrijednosti tijekom izvođenja.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Start builder() → Start.host(String) : PortStep → PortStep.port(int) : Ready → Ready.build() : EndpointStupnjeviti graditelj pomoću sučelja obrazac je dizajna, a ne zasebna jezična konstrukcija Jave. Sučelja opisuju dostupne operacije u svakoj fazi. Povratni tip metode usmjerava pozivatelja na sljedeću fazu; implementacija može biti jedan objekt koji implementira sva sučelja faza.
U primjeru builder() vraća Start, host(String) vraća PortStep, a port(int) vraća Ready. Samo Ready deklarira build(). Zato se builder().build() ne može prevesti, dok builder().host("localhost").port(8080).build() stvara Endpoint. Običan fluent graditelj podržava ulančavanje poziva, ali samo vraćanje this ne nameće taj redoslijed.
Tipovi ovdje nameću redoslijed poziva, a ne valjanost argumenata. Metode i dalje provjeravaju da host nije prazan i da je port unutar dopuštenog raspona. Zaštita vrijedi pri korištenju deklariranih tipova faza: izričita pretvorba može zaobići predviđeni put jer objekt implementira svaku fazu. Zato build() dodatno provjerava jesu li potrebne vrijednosti prisutne.
Privatna implementacija skriva pojedinosti, ali promjenjivi graditelj nije namijenjen dijeljenju među dretvama. Sačuvane reference na ranije faze i dalje ga mogu mijenjati; faze se ne troše točno jednom. Rezultirajući Endpoint pohranjuje vlastita polja final. Ovaj obrazac koristite za nekoliko smislenih koraka; mnogo kombinacija obveznih polja može znatno povećati broj sučelja.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.