Agregar validación de arquitectura personalizada a diagramas de capas

Artículo
06/10/2015

En Visual Studio Ultimate y Visual Studio Premium, los usuarios pueden validar el código fuente en un proyecto de Visual Studio con un modelo de capas para comprobar que el código fuente cumple las dependencias en un diagrama de capas. Hay un algoritmo de validación estándar, pero puede definir sus propias extensiones de validación para Visual Studio Ultimate y Visual Studio Premium.

Cuando el usuario selecciona el comando Validar arquitectura en un diagrama de capas, se invoca el método de validación estándar, seguido de cualquier extensión de validación que se haya instalado.

Nota

La validación en un diagrama de capas no es lo mismo que la validación en diagramas UML.En un diagrama de capas, el propósito principal es comparar el diagrama con el código de programa de otras partes de la solución.

Puede empaquetar la extensión de validación de capas en una extensión de integración de Visual Studio (VSIX), que puede distribuir a otros usuarios de Visual Studio Ultimate. Puede colocar el validador en VSIX por sí solo o puede combinarlo en el mismo VSIX con otras extensiones. Debe escribir el código del validador en su propio proyecto de Visual Studio, no en el mismo proyecto que otras extensiones.

Advertencia

Después de haber creado un proyecto de validación, copie el código de ejemplo que aparece al final de este tema y después, edítelo, en función de sus necesidades.

Requisitos

Visual Studio Ultimate
SDK de Visual Studio
SDK de Visual Studio de visualización y modelado

Definir un validador de capas en un nuevo VSIX

El método más rápido para crear un validador consiste en usar la plantilla de proyecto. Esto coloca el código y el manifiesto de VSIX en el mismo proyecto.

Para definir una extensión mediante una plantilla de proyecto

Cree un proyecto en una nueva solución mediante el comando Nuevo proyecto del menú Archivo.
En el cuadro de diálogo Nuevo proyecto, en Proyectos de modelado, seleccione Layer Designer Validation Extension (Extensión de validación de diseñador de capas).

La plantilla crea un proyecto que contiene un pequeño ejemplo.
Advertencia

Para que la plantilla funcione correctamente:
- Edite las llamadas a LogValidationError para quitar los argumentos opcionales errorSourceNodes y errorTargetNodes.
- Si usa propiedades personalizadas, aplique la actualización mencionada en Agregar propiedades personalizadas a diagramas de capas.Además, abra el Explorador de arquitectura antes de abrir una solución de modelo.
Modifique el código para definir la validación. Para obtener más información, vea Programar la validación.
Para probar la extensión, vea Depurar la validación de capas.

Nota

Solo se llamará al método en circunstancias concretas y los puntos de interrupción no funcionarán automáticamente.Para obtener más información, vea Depurar la validación de capas.
Para instalar la extensión en la instancia principal de Visual Studio o en otro equipo, busque el archivo .vsix en bin\*. Cópielo en el equipo donde desea instalarlo y, a continuación, haga doble clic en él. Para desinstalarlo, use el Administrador de extensiones en el menú Herramientas.

Agregar un validador de capas a un VSIX independiente

Si desea crear un VSIX que contenga validadores de capas, comandos y otras extensiones, le recomendamos que cree un proyecto para definir VSIX y proyectos independientes para los controladores. Para obtener información sobre otros tipos de extensión de modelado, vea Ampliar modelos y diagramas UML.

Para agregar la validación de capas a un VSIX independiente

Cree un proyecto de biblioteca de clases en una solución de Visual Studio Ultimate nueva o en una existente. En el cuadro de diálogo Nuevo proyecto, haga clic en Visual C# y haga clic en Biblioteca de clases. Este proyecto contendrá la clase de validación de capas.
Identifique o cree un proyecto de VSIX en la solución. Un proyecto de VSIX contiene un archivo denominado source.extension.vsixmanifest. Si tiene que agregar un proyecto VSIX, siga estos pasos:
1. En el cuadro de diálogo Nuevo proyecto, elija Visual C#, Extensibilidad, Proyecto VSIX.
2. En el Explorador de soluciones, en el menú contextual del proyecto VSIX, elija Establecer como proyecto de inicio.
En source.extension.vsixmanifest, en Activos, agregue el proyecto de validación de capas como componente MEF:
1. Elija Nuevo.
2. En el cuadro de diálogo Agregar nuevo activo, establezca:
  
  Tipo = Microsoft.VisualStudio.MefComponent
  
  Origen = Un proyecto de la solución actual
  
  Proyecto = your validator project
