CKTIS / Java
Builder fluido con tipo propio
Un tipo propio genérico conserva el acceso a los métodos de la subclase tras una llamada heredada. `build()` crea un producto independiente a partir del estado actual.
Versión: Java SE 21
Sintaxis
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 acumula opciones de configuración. tag(...) modifica el builder actual y devuelve esa misma instancia mediante self(), no una copia ni el producto terminado. Aquí == comprueba la identidad del objeto, no la igualdad de su contenido.
En TaskBuilder<S extends TaskBuilder<S>>, S aparece en su propio límite superior. PriorityTaskBuilder usa su propio tipo como S, de modo que tras la llamada heredada a tag(...) se puede llamar a priority(...). El método abstracto self() permite a la clase concreta devolver this sin una conversión de tipo no comprobada. El límite por sí solo no exige que una subclase use su propio tipo ni que self() devuelva la instancia actual.
La declaración base de build() devuelve Task. La subclase del builder sobrescribe el método con el tipo de retorno covariante PriorityTask, un subtipo de Task; no es una sobrecarga. A través de la referencia base, el resultado tiene el tipo estático Task, aunque se ejecuta el método de la subclase.
Cada llamada a build() crea un producto nuevo que captura el estado actual. List.copyOf devuelve una lista no modificable a la que no afectan los cambios posteriores en la lista del builder. La copia es superficial: los elementos String son inmutables, pero los elementos mutables requerirían copias defensivas adicionales para aislar su estado. tag(null) lanza NullPointerException de inmediato, antes de modificar la lista.
Ejemplos
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());
}
}Resultado
true first: draft second: draft, review priority: 5
`true` confirma que la cadena devuelve el mismo builder. Añadir `review` afecta al segundo resultado, pero no al primero.
Lecciones relacionadas
- Java · Lección 3 · Avanzado · Versión: 2
- Java · Lección 16 · Avanzado · Versión: 2
Fuentes
- Java Language Specification, Java SE 21, §4.4: Type Variables
- Java Language Specification, Java SE 21, §8.4.5: Method Result
- Java Language Specification, Java SE 21, §15.21.3: Reference Equality Operators == and !=
- Java SE 21 API: List.copyOf(Collection)
- Java SE 21 API: Objects.requireNonNull(T)
- JDK 21 Tool Specifications: The javac Command