Cómo hacer que un sistema no dependa de quién le trae los datos.
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í.
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.
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.
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.
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.
el núcleo define el puerto con su vocabulario, y lo externo se ajusta a él.
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.
cada fuente entra por su adaptador, y solo el adaptador la conoce.
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.
lo que cambia depende de lo estable, nunca al revés.
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.
el núcleo solo recibe lo que ya fue traducido y controlado.
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.
cada puerto tiene un sustituto simple, para probar y para arrancar sin fuente.
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.
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.
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).
| En el edificio | En el programa | Patrón |
|---|---|---|
| Vano con medidas y tolerancias | Puerto | Port · Separated Interface |
| Premarco | Adaptador | Adapter |
| La carpintería se adapta a la obra gruesa | Inversión de la dependencia | Dependency Inversion |
| Recepción de la ventana y ensayo del mixer | Frontera que traduce y controla | Anti-Corruption Layer |
| Tapa provisional de triplay o calamina | Sustituto simple para pruebas | Null Object · Test Double |
| Planilla de carpintería | Raíz de composición | Composition 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.
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.