Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Reťaziteľný builder s vlastným typom

Generický vlastný typ umožňuje volať metódy podtriedy aj po zdedenom volaní. `build()` vytvorí z aktuálneho stavu buildera samostatný výsledný objekt.

Verzia: Java SE 21

Syntax

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.

Meniteľný builder zhromažďuje nastavenia. tag(...) zmení aktuálny builder a cez self() vráti tú istú inštanciu, nie kópiu ani hotový produkt. Operátor == tu overuje totožnosť objektu, nie zhodu obsahu.

V TaskBuilder<S extends TaskBuilder<S>> sa S nachádza vo vlastnej hornej hranici. PriorityTaskBuilder dosadí za S svoj typ, takže po zdedenej metóde tag(...) možno hneď zavolať priority(...). Abstraktná metóda self() umožňuje konkrétnej triede vrátiť this bez nekontrolovaného pretypovania. Samotná hranica nevynucuje, aby podtrieda dosadila vlastný typ ani aby self() vrátila aktuálnu inštanciu.

Základná deklarácia build() vracia Task. Podtrieda buildera prepisuje metódu s kovariantným návratovým typom PriorityTask, podtypom Task. Ide o prepísanie, nie o preťaženie. Pri volaní cez referenciu base má výsledok statický typ Task, hoci sa vykoná metóda podtriedy.

Každé volanie build() vytvorí nový produkt, ktorý zachytí aktuálny stav. List.copyOf vráti nemodifikovateľný zoznam, ktorý neskoršie zmeny zoznamu buildera neovplyvnia. Ide o plytkú kópiu: prvky String sú nemenné, ale meniteľné prvky by na oddelenie svojho stavu vyžadovali ďalšie obranné kópie. tag(null) okamžite vyvolá NullPointerException, skôr než sa zoznam zmení.

Prí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ýsledok

true
first: draft
second: draft, review
priority: 5

`true` potvrdzuje, že reťazec volaní vracia ten istý builder. Pridanie `review` ovplyvní druhý výsledok, ale nie prvý.

Súvisiace lekcie

  • Java · Lekcia 3 · Pokročilá · Verzia: 2
  • Java · Lekcia 16 · Pokročilá · Verzia: 2

Zdroje