CKTIS / Java
Verižni graditelj z lastnim tipom
Generični lastni tip ohrani dostop do metod podrazreda po podedovanem klicu. `build()` iz trenutnega stanja graditelja ustvari ločen končni objekt.
Različica: Java SE 21
Sintaksa
Declaration sketch (method bodies omitted):
abstract class TaskBuilder<S extends TaskBuilder<S>> {
protected abstract S self();
public final S tag(String value) { /* mutate this builder, then return self() */ }
public abstract Task build();
}
final class PriorityTaskBuilder extends TaskBuilder<PriorityTaskBuilder> {
@Override protected PriorityTaskBuilder self() { return this; }
@Override public PriorityTask build() { /* return a new product */ }
}
// PriorityTask extends Task.Spremenljiv graditelj zbira nastavitve. tag(...) spremeni trenutni graditelj in prek self() vrne isti primerek, ne kopije ali končnega objekta. Operator == tu preverja identiteto objekta, ne enakosti vsebine.
V TaskBuilder<S extends TaskBuilder<S>> se S pojavi v svoji zgornji meji. PriorityTaskBuilder za S uporabi lastni tip, zato lahko podedovanemu klicu tag(...) sledi priority(...). Abstraktna metoda self() konkretni razred omogoča, da vrne this brez nepreverjene pretvorbe tipa. Sama meja ne zahteva, da podrazred uporabi lastni tip ali da self() vrne trenutni primerek.
Osnovna deklaracija build() vrača Task. Podrazred graditelja prepiše metodo s kovariantnim povratnim tipom PriorityTask, ki je podtip Task. Gre za prepisovanje, ne za preobremenjevanje. Pri klicu prek reference base ima rezultat statični tip Task, čeprav se izvede metoda podrazreda.
Vsak klic build() ustvari nov objekt, ki zajame trenutno stanje. List.copyOf vrne nespremenljiv seznam, na katerega poznejše spremembe seznama graditelja ne vplivajo. Kopija je plitva: elementi String so nespremenljivi, pri spremenljivih elementih pa bi za ločitev njihovega stanja potrebovali dodatne obrambne kopije. tag(null) takoj sproži NullPointerException, še preden se seznam spremeni.
Primeri
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
public class FluentBuilderDemo {
static class Task {
private final List<String> tags;
private Task(TaskBuilder<?> builder) {
tags = List.copyOf(builder.tags);
}
public final List<String> tags() {
return tags;
}
}
static final class PriorityTask extends Task {
private final int priority;
private PriorityTask(PriorityTaskBuilder builder) {
super(builder);
priority = builder.priority;
}
public int priority() {
return priority;
}
}
static abstract class TaskBuilder<S extends TaskBuilder<S>> {
private final List<String> tags = new ArrayList<>();
protected abstract S self();
public final S tag(String value) {
tags.add(Objects.requireNonNull(value, "tag"));
return self();
}
public abstract Task build();
}
static final class PriorityTaskBuilder extends TaskBuilder<PriorityTaskBuilder> {
private int priority;
@Override
protected PriorityTaskBuilder self() {
return this;
}
public PriorityTaskBuilder priority(int value) {
priority = value;
return self();
}
@Override
public PriorityTask build() {
return new PriorityTask(this);
}
}
public static void main(String[] args) {
PriorityTaskBuilder builder = new PriorityTaskBuilder();
System.out.println(builder.tag("draft").priority(5) == builder);
TaskBuilder<PriorityTaskBuilder> base = builder;
Task first = base.build();
PriorityTask second = builder.tag("review").build();
System.out.println("first: " + String.join(", ", first.tags()));
System.out.println("second: " + String.join(", ", second.tags()));
System.out.println("priority: " + second.priority());
}
}Rezultat
true first: draft second: draft, review priority: 5
`true` potrjuje, da veriga klicev vrne isti graditelj. Dodajanje `review` vpliva na drugi rezultat, ne pa na prvega.
Povezane lekcije
- Java · Lekcija 3 · Napredna · Različica: 2
- Java · Lekcija 16 · Napredna · Različica: 2
Viri
- Java Language Specification, Java SE 21, §4.4: Type Variables
- Java Language Specification, Java SE 21, §8.4.5: Method Result
- Java Language Specification, Java SE 21, §15.21.3: Reference Equality Operators == and !=
- Java SE 21 API: List.copyOf(Collection)
- Java SE 21 API: Objects.requireNonNull(T)
- JDK 21 Tool Specifications: The javac Command