CKTIS / Java
Řetězitelný builder s vlastním typem
Generický vlastní typ zpřístupňuje metody podtřídy i po volání zděděné metody. `build()` z aktuálního stavu builderu vytvoří samostatný výsledný objekt.
Verze: Java SE 21
Syntaxe
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.Měnitelný builder shromažďuje nastavení. tag(...) upraví aktuální builder a přes self() vrátí tutéž instanci, nikoli kopii ani hotový produkt. Operátor == zde ověřuje totožnost objektu, ne shodu obsahu.
V TaskBuilder<S extends TaskBuilder<S>> se S objevuje ve vlastní horní mezi. PriorityTaskBuilder dosadí za S svůj typ, takže po zděděné metodě tag(...) lze hned zavolat priority(...). Abstraktní metoda self() umožňuje konkrétní třídě vrátit this bez nekontrolovaného přetypování. Samotná mez nezaručuje, že podtřída dosadí vlastní typ ani že self() vrátí aktuální instanci.
Základní deklarace build() vrací Task. Podtřída builderu metodu přepisuje s kovariantním návratovým typem PriorityTask, podtypem Task. Jde o přepsání, nikoli přetížení. Při volání přes referenci base má výsledek statický typ Task, přestože se vykoná metoda podtřídy.
Každé volání build() vytvoří nový produkt zachycující aktuální stav. List.copyOf vrátí nemodifikovatelný seznam, který pozdější změny seznamu builderu neovlivní. Jde o mělkou kopii: prvky String jsou neměnné, ale měnitelné prvky by pro oddělení svého stavu vyžadovaly další obranné kopie. tag(null) okamžitě vyvolá NullPointerException, ještě před změnou seznamu.
Příklady
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());
}
}Výsledek
true first: draft second: draft, review priority: 5
`true` potvrzuje, že řetězec volání vrací tentýž builder. Přidání `review` ovlivní druhý výsledek, ale ne první.
Související lekce
- Java · Lekce 3 · Pokročilá · Verze: 2
- Java · Lekce 16 · Pokročilá · Verze: 2
Zdroje
- 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