CKTIS / Java
Верижен builder със собствен тип
Параметърът за собствен тип запазва достъпа до методите на подкласа след наследено извикване. `build()` създава отделен обект от текущото състояние на builder-а.
Версия: Java SE 21
Синтаксис
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.Изменяемият builder събира настройки. tag(...) променя текущия builder и чрез self() връща същата инстанция, а не копие или готов продукт. Тук == проверява дали референциите сочат към един и същ обект, а не дали съдържанието е еднакво.
В TaskBuilder<S extends TaskBuilder<S>> параметърът S участва в собствената си горна граница. PriorityTaskBuilder подава собствения си тип като S, затова след наследения tag(...) може веднага да се извика priority(...). Абстрактният метод self() позволява на конкретния клас да върне this без непроверено преобразуване на типа. Самата граница не налага нито подкласът да подаде собствения си тип, нито self() да върне текущата инстанция.
Базовата декларация на build() връща Task. Подкласът на builder-а предефинира метода с ковариантен тип на резултата PriorityTask, подтип на Task. Това е предефиниране, а не претоварване. При извикване чрез референцията base статичният тип на резултата е Task, въпреки че се изпълнява методът на подкласа.
Всяко извикване на build() създава нов продукт, който запазва текущото състояние. List.copyOf връща списък, който не може да се променя и не се влияе от последващи промени в списъка на builder-а. Копието е плитко: елементите от тип String са неизменяеми, но за отделяне на състоянието на изменяеми елементи биха били нужни допълнителни защитни копия. tag(null) хвърля NullPointerException веднага, преди списъкът да се промени.
Примери
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());
}
}Резултат
true first: draft second: draft, review priority: 5
`true` потвърждава, че веригата връща същия builder. Добавянето на `review` засяга втория резултат, но не и първия.
Свързани уроци
- Java · Урок 3 · Напреднало · Версия: 2
- Java · Урок 16 · Напреднало · Версия: 2
Източници
- 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