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
emailPanel AControlleremailpasswordPanel BpasswordtermstermssubmitHandlersubmitSignupDialogmediadorAccordionmediadorCommandBusmediadorSignupDialogcambia y avisa a 3email lo cambiaEl handler de emailemail.onChange = () => {if (email.value === "")terms.checked = false;submit.enabled =email.value.includes("@") &&pass.value !== "" && terms.checked;};▸// password y terms repiten la reglaotra copia de la reglay otra másConexiones si todos se llaman3 piezas34 piezas65 piezas1010 piezas45n × (n − 1) ÷ 2decide quién reaccionasolo dice «cambié»Antes y despuéstodos con todos6 conexionescon un mediador4 conexioneschanged(w)enabled se recalculaSignupDialogchanged(w: Widget) {const f = this.fields;const ok = f.email.value.includes("@");▸if (w === f.email && w.value === "")f.terms.checked = false;▸f.submit.enabled = ok &&f.pass.value !== "" && f.terms.checked;}solo conoce al mediadorchanged(this)Una piezaclass Field {value = "";▸constructor(private m: Mediator) {}set(v: string) {this.value = v;▸this.m.changed(this); // solo avisa}}sin «@», deshabilitadouna línea másDentro de changed(w)const f = this.fields;const ok = f.email.value.includes("@");+f.pass.enabled = ok; // regla nuevaif (w === f.email && w.value === "")f.terms.checked = false;f.submit.enabled = ok &&f.pass.value !== "" && f.terms.checked;guarda el estadoonShow()Accordionconst [active, setActive] = useState(0);return <><Panel isActive={active === 0}onShow={() => setActive(0)} /><Panel isActive={active === 1}onShow={() => setActive(1)} /></>;busca el handler por tipoexecute(command)NestJS CQRS// en el controller:this.commandBus.execute(new CreateOrderCommand(userId));// el handler, registrado por tipo:@CommandHandler(CreateOrderCommand)export class CreateOrderHandler {async execute(c: CreateOrderCommand) {…}}conoce a cada piezalo decide el centroTres ideas equivocadas«es Observer»conoce y coordina«necesito una librería»basta una clase«todo por un bus»a veces solo esconde¿objeto dios?solo avisaReglas en SignupDialog (ejemplo)submit: email, password y termspassword: activo con «@»terms: se desmarca sin emailpaís → prefijo del teléfonocupón → precio finalplan → campos de empresallamada directabastaLo que pagas con un mediadorun salto másal seguir el códigouna clase centralque puede crecercon un bus¿quién maneja esto?las reglas viven aquísolo avisaMediator en una tablaproblemapiezas que se llaman entre todassoluciónun mediador al que todas avisante dareglas en un sitio, piezas reutilizableslo ves enlifting state up, MediatR, CommandBusno lo usescon dos piezas y una regla
  • 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.

Aprenderás

  • Ver por qué objetos que se llaman entre todos forman una red difícil de cambiar.
  • Poner un mediador en el centro al que cada pieza solo le avisa.
  • Escribir un mediador en TypeScript con todas las reglas en un solo lugar.
  • Reconocer la idea en «lifting state up» de React y en los buses de MediatR y NestJS.
  • Distinguirlo de Observer y saber cuándo sobra.