Crear diagramas de capas a partir del código

Puede visualizar el sistema de software de alto nivel, arquitectura lógica creando un diagrama de capas mediante Visual Studio Ultimate.Para asegurarse de que el código mantiene la coherencia con este diseño, valide el código con un diagrama de capas en Visual Studio Ultimate o Visual Studio Premium.Se pueden crear diagramas de capas para los proyectos de Visual C# .NET y Visual Basic .NET.

¿Qué desea hacer?

• Obtenga más información sobre los diagramas de capas

• Cree un diagrama de capas

• Crear capas a partir de artefactos

• Administrar vínculos entre capas y artefactos

• Dependencias existentes en Revés- ingeniero

• Modifique las capas y las dependencias para mostrar el diseño previsto

• Cambiar cómo los elementos aparecen en el diagrama

Obtenga más información sobre los diagramas de capas

Un diagrama de capas permite organizar los elementos de la solución de Visual Studio en grupos lógicos, abstractos denominados capas. Puede utilizar los niveles para describir las tareas importantes que estos artefactos realizan o los componentes principales del sistema.Cada capa puede contener otros niveles que describen tareas más detalladas.También puede especificar las dependencias planeadas o existentes entre las capas.Estas dependencias, que se representan como flechas, muestran qué capas pueden usar o actualmente la funcionalidad representada por otros niveles.Para mantener el control arquitectónico de código, muestra las dependencias buscadas en el diagrama y después validar el código con el diagrama.

Vea:

• Vídeo de canal 9: Diseñar y validar la arquitectura con diagramas de capas

• Diagramas de capas: Referencia

• Diagrama de capas: Instrucciones

• Validar código con diagramas de capas

• Sitio Web de modelos y de procedimientos

Sugerencia

Cuando se crea un diagrama de capas, puede considerar crear gráficos de dependencias para ayudarle a analizar y entender el código.Estos gráficos ayudan a detectar clústeres, modelos, capas naturales y dependencias en el código.De este modo, le resultará más fácil asignar los artefactos a las capas.También puede usar el Explorador de arquitectura para examinar los espacios de nombres y las clases, que suelen corresponderse con los niveles existentes.Posteriormente, podrá usar diagramas de capas que le ayuden a actualizar el código. Vea: Visualizar dependencias de código en gráficos de dependencias Buscar código con el explorador de arquitectura

Cree un diagrama de capas

Antes de crear un diagrama de capas, asegúrese de que la solución tiene un proyecto de modelado.Vea Cómo: Crear proyectos y diagramas de modelado UML.

Importante

No agregue, no arrastre, ni copie un diagrama de capas de un proyecto de modelado en otro o a otra parte de la solución.Esto conserva las referencias del diagrama original, aunque se cambie el diagrama.Esto también evita que la validación de capas funcione correctamente y causar otros problemas, como elementos u otros errores al intentar abrir el diagrama. En su lugar, agregue un nuevo diagrama de capas al proyecto de modelado.Copie los elementos del diagrama de origen en el nuevo diagrama.Guarde el proyecto de modelado y el nuevo diagrama de capas.

Para agregar un nuevo diagrama de capas a un proyecto de modelado

1. En el menú Arquitectura, haga clic en Nuevo diagrama.

2. En Plantillas, haga clic en Diagrama de capas.

3. Especifique un nombre para el diagrama.

4. En Agregar a proyecto de modelado, busque y seleccione un proyecto de modelado existente en la solución.

   O bien

   Haga clic en Crear un nuevo proyecto de modelado para agregar un nuevo proyecto de modelado a la solución.

   [!NOTA]

   Los diagramas de capas solo pueden existir dentro de un proyecto de modelado.Sin embargo, puede vincularlos a los elementos en cualquier parte de la solución.

5. Asegúrese de guardar tanto el proyecto de modelado como el diagrama de capas.

Crear capas a partir de artefactos

Puede crear capas a elementos de la solución de Visual Studio, como proyectos, archivos de código, espacios de nombres, clases, y métodos.Esto crea automáticamente vínculos entre las capas y los elementos, entre ellos en el proceso de validación de capas.También puede vincular capas a los elementos que no admiten validación, como documentos de Word o presentaciones de Powerpoint, para poder asociar un nivel con especificaciones o planes. Para ver si un elemento vinculado admite la validación, E&xplorador de capas abierto y examine la propiedad Admite validación de elemento.Vea Administrar vínculos a artefactos.

