Mediator: un coordinador en el centro
- Lección 25 de 32
- 11 min
- Intermedio
- 12 pasos
Cuatro piezas de un formulario que se avisan entre todas acaban con la misma regla copiada en varios sitios. Vas a poner un coordinador en el centro, escribirlo en TypeScript y reconocer la idea en React y en los buses de comandos.
- Conexiones entre objetos
- 4
- evento
- petición
- respuesta
Paso 1 de 12
Problema
Cada pieza conoce a las demás
Un formulario de registro tiene cuatro piezas: email, password, terms (aceptar las condiciones) y el botón submit. El botón se habilita solo cuando el email tiene «@», hay contraseña y terms está marcado. Si borras el email, terms se desmarca.
La forma directa: el handler de email cambia él mismo a terms y a submit, y password y terms hacen lo mismo con las demás. Al final cada pieza conoce a las otras tres: 6 conexiones entre 4 objetos.
Qué cambió
- email.onChange cambia terms y submit
Paso 2 de 12
Problema
Una regla, tres copias
La regla de submit está escrita en los handlers de email, password y terms. Ahora te piden que la contraseña tenga al menos 8 caracteres (un valor de ejemplo): tienes que cambiar tres sitios y no olvidar ninguno.
Y la red crece rápido: si cada pieza conoce a todas, con n piezas hay n × (n − 1) ÷ 2 conexiones. Con 4 son 6; con 10 serían 45. Ninguna pieza es dueña de las reglas, y ninguna se puede llevar a otro formulario sin arrastrar a las demás.
Qué cambió
- la regla de submit, en 3 handlers
Paso 3 de 12
Concepto
Un coordinador en el centro
La idea de Mediator: pones un objeto en el centro, SignupDialog, y las piezas dejan de hablarse entre sí. Cada una solo le avisa «cambié», y el mediador decide quién más tiene que reaccionar.
Piensa en la torre de control de un aeropuerto: los aviones no se coordinan entre ellos, hablan con la torre. Aquí las 6 conexiones pasan a ser 4, una por pieza. El ejemplo del libro del Gang of Four es justamente un cuadro de diálogo que coordina sus controles.
Qué cambió
- SignupDialog, el mediador
- las 6 conexiones directas
Paso 4 de 12
Técnica
Las reglas, en un solo lugar
SignupDialog guarda las cuatro piezas en this.fields y tiene un método, changed(w). Ahí viven todas las reglas: desmarcar terms si el email queda vacío y recalcular submit.enabled.
Recibe la pieza que cambió (w) para saber qué pasó. Pedir 8 caracteres en la contraseña ahora es cambiar una línea, aquí y en ningún otro sitio.
Qué cambió
- changed(w), con todas las reglas
Paso 5 de 12
Técnica
Cada pieza solo avisa
Del otro lado, una pieza como Field guarda su valor y llama a this.m.changed(this). No sabe que existen terms ni submit: solo conoce una interfaz, interface Mediator { changed(w: Widget): void }.
Eso la hace reutilizable: el mismo Field sirve en un formulario de login, con otro mediador y otras reglas. El checkbox y el botón funcionan igual.
Qué cambió
- Field avisa con changed(this)
- referencias a las otras piezas
Paso 6 de 12
Solución
Una regla nueva, una línea
Nuevo pedido: password queda deshabilitado mientras el email no tenga «@». En la red de antes tendrías que elegir qué handler lo hace y avisar a todos los que dependen de password.
Con el mediador es una línea en `changed`: f.pass.enabled = ok. Field, el checkbox y el botón no cambian. Las reglas de cómo interactúan las piezas salen de ellas y se juntan en un objeto.
Qué cambió
- f.pass.enabled = ok
- Field, sin cambios
Paso 7 de 12
Concepto
Ya lo usas: subir el estado al padre
La documentación de React lo explica con un acordeón: dos Panel hermanos y solo uno abierto a la vez. En vez de que un panel controle al otro, el estado sube al padre común, Accordion, que le pasa a cada hijo un valor (isActive) y un handler (onShow). React lo llama lifting state up.
Los paneles nunca se referencian entre sí: avisan al padre y el padre decide. Que eso sea un mediador es una lectura nuestra, no un término de React: el padre funciona como uno.
Qué cambió
- SignupDialog → Accordion
- changed(w) → onShow
Paso 8 de 12
Concepto
En el backend: buses de comandos
En NestJS, con su módulo CQRS, el controller no llama al código que crea el pedido: hace commandBus.execute(new CreateOrderCommand(...)). El bus busca el handler registrado para ese tipo de comando y se lo entrega. Para eventos, EventBus.publish() llega a todos los handlers suscritos.
En .NET, MediatR se presenta como un mediador en proceso: Send lleva una petición a su único handler y Publish, una notificación a varios. El controller y el handler no se conocen; el bus está en el medio. Si vas a usar MediatR, revisa su licencia: el proyecto ahora pide claves de licencia.
Qué cambió
- SignupDialog → CommandBus
- changed(w) → execute(command)
Paso 9 de 12
Concepto
Tres ideas equivocadas
«Es lo mismo que Observer»: Observer avisa a oyentes que no conoce. Un mediador conoce a cada pieza y guarda las reglas entre ellas. Se combinan a menudo: las piezas pueden avisarle al mediador con eventos.
«Necesito una librería»: un componente padre o una clase como SignupDialog bastan.
«Todo tiene que pasar por un bus»: si una llamada siempre va al mismo sitio y nadie más reacciona, el bus solo esconde a dónde va el código.
Paso 10 de 12
Compromiso
Cuando el centro lo sabe todo
El riesgo del patrón está en el centro. Cada regla nueva cae en changed, y si el formulario crece (país, cupón, plan de empresa, en este ejemplo) el mediador se llena de if y conoce todo. Eso tiene nombre: un objeto dios, una clase que sabe y hace demasiado.
La salida es partir por funcionalidad: un mediador por formulario o por sección, no uno para toda la app. Lo retomas en la lección de Antipatrones.
Qué cambió
- reglas de país, cupón y plan
- SignupDialog crece
Paso 11 de 12
Compromiso
Cuándo no usarlo y qué cuesta
Si solo hay dos o tres piezas y una interacción simple (el email habilita el botón), llama directo. Un mediador ahí es una clase más que leer.
Lo que pagas cuando sí lo usas: un salto más al seguir el código (pieza → mediador → otra pieza), una clase central que puede crecer sin límite y, con un bus, la pregunta «¿quién maneja este comando?» cada vez que depuras.
Qué cambió
- el mediador
- una llamada directa
Paso 12 de 12
Resumen
Un centro que coordina
Cuando varias piezas tienen que reaccionar unas a otras, no dejes que se llamen entre todas: pon un mediador al que cada una avisa y que guarda las reglas. Las piezas quedan simples y reutilizables.
Lo reconoces en el padre de React que guarda el estado y en los buses de MediatR y NestJS. El precio es una clase central que hay que mantener pequeña; con dos piezas y una regla, la llamada directa es mejor.
← → paso · R repetir · Espacio pausa
Aprenderás
- Ver por qué objetos que se llaman entre todos forman una red difícil de cambiar. (visto)
- Poner un mediador en el centro al que cada pieza solo le avisa. (visto)
- Escribir un mediador en TypeScript con todas las reglas en un solo lugar. (visto)
- Reconocer la idea en «lifting state up» de React y en los buses de MediatR y NestJS. (visto)
- Distinguirlo de Observer y saber cuándo sobra. (visto)