Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Builder fluide avec type propre

Un type propre générique préserve l’accès aux méthodes de la sous-classe après un appel hérité. `build()` crée un produit distinct à partir de l’état courant.

Version : Java SE 21

Syntaxe

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.

Un builder mutable accumule les paramètres. tag(...) modifie le builder courant et renvoie la même instance par l’intermédiaire de self(), et non une copie ou le produit fini. Ici, == compare l’identité des objets, pas leur contenu.

Dans TaskBuilder<S extends TaskBuilder<S>>, S figure dans sa propre borne supérieure. PriorityTaskBuilder fournit son propre type pour S, ce qui permet d’enchaîner la méthode héritée tag(...) avec priority(...). La méthode abstraite self() permet à la classe concrète de renvoyer this sans conversion de type non vérifiée. La borne seule n’impose ni que la sous-classe fournisse son propre type, ni que self() renvoie l’instance courante.

Dans la classe de base, build() renvoie un Task. La sous-classe du builder redéfinit la méthode avec le type de retour covariant PriorityTask, sous-type de Task : c’est une redéfinition, pas une surcharge. Via la référence base, le type statique du résultat reste Task, même si la méthode exécutée est celle de la sous-classe.

Chaque appel à build() crée un nouveau produit qui capture l’état courant. List.copyOf produit une liste non modifiable, indépendante des modifications ultérieures de la liste du builder. La copie est superficielle : les éléments String sont immuables, mais des éléments mutables nécessiteraient des copies défensives supplémentaires pour isoler leur état. tag(null) lève immédiatement une NullPointerException, avant toute modification de la liste.

Exemples

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

Résultat

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

`true` confirme que la chaîne renvoie le même builder. L’ajout de `review` affecte le deuxième résultat, mais pas le premier.

Leçons associées

  • Java · Leçon 3 · Avancé · Version : 2
  • Java · Leçon 16 · Avancé · Version : 2

Sources