Para	Siga estos pasos
Crear una capa para un único artefacto	Arrastre el elemento hasta el diagrama de capas de cualquiera de los siguientes orígenes: Explorador de soluciones Por ejemplo, puede arrastrar archivos o proyectos. Explorador de arquitectura Por ejemplo, puede arrastrar espacios de nombres, clases o métodos.Vea Buscar código con el explorador de arquitectura. Gráficos de dependencia Vea Visualizar dependencias de código en gráficos de dependencias. Aparecerá una capa en el diagrama que estará vinculada al artefacto. Cambie el nombre de la capa para que refleje las responsabilidades del código asociado u otros artefactos. Importante El arrastrar los archivos binarios al diagrama de capas no añade automáticamente las referencias a proyecto de modelado.Debe agregar manualmente los archivos binarios que desee validar al proyecto de modelado.Para agregar archivos binarios al proyecto de modelado En Explorador de soluciones, abra el menú contextual del proyecto y, a continuación haga clic en Personalizaciones de compilación. En el cuadro de diálogo Agregar elemento existente, examine los archivos binarios, selecciónelos y, a continuación, haga clic en Aceptar. Los archivos binarios aparecen en el proyecto de modelado. En el Explorador de soluciones, haga clic en un archivo binario que agregó y, a continuación, presione F4 para abrir la ventana Propiedades. En cada archivo binario, establezca la propiedad Acción de compilación en Validar.
Crear una única capa para todos los artefactos seleccionados	Arrastre todos los artefactos al diagrama de capas al mismo tiempo. Aparecerá una capa en el diagrama que estará vinculada a todos los artefactos.
Crear una capa para cada artefacto seleccionado	Mantenga presionada la tecla MAYÚS mientras arrastra al mismo tiempo todos los artefactos al diagrama de capas. Nota Si usa la tecla MAYÚS para seleccionar un intervalo de elementos, suelte la tecla después de seleccionar los artefactos.Cuando arrastre los artefactos al diagrama, vuelva a mantener la tecla presionada. Aparecerá una capa para cada artefacto y cada capa estará vinculada a cada uno de los artefactos.
Agregar un artefacto a una capa	Arrastre el artefacto hasta la capa.
Crear una nueva capa que no tenga vínculos	En el Cuadro de herramientas, expanda la sección Diagrama de capas y, a continuación, arrastre una Capa hasta el diagrama de capas. Para agregar varias capas, haga doble clic en la herramienta.Cuando haya terminado, haga clic en la herramienta Puntero o presione la tecla ESC. -O bien- Abra el menú contextual del diagrama de capas, elija Agregary, a continuación elija Capa.
Crear capas anidadas	Arrastre una capa existente a otro nivel. -O bien- Abra el menú contextual del diagrama de capas, elija Agregary, a continuación, Capa.
Crear una nueva capa que contenga dos o más capas existentes	Seleccione las capas, abra el menú contextual para su selección, y después elija Grupo.
Cambiar el color de una capa	Establezca la propiedad Color en el color que desee.
Especificar qué artefactos asociados a una capa no deben pertenecer a los espacios de nombres especificados	Escriba los espacios de nombres en la propiedad Forbidden Namespaces de la capa.Use un signo de punto y coma (;) para separar los espacios de nombres.
Especificar qué artefactos asociados a una capa no pueden depender de los espacios de nombres especificados	Escriba los espacios de nombres en la propiedad Forbidden Namespace Dependencies de la capa.Use un signo de punto y coma (;) para separar los espacios de nombres.
Especificar qué artefactos asociados a una capa no deben pertenecer a uno de los espacios de nombres especificados	Escriba el espacio de nombres en la propiedad Required Namespaces de la capa.Use un signo de punto y coma (;) para separar los espacios de nombres.

El número de una capa indica el número de artefactos vinculados a ella.Sin embargo, cuando lea este número, recuerde lo siguiente:

• Si una capa se vincula a un artefacto que contiene otros artefactos, pero no se vincula directamente a estos otros artefactos, el número incluye únicamente el artefacto vinculado.Sin embargo, los demás artefactos se incluyen para el análisis durante la validación de capas.

  Por ejemplo, si una capa está vinculada a un solo espacio de nombres, el número de artefactos vinculados es 1, aunque el espacio de nombres contenga clases.Si la capa tiene también vínculos a cada clase del espacio de nombres, el número incluirá las clases vinculadas.

