Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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