Builder: objetos con muchas opciones
- Lección 7 de 32
- 10 min
- Inicial
- 13 pasos
Cuando un objeto tiene muchas opciones, el constructor se vuelve una fila de argumentos que nadie entiende. Builder lo arma paso a paso y te lo entrega listo.
- petición
- respuesta
- petición fallida
Paso 1 de 13
Problema
Un constructor que nadie puede leer
Imagina una clase Request para llamar a una API: URL, método, cabeceras, cuerpo, timeout, reintentos, caché. Casi todo es opcional, así que el constructor termina con siete argumentos en fila.
Lee la llamada del panel: ¿qué significan los dos null? ¿Y true, false? Para saberlo tienes que abrir la clase. Y si cambias el orden de dos argumentos del mismo tipo, el compilador no se queja.
Qué cambió
- Request con 7 argumentos por posición
Paso 2 de 13
Problema
La salida fácil: setters uno por uno
Otra opción es crear el objeto vacío y llenarlo con setMethod(), setTimeout() y compañía. Se lee mejor, pero el objeto existe a medio armar entre una llamada y otra.
En el panel, send(r) sale antes de que alguien le ponga el timeout. Nada lo impide: el objeto no sabe cuándo está completo, y cualquiera puede cambiarlo después de enviarlo.
Qué cambió
- Request se arma con setters
- Un envío con el objeto incompleto
Paso 3 de 13
Concepto
Un ayudante que arma el objeto
El patrón Builder (uno de los creacionales del libro de Gamma, Helm, Johnson y Vlissides, 1994) separa armar un objeto de usarlo. Tu código ya no le habla a Request: le habla a un RequestBuilder.
El builder guarda las opciones mientras las vas eligiendo y ya trae valores por defecto. El Request todavía no existe: por eso aparece apagado.
Qué cambió
- RequestBuilder entre tu código y Request
- Request todavía no se crea
Paso 4 de 13
Técnica
Pasos con nombre, encadenados
Cada opción es un método con nombre: .post(), .header("Accept", "application/json"), .timeout(2000). Cada uno guarda el dato y hace return this, así puedes encadenar la siguiente llamada.
Ahora la llamada se explica sola: no hay null de relleno y el orden de los pasos no importa. Lo que no necesitas, simplemente no lo llamas.
Qué cambió
- Tres pasos encadenados: post, header, timeout
Paso 5 de 13
Técnica
Lo que no eliges ya tiene un valor
El builder empieza con valores sensatos, por ejemplo método GET y timeout de 5000 ms (valores de ejemplo). Cada paso cambia solo lo suyo: en el panel ves qué cambió y qué quedó como estaba.
Es lo mismo que hace la API real de Java: en HttpRequest.Builder el método es GET salvo que pidas otro.
Qué cambió
- Valores por defecto en el builder
Paso 6 de 13
Solución
build(): validar una vez y entregar
El último paso es build(). Ahí, y solo ahí, el builder revisa el conjunto (por ejemplo, que el timeout sea mayor que cero) y crea el Request con todo listo.
Como el objeto se entrega terminado, puede ser inmutable: Object.freeze en TypeScript, solo getters en Java. Nadie lo ve a medio armar y nadie lo cambia después de enviarlo.
Qué cambió
- build() crea Request
- Request inmutable
Paso 7 de 13
Problema
Si algo está mal, falla antes de existir
Pide .timeout(0) y llama a build(): el builder lanza un error y el Request nunca se crea. No hay un objeto inválido dando vueltas por tu aplicación.
La API de Java hace lo mismo en dos puntos: timeout() rechaza una duración que no sea positiva y build() lanza IllegalStateException si falta la URI.
Qué cambió
- timeout(0) lanza un error en build()
- Ningún Request inválido
Paso 8 de 13
Técnica
Caso real: variantes desde una base
En Java, HttpRequest.newBuilder(uri) te da un builder. Puedes configurar una base con las cabeceras comunes y sacar copias con copy(): cada copia se modifica sin tocar la base.
Del mismo builder salen un get y un post, los dos inmutables. Es útil cuando muchas peticiones comparten casi todo y cambian en un detalle.
Qué cambió
- copy() de un builder base
- Dos Request: get y post
Paso 9 de 13
Concepto
Caso real: un query builder
Knex, una librería de Node para SQL, se llama a sí misma query builder: knex("users").where("id", 1).first() arma la consulta paso a paso.
La consulta no va a la base de datos con cada paso: se ejecuta cuando haces await. Y si solo quieres ver qué armaste, .toString() te devuelve el SQL como texto.
Qué cambió
- El builder ahora es Knex
- La base de datos solo recibe la consulta al hacer await
Paso 10 de 13
Concepto
La forma clásica: interfaz y director
En el libro original, Builder busca algo más: que el mismo proceso de construcción produzca representaciones distintas. Para eso el builder es una interfaz (ReportBuilder) con varias implementaciones.
Un Director conoce el orden de los pasos (título, luego tabla) y llama a la interfaz. Le pasas un HtmlBuilder o un PdfBuilder y obtienes el mismo informe en otro formato, sin tocar el Director.
Qué cambió
- Interfaz ReportBuilder
- HtmlBuilder y PdfBuilder la implementan
- Director llama a la interfaz
Paso 11 de 13
Compromiso
Cuándo no usarlo: un objeto de opciones basta
En TypeScript y JavaScript tienes algo que Java no trae: objetos literales. createRequest({ url, method: "POST", timeoutMs: 2000 }) ya da parámetros con nombre, y los opcionales toman su valor por defecto.
Si son pocos campos y no hay que validarlos en conjunto, un objeto de opciones es menos código y se lee igual de bien. Y no confundas: no toda API con métodos encadenados es un Builder.
Qué cambió
- Sin builder
- createRequest con un objeto de opciones
Paso 12 de 13
Compromiso
Lo que pagas por el builder
El builder es una clase más que crece en paralelo: cada campo nuevo de Request pide su método en el builder. Si se te olvida uno, esa opción no se puede elegir.
Y un error típico: encadenar todos los pasos y olvidar build(). Lo que tienes en la mano es el builder, no el Request, y el error aparece lejos de donde lo escribiste.
Qué cambió
- Una clase que mantener en paralelo
- Request no existe si olvidas build()
Paso 13 de 13
Resumen
Resumen
Builder arma un objeto con muchas opciones mediante pasos con nombre y lo entrega en build(), validado y, de preferencia, inmutable.
Lo encuentras en HttpRequest.newBuilder() de Java y en query builders como Knex. Úsalo cuando hay muchas opciones que validar juntas o variantes que armar; con pocos campos, un objeto de opciones es suficiente.
Qué cambió
- El flujo completo: pasos, build() y Request inmutable
← → paso · R repetir · Espacio pausa
Aprenderás
- Por qué un constructor con muchos argumentos es un problema (visto)
- Encadenar pasos con nombre sobre valores por defecto (visto)
- Validar una sola vez en build() y entregar un objeto inmutable (visto)
- Reconocer el patrón en Java HttpRequest y en Knex (visto)
- Cuándo un objeto de opciones es suficiente (visto)