• Si una capa contiene otras que están vinculadas a artefactos, la capa contenedora también está vinculada a esos artefactos, incluso aunque el número de la capa contenedora no los incluya.

Administrar vínculos entre capas y artefactos

1. En el diagrama de capas, abra el menú contextual para el nivel y, a continuación, Ver vínculos.

   En el Explorador de capas se muestran los vínculos de artefacto de la capa seleccionada.

2. Use las tareas siguientes para administrar estos vínculos:

Para	En el Explorador de capas
Eliminar el vínculo entre la capa y un artefacto	Abra el menú contextual del proyecto y, a continuación, elija Eliminar.
Mover el vínculo de una capa a otra	Arrastre el vínculo del artefacto a una capa del diagrama. -O bien- Abra el menú contextual del proyecto y, a continuación, elija Cortar. En el diagrama de capas, abra el menú contextual para el nivel y, a continuación, Pegar.
Copiar el vínculo de una capa a otra	Abra el menú contextual para el vínculo del artefacto y, a continuación, elija Copiar. En el diagrama de capas, abra el menú contextual para el nivel y, a continuación, Pegar.
Crear una nueva capa a partir del vínculo de un artefacto existente	Arrastre el vínculo del artefacto a un espacio en blanco del diagrama.
Compruebe que el artefacto vinculado admite la validación con el diagrama de capas.	Observe la columna Admite validación del vínculo del artefacto.

Dependencias existentes en Revés- ingeniero

Una dependencia existe cuando un artefacto que está asociado a una capa tiene una referencia a un artefacto que está asociado a otra capa.Por ejemplo, una clase de una capa declara una variable que tiene una clase en otra capa.Puede realizar ingeniería inversa de las dependencias existentes en los artefactos vinculados a las capas del diagrama.

[!NOTA]

No se puede realizar ingeniería inversa en las dependencias de ciertos tipos de artefactos.Por ejemplo, no se va a realizar ingeniería inversa en ninguna dependencia que tenga como origen o destino una capa vinculada a un archivo de texto.Para ver qué artefactos tienen dependencias sobre las que se pueden realizar ingeniería inversa, abra el menu contextual para una o múltiples capas y, a continuación, haga clic en Examinar vínculos.En el Explorador de capas, observe la columna Admite validación.No se realizará ingeniería inversa en las dependencias de artefactos en los que esta columna muestra False.

• Seleccione una o varias capas, abra el menú contextual para el nivel seleccionado, y después elija Generar dependencias.

Normalmente, verá algunas dependencias que no deberían existir.Puede editar estas dependencias para alinearlas con el diseño buscado.

Modifique las capas y las dependencias para mostrar el diseño previsto

Para describir los cambios que piensa realizar al sistema o la arquitectura planeada, edite el diagrama de capas:

Para	Siga estos pasos
Cambiar o restringir la dirección de una dependencia	Establezca su propiedad Direction.
Crear nuevas dependencias	Use las herramientas Dependencia y Dependencia bidireccional. Para dibujar varias dependencias, haga doble clic en la herramienta.Cuando haya terminado, haga clic en la herramienta Puntero o presione la tecla ESC.
Especificar qué artefactos asociados a una capa no pueden depender de los espacios de nombres especificados	Escriba los espacios de nombres en la propiedad Forbidden Namespace Dependencies de la capa.Use un signo de punto y coma (;) para separar los espacios de nombres.
Especificar qué artefactos asociados a una capa no deben pertenecer a los espacios de nombres especificados	Escriba los espacios de nombres en la propiedad Forbidden Namespaces de la capa.Use un signo de punto y coma (;) para separar los espacios de nombres.
Especificar qué artefactos asociados a una capa no deben pertenecer a uno de los espacios de nombres especificados	Escriba el espacio de nombres en la propiedad Required Namespaces de la capa.Use un signo de punto y coma (;) para separar los espacios de nombres.

Cambiar cómo los elementos aparecen en el diagrama

Puede cambiar el tamaño, la forma, color, y la posición de capas o color de dependencias editando sus propiedades.

Vea también

Conceptos

Visualizar y entender el código