CKTIS / Java
Płynny builder z typem własnym
Generyczny typ własny pozwala po odziedziczonej metodzie wywołać metodę konkretnego buildera. `build()` tworzy osobny obiekt ze stanem z chwili wywołania.
Wersja: Java SE 21
Składnia
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.Mutowalny builder gromadzi ustawienia. Metoda tag(...) zmienia bieżący builder i zwraca przez self() tę samą instancję, a nie kopię ani gotowy produkt. Operator == sprawdza tutaj tożsamość obiektu, nie równość zawartości.
W TaskBuilder<S extends TaskBuilder<S>> parametr S występuje we własnym ograniczeniu górnym. PriorityTaskBuilder podstawia za S swój typ, więc po odziedziczonej metodzie tag(...) można od razu wywołać priority(...). Abstrakcyjne self() pozwala klasie konkretnej zwrócić this bez niesprawdzanego rzutowania. Samo ograniczenie nie wymusza ani podania własnego typu przez podklasę, ani zwrócenia bieżącej instancji.
Bazowa deklaracja build() zwraca Task. Implementacja w podklasie buildera nadpisuje metodę z kowariantnym typem zwrotnym PriorityTask, podtypem Task; nie jest to przeciążenie. Przez referencję base statyczny typ wyniku to Task, choć w czasie wykonania nadal wywoływana jest metoda podklasy.
Każde build() tworzy nowy produkt i zachowuje stan z chwili wywołania. List.copyOf tworzy niemodyfikowalną listę, na którą późniejsze zmiany listy buildera nie wpływają. To kopia płytka: elementy String są niemutowalne, ale elementy mutowalne wymagałyby dodatkowych kopii obronnych, aby ich stan również pozostał niezależny. tag(null) zgłasza NullPointerException od razu, zanim lista się zmieni.
Przykłady
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());
}
}Wynik
true first: draft second: draft, review priority: 5
`true` potwierdza, że łańcuch zwraca ten sam builder. Dodanie `review` zmienia drugi wynik, ale nie pierwszy.
Powiązane lekcje
- Java · Lekcja 3 · Zaawansowany · Wersja: 2
- Java · Lekcja 16 · Zaawansowany · Wersja: 2
Źródła
- 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