Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Lančani graditelj s vlastitim tipom

Generički vlastiti tip zadržava pristup metodama podklase nakon naslijeđenog poziva. `build()` iz trenutačnog stanja graditelja stvara zaseban gotov objekt.

Verzija: 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.

Promjenjivi graditelj prikuplja postavke. tag(...) mijenja trenutačni graditelj i putem self() vraća istu instancu, a ne kopiju ili gotov proizvod. Operator == ovdje provjerava identitet objekta, ne jednakost sadržaja.

U TaskBuilder<S extends TaskBuilder<S>> parametar S pojavljuje se u vlastitoj gornjoj granici. PriorityTaskBuilder kao S zadaje vlastiti tip, pa nakon naslijeđene metode tag(...) možemo odmah pozvati priority(...). Apstraktna metoda self() omogućuje konkretnoj klasi da vrati this bez neprovjerene pretvorbe tipa. Sama granica ne zahtijeva da podklasa zada vlastiti tip niti da self() vrati trenutačnu instancu.

Osnovna deklaracija build() vraća Task. Podklasa graditelja nadjačava metodu kovarijantnim povratnim tipom PriorityTask, podtipom tipa Task. Riječ je o nadjačavanju, ne o preopterećenju. Pri pozivu putem reference base rezultat ima statički tip Task, iako se izvršava metoda podklase.

Svaki poziv metode build() stvara nov proizvod koji bilježi trenutačno stanje. List.copyOf vraća popis koji se ne može mijenjati i na koji ne utječu kasnije izmjene popisa graditelja. Kopija je plitka: elementi tipa String nepromjenjivi su, ali za odvajanje stanja promjenjivih elemenata trebale bi dodatne obrambene kopije. tag(null) odmah baca NullPointerException, prije promjene popisa.

Primjeri

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` potvrđuje da lanac poziva vraća isti graditelj. Dodavanje oznake `review` utječe na drugi rezultat, ali ne i na prvi.

Povezane lekcije

  • Java · Lekcija 3 · Napredno · Verzija: 2
  • Java · Lekcija 16 · Napredno · Verzija: 2

Izvori