← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
IV · La estrategia
Capítulo
13
Estado
Borrador
Patrones
Puertos y adaptadores (Ports and Adapters) · Inversión de dependencias (Dependency Inversion) · Interfaz separada (Separated Interface) · Capa anticorrupción (Anti-Corruption Layer) · Objeto nulo (Null Object) · Raíz de composición (Composition Root)

El vano y la carpintería

Cómo hacer que un sistema no dependa de quién le trae los datos.

1Primero, las ventanas

El edificio tiene seis plantas: departamentos arriba y locales comerciales abajo. La estructura se vacía mucho antes de comprar una sola ventana, y el propietario va a pedir proformas a tres fábricas de carpintería de aluminio, que cotizan en dólares. Si cada vano se deja a la medida de la ventana de la fábrica A y al final gana la B, hay que picar muros que ya están levantados.

La arquitecta y el calculista lo resuelven así.

Fábrica A Fábrica B vano de 120 × 100 cm el mismo vano premarco: lo que cambia ventana de cada fábrica
Un mismo vano de 120 por 100 centímetros recibe la ventana de la fábrica A y la de la fábrica B. La obra gruesa no se toca y lo único que cambia es el grosor del premarco, que cierra la diferencia entre el vano y el marco.

Funciona porque el vano es un compromiso chico, medible y sin nombre propio. La carpintería se adapta a la obra gruesa, y no al revés.

2El mismo problema, en un programa

Una app de banca móvil permite transferir entre cuentas en bolivianos y en dólares, y necesita el tipo de cambio. Es la app con la que Marta paga en bolivianos las proformas que cotizan en dólares. El programador hace lo más directo. Las transferencias, los pagos de servicios y el extracto leen la lista que publica un proveedor de cotizaciones, tal como llega.

Tres meses después, el proveedor cambia el formato. Una agencia pequeña, sin conexión estable, quiere cargar los valores a mano. Y las pruebas se caen cada vez que se corta la conexión.

—¿Cuánto cuesta cambiarlo? —pregunta la gerente.

—Hay que tocar transferencias, pagos y extracto —responde el programador—. En los tres aparece el código de moneda del proveedor.

—Pero transferencias no tiene nada que ver con el proveedor.

—Ya. Pero ahora lo sabe todo de él.

Es el vano hecho a la medida de la fábrica A. Lo estable, las reglas de las transferencias, quedó apoyado en lo que cambia, la lista de un proveedor.

NÚCLEO FUERA DEL NÚCLEO Transferencias Pagos de servicios Extracto Lista del proveedor códigos propios coma decimal una vez por semana a veces se cae lee su formato
Antes. Tres módulos del núcleo del programa, es decir, la capa de reglas del capítulo 2 (transferencias, pagos de servicios y extracto), leen directamente la lista del proveedor, con sus códigos propios y su coma decimal. Si el formato cambia, cambian los tres.

3Las seis piezas

Cada cosa del edificio tiene su equivalente en el programa y un nombre estándar, para poder buscarla en la literatura. El dibujo las muestra juntas, con el número de cada pieza.

NÚCLEO DEL PROGRAMA Transferencias · Pagos · Extracto no sabe quién hay detrás 1 Puerto: tipo de cambio 3 dependen del puerto (y no al revés) 2 Adaptador del proveedor 2 Adaptador carga manual 5 Objeto nulo valores fijos 4 frontera traduce y controla Proveedor externo Persona tecleando (sin fuente) 6 Plano de montaje: elige qué se enchufa
Después. El núcleo define un puerto, el tipo de cambio, con sus propias palabras. Tres adaptadores, el del proveedor, la carga manual y un objeto nulo con valores fijos, dependen del puerto, y cada fuente entra por su adaptador. Una frontera entre los adaptadores y el exterior traduce y controla. La línea punteada es la elección que hace el plano de montaje al arrancar, que decide qué adaptador se enchufa.

1El puertoPort · Separated Interface

El vano es lo único que la obra gruesa promete: medidas, tolerancia y resistencia, sin decir de qué fábrica. En el programa, el núcleo escribe con sus propias palabras lo que necesita: «dame el tipo de cambio entre estas dos monedas, en esta fecha». Esa interfaz vive dentro del núcleo y no menciona códigos, formatos ni proveedores.

Por lo tanto

el núcleo define el puerto con su vocabulario, y lo externo se ajusta a él.

2El adaptadorAdapter

El premarco absorbe la diferencia entre el vano y cada ventana. Hay un adaptador por fuente: uno lee la lista del proveedor, otro recibe los valores tecleados. Cada uno traduce a las palabras del puerto y es el único que conoce su fuente.

Por lo tanto

cada fuente entra por su adaptador, y solo el adaptador la conoce.

3La inversión de la dependenciaDependency Inversion

