Diagramas de clases UML

Una clase es un rectángulo con hasta tres compartimentos apilados. Solo el primero es obligatorio.

• Nombre. El nombre del tipo, centrado y en negrita. Si la clase es abstracta, el nombre va en cursiva. Una palabra clave entre comillas angulares encima - «interface», «enumeration» - acota de qué tipo de clasificador se trata.
• Atributos. Uno por línea, escritos como visibilidad nombre: Tipo [multiplicidad] = valor por defecto. Todo salvo el nombre es opcional.
• Operaciones. Una por línea, escritas como visibilidad nombre(parámetros): TipoDeRetorno.

El símbolo inicial de cada miembro es su visibilidad: + público, - privado, # protegido y ~ de paquete. Un miembro subrayado es estático: pertenece a la clase y no a una instancia.

Casi todo el significado de un diagrama de clases está en las líneas, y solo seis merecen memorizarse. El extremo que lleva el adorno es significativo en todos los casos.

El número al final de una línea dice cuántas instancias participan. Se coloca en el extremo opuesto a la clase que restringe, y eso despista: al leer Merchant 1 —— 0..* Payment, el 0..* junto a Payment significa que un comercio tiene cero o más pagos.

• 1 - exactamente una. El valor por defecto cuando no se escribe nada, aunque escribirlo es más claro.
• 0..1 - opcional. Esta es la notación de una referencia que puede estar vacía.
• * o 0..* - cualquier número, incluido ninguno.
• 1..* - al menos una. Una restricción con sentido y que se olvida a menudo.
• 2..4 - un rango explícito.

La multiplicidad es la victoria en corrección más barata de toda la notación. «¿Esto puede estar vacío?» y «¿puede haber más de uno?» son las dos preguntas que sacan a la luz los desacuerdos reales en una revisión de diseño, y la respuesta se anota con tres caracteres.

Estas tres son la misma forma de relación con tres intensidades, y la diferencia va del ciclo de vida, no de lo relacionadas que parezcan las dos cosas.

Una asociación simple no afirma nada sobre propiedad. Dos cosas están enlazadas. Eso es todo, y es el valor por defecto correcto.

La agregación - el rombo hueco - afirma una relación todo-parte en la que la parte es independiente. Consejo honesto: la agregación no lleva casi ninguna semántica formal en UML 2.5.1, y los lectores no se ponen de acuerdo sobre qué implica. Si dudas entre asociación y agregación, dibuja la asociación.

La composición - el rombo relleno - es la que dice algo fuerte y comprobable. La parte pertenece a exactamente un todo y se destruye con él. En el modelo de pagos, un Refund existe solo como parte de un Payment; no hay reembolsos flotando sueltos. Esa es una restricción real, que merece registrarse, y se traduce directamente en un borrado en cascada o una colección poseída en el código.

En la práctica, los diagramas de clases más útiles son pequeños. De siete a doce clases, atributos solo en aquellas de las que se está hablando y omitidos en el resto, y cada línea con su multiplicidad. Un diagrama así se lee en una reunión y zanja discusiones. Un diagrama de clases de cien cajas es un artefacto, no una comunicación.

1. Flechas apuntando al revés. La generalización y la realización apuntan a la abstracción. Si tu triángulo está en la subclase, el diagrama dice lo contrario de lo que querías.
2. Composición usada para «muy relacionado». El rombo relleno es una afirmación sobre el ciclo de vida. Úsalo solo cuando destruir el todo destruya de verdad la parte.
3. Sin multiplicidades. Una línea sin nada en los extremos ha tirado la información más valiosa que el diagrama podía llevar.
4. Mezclar alturas. Clases de dominio y clases del framework en un mismo lienzo. Divídelo; cada diagrama debe ser legible para un solo público.
5. Modelar cada getter. Las operaciones van en el diagrama cuando llevan significado. getName() no lo lleva.

Si quieres contrastar un modelo de clases con la realidad, dibuja un diagrama de objetos: una única instantánea concreta de instancias. Las multiplicidades que parecían correctas en abstracto suelen caerse en cuanto intentas rellenarlas con valores reales.