Patrón Builder

Builder es un patrón de diseño creacional que permite construir objetos complejos paso a paso. A diferencia de otros patrones creacionales como el Patrón Singleton o el Patrón Factory Method, Builder no requiere que todos los productos tengan la misma interfaz.

💡 Ver Caso Práctico: Ejemplo Práctico del Patrón Builder

Propósito y Caso de Uso

Utiliza el patrón Builder cuando necesites construir objetos con muchos parámetros opcionales, evitar el antipatrón de Telescoping ConstructorGlosarioTelescoping Constructor (Constructor Telescópico)Antipatrón de diseño en POO que ocurre cuando una clase define múltiples constructores sobrecargados con listas de parámetros progresivamente más largas para manejar argumentos opcionales. Produce código rígido, difícil de mantener y propenso a errores al invocar.Ver término completo → y aplicar principios de diseño limpios como SOLIDGlosarioSOLIDAcrónimo de cinco principios de diseño orientado a objetos y programación diseñados para hacer que el software sea más comprensible, flexible y mantenible: S - Single Responsibility Principle (Responsabilidad Única) O - Open/Closed Principle (Abierto/Cerrado) L - Liskov Substitution Principle (Sustitución de Liskov) I - Interface Segregation Principle (Segregación de Interfaz) D - Dependency Inversion Principle (Inversión de Dependencias) Ver término completo → y KISSGlosarioKISS (Keep It Simple, Stupid)Principio de diseño que establece que la mayoría de los sistemas funcionan mejor si se mantienen simples en lugar de hacerlos complejos. Se debe evitar la complejidad innecesaria en la arquitectura y el código.Ver término completo →.

Estructura del Patrón

1. Builder (Interfaz): Declara los pasos de construcción de productos comunes a todos los tipos de creadores.
2. Builder Concreto: Ofrece distintas implementaciones de los pasos de construcción y ensambla el producto final.
3. Producto: El objeto complejo resultante creado.
4. Director (Opcional): Define el orden en el que se deben llamar a los pasos de construcción para reutilizar configuraciones específicas.

Flujo de Funcionamiento

1. Invocación: El cliente crea una instancia del Builder o llama al Director.
2. Encadenamiento (Fluent Interface): Se ejecutan secuencialmente los métodos de configuración que devuelven this.
3. Construcción: El método build() valida los campos obligatorios y retorna el objeto complejo final configurado.

Ejemplos de Implementación Reales

// QueryBuilder.ts — Constructor fluido de consultas SQL/Database
class SQLQueryBuilder {
  private query: {
    table: string;
    fields: string[];
    whereConditions: string[];
    limitCount?: number;
  } = { table: '', fields: [], whereConditions: [] };
 
  public select(fields: string[]): this {
    this.query.fields = fields;
    return this;
  }
 
  public from(table: string): this {
    this.query.table = table;
    return this;
  }
 
  public where(condition: string): this {
    this.query.whereConditions.push(condition);
    return this;
  }
 
  public limit(count: number): this {
    this.query.limitCount = count;
    return this;
  }
 
  public build(): string {
    if (!this.query.table) {
      throw new Error("Debe especificar una tabla con .from()");
    }
    const fieldsStr = this.query.fields.length ? this.query.fields.join(", ") : "*";
    let sql = `SELECT ${fieldsStr} FROM ${this.query.table}`;
    if (this.query.whereConditions.length) {
      sql += ` WHERE ${this.query.whereConditions.join(" AND ")}`;
    }
    if (this.query.limitCount) {
      sql += ` LIMIT ${this.query.limitCount}`;
    }
    return sql;
  }
}
 
// Uso práctico:
const query = new SQLQueryBuilder()
  .select(["id", "name", "email"])
  .from("users")
  .where("status = 'active'")
  .limit(10)
  .build();
 
console.log(query); // SELECT id, name, email FROM users WHERE status = 'active' LIMIT 10