Lo que cambia seguido descansa sobre lo que no cambia: los acabados sobre la estructura. Nadie diseña la estructura para que se adapte a una ventana. En el programa pasaba al revés, y con el puerto la flecha se da vuelta. El adaptador se apoya en el puerto del núcleo, y el núcleo no sabe nada del adaptador.

Por lo tanto

lo que cambia depende de lo estable, nunca al revés.

4La capa anticorrupciónAnti-Corruption Layer

Es el control de recepción: la prueba de agua de la ventana, el cono de Abrams del mixer. El adaptador no solo traduce, también controla. Un tipo de cambio en cero, una moneda que no existe o una fecha de hace tres años se rechazan ahí y nunca llegan a una transferencia.

Por lo tanto

el núcleo solo recibe lo que ya fue traducido y controlado.

5El objeto nulo y los dobles de pruebaNull Object · Test Double

La tapa de triplay deja que la obra siga sin la ventana definitiva. En el programa, un adaptador sin fuente real entrega valores fijos o responde «no hay tipo de cambio». Con eso las reglas se prueban sin red y sin esperar a nadie.

Por lo tanto

cada puerto tiene un sustituto simple, para probar y para arrancar sin fuente.

6La raíz de composiciónComposition Root · Dependency Injection

La planilla de carpintería asigna cada ventana a su vano, y los albañiles no eligen. En el programa, un solo lugar, al arrancar, decide qué adaptador se enchufa a cada puerto: el del proveedor en la banca por internet, la carga manual en la agencia sin conexión estable, los valores fijos en las pruebas.

Por lo tanto

se decide qué se enchufa a qué en un solo sitio, y en ningún otro.

Con esto, cuando el proveedor cambia de formato se reescribe su adaptador y transferencias, pagos y extracto no se tocan.

4Qué se gana y qué cuesta

Lo que se gana

  • Cambiar de fuente sin tocar el núcleo.
  • Tener varias fuentes y elegir según el caso.
  • Probar las reglas sin lo real.
  • Frenar en la frontera los datos malos.

Lo que cuesta

  • Más piezas: un puerto, un adaptador por fuente y el montaje.
  • Un salto más al leer el programa.
  • Una traducción puede perder información. Hay que controlarla y probarla con casos reales.

Un puerto engañoso. Si el puerto devuelve datos con la forma del proveedor, hay un salto más y ninguna protección. Es un vano con las medidas del marco de la fábrica A. La prueba es una pregunta. ¿Se podría escribir el adaptador de otra fuente sin conocer la primera?

Cuándo no conviene. En una caseta de obra que se arma una vez, se compra la ventana y el hueco se hace a su medida. Un puerto tiene sentido donde hay una costura real. La fuente puede cambiar, habrá una segunda o hay que reemplazarla en las pruebas. Es la misma idea de las juntas del capítulo 11, que se ponen solo donde el edificio se mueve.

Con qué se combina. Con las capas (capítulo 2), los repositorios (capítulo 8) y los contextos (capítulo 12).

5Para llevarse

En el edificioEn el programaPatrón
Vano con medidas y toleranciasPuertoPort · Separated Interface
PremarcoAdaptadorAdapter
La carpintería se adapta a la obra gruesaInversión de la dependenciaDependency Inversion
Recepción de la ventana y ensayo del mixerFrontera que traduce y controlaAnti-Corruption Layer
Tapa provisional de triplay o calaminaSustituto simple para pruebasNull Object · Test Double
Planilla de carpinteríaRaíz de composiciónComposition Root

¿No es esto lo que ya hacemos al escribir «o equivalente» en las especificaciones?

Sí, con una diferencia. En las especificaciones, la equivalencia la verifica una persona cuando llega el material. En el programa, el puerto es un contrato. El compilador comprueba su forma y una batería de pruebas comprueba su comportamiento, la misma para cada adaptador. Es el principio de sustitución del capítulo 10. Que quepa no basta, tiene que servir donde servía la anterior.

Dónde cojea la analogía

El vano garantiza que la ventana entra, no que cierre bien. El puerto tiene el mismo límite. Su forma dice cómo se llama lo que se pide y qué devuelve, y no qué significa. ¿Tipo de cambio de compra o de venta? ¿Del cierre del día o de este minuto? ¿Qué pasa si no hay? Eso se escribe en el contrato del puerto y se comprueba con la batería común, igual que la prueba de agua se le hace a cada tipo de ventana.

En la práctica, a noviembre de 2026: los puertos son interfaces del lenguaje (Java, C#, TypeScript) y la raíz de composición suele apoyarse en contenedores de inyección de dependencias, como los de Spring, ASP.NET Core o Angular. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 14 · Bases de datosLa planoteca por dentro: por qué cada dato se escribe una sola vez.