También debe agregarse como validación de capas:
1. Elija Nuevo.
2. En el cuadro de diálogo Agregar nuevo activo, establezca:
  
  Tipo = Microsoft.VisualStudio.ArchitectureTools.Layer.Validator. Esta no es una de las opciones de la lista desplegable. Debe escribirla desde el teclado.
  
  Origen = Un proyecto de la solución actual
  
  Proyecto = your validator project

Vuelva al proyecto de validación de capas y agregue las siguientes referencias de proyecto:

Referencia	Qué permite hacer
Microsoft.VisualStudio.GraphModel.dll	Leer el gráfico de la arquitectura
Microsoft.VisualStudio.ArchitectureTools.Extensibility.CodeSchema.dll	Leer el código que DOM asoció a las capas
Microsoft.VisualStudio.ArchitectureTools.Extensibility.Layer.dll	Leer el modelo de capas
Microsoft.VisualStudio.ArchitectureTools.Extensibility	Leer y actualizar formas y diagramas.
System.ComponentModel.Composition	Definir el componente de validación mediante MEF (Managed Extensibility Framework)
Microsoft.VisualStudio.Modeling.Sdk.12.0	Definir las extensiones de modelado

Copie el código de ejemplo al final de este tema en el archivo de clase del proyecto de biblioteca de validador para que contenga el código de la validación. Para obtener más información, vea Programar la validación.
Para probar la extensión, vea Depurar la validación de capas.

Nota

Solo se llamará al método en circunstancias concretas y los puntos de interrupción no funcionarán automáticamente.Para obtener más información, vea Depurar la validación de capas.
Para instalar VSIX en la instancia principal de Visual Studio o en otro equipo, busque el archivo .vsix en el directorio bin del proyecto de VSIX. Cópielo en el equipo donde desea instalar VSIX. En el Explorador de Windows, haga doble clic en el archivo VSIX. (Explorador de archivos in Windows 8).

Para desinstalarlo, use el Administrador de extensiones en el menú Herramientas.

Programar la validación

Para definir una extensión de validación de capas, defina una clase que tenga las siguientes características:

El formato general de la declaración será similar al siguiente:


using System.ComponentModel.Composition;
using Microsoft.VisualStudio.ArchitectureTools.Extensibility.CodeSchema;
using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Layer;
using Microsoft.VisualStudio.GraphModel;
...
 [Export(typeof(IValidateArchitectureExtension))]
  public partial class Validator1Extension :
                  IValidateArchitectureExtension
  {
    public void ValidateArchitecture(Graph graph)
    {
       GraphSchema schema = graph.DocumentSchema;
      ...
  } }

Al detectar un error, puede notificarlo mediante LogValidationError().

Advertencia

No use los parámetros opcionales de LogValidationError.

Cuando el usuario invoca el comando de menú Validar arquitectura, el sistema en tiempo de ejecución de capas analiza las capas y sus artefactos para generar un gráfico. El gráfico tiene cuatro partes:

Los modelos de capas de la solución de Visual Studio que se representan como nodos y vínculos en el gráfico.
El código, los elementos de proyecto y otros artefactos definidos en la solución y representados como nodos, y los vínculos que representan las dependencias detectadas por el proceso de análisis.
Los vínculos de los nodos de capa a los nodos de artefacto de código.
Los nodos que representan los errores detectados por el validador.

Cuando se ha construido el gráfico, se llama al método de validación estándar. Una vez completado, se llama en un orden no especificado a los métodos de validación de extensiones instalados. El gráfico se pasa a cada método de ValidateArchitecture, que puede examinar el gráfico y notificar los errores que encuentre.

Nota

Esto no es igual que el proceso de validación que se aplica a los diagramas UML y no es igual que el proceso de validación que se puede usar en los lenguajes específicos del dominio.

Los métodos de validación no deben cambiar el modelo de capas ni el código que se valida.

El modelo del gráfico se define en Microsoft.VisualStudio.GraphModel. Sus clases principales son GraphNode y GraphLink.

Cada nodo y cada vínculo tiene una o más categorías que especifican el tipo de elemento o relación que representa. Los nodos de un gráfico típico tienen las siguientes categorías:

Dsl.LayerModel
Dsl.Layer
Dsl.Reference
CodeSchema_Type
CodeSchema_Namespace
CodeSchema_Type
CodeSchema_Method
CodeSchema_Field
CodeSchema_Property

Los vínculos entre las capas y los elementos del código tienen la categoría "Representa".

Depurar la validación

