Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Verižni graditelj z lastnim tipom

Generični lastni tip ohrani dostop do metod podrazreda po podedovanem klicu. `build()` iz trenutnega stanja graditelja ustvari ločen končni objekt.

Različica: Java SE 21

Sintaksa

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.

Spremenljiv graditelj zbira nastavitve. tag(...) spremeni trenutni graditelj in prek self() vrne isti primerek, ne kopije ali končnega objekta. Operator == tu preverja identiteto objekta, ne enakosti vsebine.

V TaskBuilder<S extends TaskBuilder<S>> se S pojavi v svoji zgornji meji. PriorityTaskBuilder za S uporabi lastni tip, zato lahko podedovanemu klicu tag(...) sledi priority(...). Abstraktna metoda self() konkretni razred omogoča, da vrne this brez nepreverjene pretvorbe tipa. Sama meja ne zahteva, da podrazred uporabi lastni tip ali da self() vrne trenutni primerek.

Osnovna deklaracija build() vrača Task. Podrazred graditelja prepiše metodo s kovariantnim povratnim tipom PriorityTask, ki je podtip Task. Gre za prepisovanje, ne za preobremenjevanje. Pri klicu prek reference base ima rezultat statični tip Task, čeprav se izvede metoda podrazreda.

Vsak klic build() ustvari nov objekt, ki zajame trenutno stanje. List.copyOf vrne nespremenljiv seznam, na katerega poznejše spremembe seznama graditelja ne vplivajo. Kopija je plitva: elementi String so nespremenljivi, pri spremenljivih elementih pa bi za ločitev njihovega stanja potrebovali dodatne obrambne kopije. tag(null) takoj sproži NullPointerException, še preden se seznam spremeni.

Primeri

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());
    }
}

Rezultat

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

`true` potrjuje, da veriga klicev vrne isti graditelj. Dodajanje `review` vpliva na drugi rezultat, ne pa na prvega.

Povezane lekcije

  • Java · Lekcija 3 · Napredna · Različica: 2
  • Java · Lekcija 16 · Napredna · Različica: 2

Viri