Para depurar la extensión de validación de capas, presione CTRL+F5. Se abre una instancia experimental de Visual Studio. En esta instancia, abra o cree un modelo de capas. Este modelo debe estar asociado a código y debe tener al menos una dependencia.

Probar con una solución que contiene dependencias

No se ejecuta la validación a menos que estén presentes las siguientes características:

Hay al menos un vínculo de dependencia en el diagrama de capas.
Hay capas del modelo asociadas a elementos de código.

La primera vez que inicia una instancia experimental de Visual Studio para probar la extensión de validación, debe abrir o crear una solución que tenga estas características.

Ejecutar Limpiar solución antes de validar la arquitectura

Cada vez que actualice el código de validación, use el comando Limpiar solución en el menú Compilar de la solución experimental antes de probar el comando Validar. Esto es necesario porque los resultados de la validación se almacenan en memoria caché. Si no ha actualizado el diagrama de capas de pruebas ni el código, no se ejecutarán los métodos de validación.

Iniciar el depurador explícitamente

La validación se ejecuta en un proceso independiente. Por consiguiente, los puntos de interrupción del método de validación no se activarán. Debe adjuntar explícitamente el depurador al proceso cuando se haya iniciado la validación.

Para adjuntar el depurador al proceso de validación, inserte una llamada a System.Diagnostics.Debugger.Launch() en el inicio del método de validación. Cuando aparezca el cuadro de diálogo de depuración, seleccione la instancia principal de Visual Studio.

Alternativamente, puede insertar una llamada a System.Windows.Forms.MessageBox.Show(). Cuando aparezca el cuadro de mensaje, vaya a la instancia principal de Visual Studio y, en el menú Depurar, haga clic en Asociar al proceso. Seleccione el proceso denominado Graphcmd.exe.

Inicie siempre la instancia experimental presionando CTRL+F5 (Iniciar sin depurar).

Implementar una extensión de validación

Para instalar la extensión de validación en un equipo en el que está instalado Visual Studio Ultimate o Visual Studio Premium, abra el archivo VSIX en el equipo de destino. Para instalarla en un equipo en el que está instalado Team Foundation Build, debe extraer manualmente el contenido de VSIX en una carpeta Extensions. Para obtener más información, vea Implementar una extensión de modelado de capas.

Código de ejemplo

using System;
using System.ComponentModel.Composition;
using System.Globalization;
using System.Linq;
using System.Text.RegularExpressions;
using Microsoft.VisualStudio.ArchitectureTools.Extensibility.CodeSchema;
using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Layer;
using Microsoft.VisualStudio.GraphModel;

namespace Validator3
{
    [Export(typeof(IValidateArchitectureExtension))]
    public partial class Validator3Extension : IValidateArchitectureExtension
    {
        /// <summary>
        /// Validate the architecture
        /// </summary>
        /// <param name="graph">The graph</param>
        public void ValidateArchitecture(Graph graph)
        {
            if (graph == null) throw new ArgumentNullException("graph");

            // Uncomment the line below to debug this extension during validation
            // System.Windows.Forms.MessageBox.Show("Attach 2 to GraphCmd.exe with process id " + System.Diagnostics.Process.GetCurrentProcess().Id);


            // Get all layers on the diagram
            foreach (GraphNode layer in graph.Nodes.GetByCategory("Dsl.Layer"))
            {
                System.Threading.Thread.Sleep(100);
                // Get the required regex property from the layer node
                string regexPattern = "^[a-zA-Z]+$"; //layer[customPropertyCategory] as string;
                if (!string.IsNullOrEmpty(regexPattern))
                {
                    Regex regEx = new Regex(regexPattern);

                    // Get all referenced types in this layer including those from nested layers so each
                    // type is validated against all containing layer constraints.
                    foreach (GraphNode containedType in layer.FindDescendants().Where(node => node.HasCategory("CodeSchema_Type")))
                    {
                        // Check the type name against the required regex                        
                        CodeGraphNodeIdBuilder builder = new CodeGraphNodeIdBuilder(containedType.Id, graph);
                        string typeName = builder.Type.Name;
                        if (!regEx.IsMatch(typeName))
                        {
                            // Log an error
                            string message = string.Format(CultureInfo.CurrentCulture, Resources.InvalidTypeNameMessage, typeName);
                            this.LogValidationError(graph, typeName + "TypeNameError", message, GraphErrorLevel.Error, layer);
                        }
                    }
                }

            }

        }
    }
}

Vea también

Conceptos

Ampliar diagramas de capas

Compartir a través de