Créer des diagrammes de couche à partir du code

Article
03/04/2013

Vous pouvez visualiser votre système logiciel de niveau supérieur, architecture logique en créant un diagramme de couche à l'aide de Visual Studio final.Pour vérifier que vos de code demeure cohérent compatibles avec cette conception, valider votre code avec un diagramme de couche dans Visual Studio ultimate ou premium de Visual Studio.Vous pouvez créer des diagrammes de couche pour les projets Visual c .NET et Visual Basic .NET.

Que voulez-vous faire ?

En savoir plus sur les diagrammes de couche
Créez un diagramme de couche
Création de couches à partir de artefacts
Gestion des liens entre les couches et les artefacts
Rebours des dépendances existantes
Modifiez les couches et les dépendances pour afficher la conception prévue
Modifiez la façon dont les éléments apparaissent sur le diagramme

En savoir plus sur les diagrammes de couche

Un diagramme de couche vous permet d'organiser les éléments de solution Visual Studio en groupes logiques et abstraits appelés couches. Vous pouvez utiliser des couches pour décrire les principales tâches que ces artefacts effectuent ou les principaux composants du système.Chaque couche peut contenir d'autres couches qui décrivent des tâches détaillées.Vous pouvez également spécifier les dépendances prévues ou existantes entre des couches.Ces dépendances, représentées comme flèches, le montrent les couches peuvent utiliser ou actuel utilisent les fonctionnalités représentée par d'autres couches.Met à jour le contrôle architectural du code, indiquez que les dépendances prévues sur le diagramme puis validez le code par rapport à le diagramme.

Reportez-vous à :

Conseil
Lorsque vous créez un diagramme de couche, vous pouvez envisager de créer des graphiques de dépendance pour vous aider à explorer et inclure le code.Ces graphiques peuvent vous aider à explorer les clusters, les modèles, les couches naturelles et les dépendances du code.Cela facilite pour que vous avez assigné des artefacts aux couches.Vous pouvez également utiliser le navigateur de l'architecture pour explorer des espaces de noms et des classes, qui correspondent souvent aux couches existantes.Vous pouvez utiliser ensuite des diagrammes de couche pour vous aider à mettre à jour le code. Reportez-vous à : Visualiser des dépendances de code sur les graphiques de dépendance Rechercher du code avec le navigateur de l'architecture

Lorsque vous créez un diagramme de couche, vous pouvez envisager de créer des graphiques de dépendance pour vous aider à explorer et inclure le code.Ces graphiques peuvent vous aider à explorer les clusters, les modèles, les couches naturelles et les dépendances du code.Cela facilite pour que vous avez assigné des artefacts aux couches.Vous pouvez également utiliser le navigateur de l'architecture pour explorer des espaces de noms et des classes, qui correspondent souvent aux couches existantes.Vous pouvez utiliser ensuite des diagrammes de couche pour vous aider à mettre à jour le code.

Reportez-vous à :

Créez un diagramme de couche

Avant de créer un diagramme de couche, assurez-vous que votre solution contient un projet de modélisation.Consultez Comment : créer des diagrammes et projets de modélisation UML.

Important

N'ajoutez pas, ne faites pas, ou glisser-déposer ni copier un diagramme de couche existant d'un projet de modélisation vers un autre projet de modélisation ou à un autre emplacement de la solution.Cela empêché les références du diagramme d'origine, même si vous modifiez le diagramme.Cela empêché également la validation de couche pour fonctionner correctement et peut provoquer d'autres problèmes, telles que les éléments manquants ou d'autres erreurs lorsque vous essayez d'ouvrir le diagramme.

À la place, ajoutez un nouveau diagramme de couche au projet de modélisation.Copiez les éléments depuis le diagramme source vers le nouveau diagramme.Enregistrez le projet de modélisation et le nouveau diagramme de couche.

Pour ajouter un nouveau diagramme de couche à un projet de modélisation

Dans le menu Architecture, choisissez Nouveau diagramme.
Sous Modèles, choisissez Diagramme de couche.
Nommez le diagramme.
Dans Ajouter au projet de modélisation, recherchez et sélectionnez un projet de modélisation existant dans votre solution.

ou

Choisissez Créer un nouveau projet de modélisation pour ajouter un projet de modélisation à la solution.

[!REMARQUE]

Le diagramme de couche doit être présent dans un projet de modélisation.Toutefois, vous pouvez la lier aux éléments n'importe où dans la solution.
Veillez à enregistrer le projet de modélisation et le diagramme de couche.

Création de couches à partir de artefacts

Vous pouvez créer des couches des éléments de solution Visual Studio, tels que des projets, des fichiers de code, des espaces de noms, des classes, et.Cela crée automatiquement des liens entre les couches et les éléments, notamment leur dans le processus de validation de couche.Vous pouvez également lier les couches des éléments qui ne prennent pas en charge la validation, par exemple des documents Word ou des présentations PowerPoint, afin de pouvoir associer une couche avec des spécifications ou des plans. Pour voir si un élément lié prend en charge la validation, Explorateur de couches ouvert et examinent la propriété Supports Validation de l'élément.Consultez l' Gestion des liens vers les artefacts.

Pour	Procédez comme suit
Créer une couche pour un artefact unique	Faites glisser l'élément vers le diagramme de couche de chacune des sources : Explorateur de solutions Par exemple, vous pouvez faire glisser des fichiers ou des projets. Navigateur de l'architecture Par exemple, vous pouvez faire glisser des assemblys, des fichiers binaires, des espaces de noms, des classes, ou.Consultez Rechercher du code avec le navigateur de l'architecture. Graphiques de dépendance Consultez Visualiser des dépendances de code sur les graphiques de dépendance. Une couche s'affiche sur le diagramme et est liée à l'artefact. Renommez la couche pour refléter les responsabilités du code ou des artefacts associés. Important Faire glisser des fichiers binaires vers le diagramme de couche n'ajoute pas automatiquement leurs références à modéliser le projet.Vous devez ajouter manuellement les fichiers binaires que vous souhaitez valider au projet de modélisation.Pour ajouter des fichiers binaires au projet de modélisation Dans Explorateur de solutions, ouvrez le menu contextuel du projet de modélisation, puis choisissez Ajouter un élément existant. Dans la boîte de dialogue Ajouter un élément existant, accédez aux fichiers binaires, sélectionnez-les, puis choisissez OK. Les fichiers binaires s'affichent dans le projet de modélisation. Dans Explorateur de solutions, choisissez un fichier binaire que vous avez ajouté, puis appuyez F4 pour ouvrir la fenêtre Propriétés . Sur chaque fichier binaire, affectez à la propriété Action de génération la valeur Valider.
Créer une couche unique pour tous les artefacts sélectionnés	Faites glisser les artefacts vers le diagramme de couche en même temps. Une couche qui est liée à tous les artefacts s'affiche sur le diagramme.
Créer une couche pour chaque artefact sélectionné	Appuyez sur la touche MAJ et maintenez-la enfoncée tout en faisant glisser tous les artefacts vers le diagramme de couche en même temps. Remarque Si vous utilisez la touche MAJ pour sélectionner une plage d'éléments, relâchez la touche après avoir sélectionné les artefacts.Appuyez de nouveau sur celle-ci et maintenez-la enfoncée lorsque vous faites glisser les artefacts vers le diagramme. Une couche s'affiche sur le diagramme pour chaque artefact, auquel elle est liée.
Ajouter un artefact à une couche	Faites glisser l'artefact vers la couche.
Créer une couche non liée	Dans la Boîte à outils, développez la section Diagramme de couche, puis faites glisser un élément Couche vers le diagramme de couche. Pour ajouter plusieurs couches, double-cliquez sur l'outil.Lorsque vous avez terminé, choisissez l'outil Pointeur ou appuyez sur la touche Échap . - ou - Ouvrez le menu contextuel du diagramme de couche, choisissez Ajouter, puis choisissez Couche.
Créer des couches imbriquées	Faites glisser une couche existante sur une autre couche. - ou - Ouvrez le menu contextuel pour une couche, choisissez Ajouter, puis choisissez Couche.
Créer une nouvelle couche qui contient deux ou plusieurs couches existantes	Sélectionnez les couches, ouvrez le menu contextuel pour votre sélection, puis choisissez Groupe.
Modifier la couleur d'une couche	Affectez la couleur voulue à sa propriété Couleur.
Spécifier que les artefacts associés à une couche ne doivent pas appartenir aux espaces de noms spécifiés	Tapez les espaces de noms dans la propriété Forbidden Namespaces (Espaces de noms interdits) de la couche.Utilisez un point-virgule (;) pour séparer les espaces de noms.
Spécifier que les artefacts associés à une couche ne peuvent pas dépendre des espaces de noms spécifiés	Tapez les espaces de noms dans la propriété Forbidden Namespace Dependencies (Dépendances d'espaces de noms interdits) de la couche.Utilisez un point-virgule (;) pour séparer les espaces de noms.
Spécifier que les artefacts associés à une couche doivent appartenir à un des espaces de noms spécifiés	Tapez l'espace de noms dans la propriété Required Namespaces (Espace de noms requis) de la couche.Utilisez un point-virgule (;) pour séparer les espaces de noms.

Le nombre indiqué sur une couche représente le nombre d'artefacts liés à cette couche.Toutefois, à la lecture de ce nombre, souvenez-vous de ce qui suit :

Si une couche est liée à un artefact contenant d'autres artefacts, mais n'est pas directement liée à ces autres artefacts, le nombre représentera uniquement les artefacts auxquels elle est directement liée.Toutefois, les autres artefacts sont inclus dans l'analyse pendant la validation de couche.

Par exemple, si une couche est liée à un espace de noms unique, le nombre d'artefacts liés est égal à 1, même si l'espace de noms contient des classes.Si la couche a également des liens vers chaque classe de l'espace de noms, le nombre comprendra les classes liées.
Si une couche contient d'autres couches liées à des artefacts, la couche du conteneur est également liée à ces artefacts, même si le nombre indiqué sur la couche du conteneur ne comprend pas ces artefacts.

Gestion des liens entre les couches et les artefacts

Sur le diagramme de couche, ouvrez le menu contextuel pour la couche, puis choisissez Afficher les liens.

L'Explorateur de couches affiche les liens d'artefact correspondant à la couche sélectionnée.
Utilisez les tâches suivantes pour gérer ces liens :

Pour	Dans l'Explorateur de couches
Supprimer le lien entre la couche et un artefact	Ouvrez le menu contextuel du lien d'artefact, puis choisissez Supprimer.
Déplacer le lien d'une couche vers une autre	Faites glisser le lien d'artefact vers une couche existante sur le diagramme. - ou - Ouvrez le menu contextuel du lien d'artefact, puis choisissez Couper. Sur le diagramme de couche, ouvrez le menu contextuel pour la couche, puis choisissez Coller.
Copier le lien d'une couche vers une autre	Ouvrez le menu contextuel du lien d'artefact, puis choisissez Copier. Sur le diagramme de couche, ouvrez le menu contextuel pour la couche, puis choisissez Coller.
Créer une nouvelle couche à partir d'un lien d'artefact existant	Faites glisser le lien d'artefact vers une zone vide sur le diagramme.
Vérifiez qu'un artefact lié prend en charge la validation par rapport au diagramme de couche.	Recherchez le lien d'artefact dans la colonne Prend en charge la validation.

Rebours des dépendances existantes

Une dépendance existe chaque fois qu'un artefact associé à une couche comporte une référence à un artefact associé à une autre couche.Par exemple, une classe dans une couche déclare une variable qui a une classe dans une autre couche.Vous pouvez effectuer une ingénierie à rebours des dépendances existantes pour les artefacts liés aux couches sur le diagramme.

[!REMARQUE]

Les dépendances ne peuvent pas faire l'objet d'une ingénierie à rebours pour certains genres d'artefacts.Par exemple, aucune dépendance ne fera l'objet d'une ingénierie à rebours depuis ou vers une couche qui est liée à un fichier texte.Pour identifier les artefacts ont des dépendances que vous pouvez effectuer une ingénierie à rebours le, ouvrez le menu contextuel pour un ou plusieurs couches, puis choisir Afficher les liens.Dans l'Explorateur de couches, examinez la colonne Prend en charge la validation.Les dépendances des artefacts pour lesquels cette colonne affiche la valeur False ne feront pas l'objet d'une ingénierie à rebours.

Sélectionnez une ou plusieurs couches, ouvrez le menu contextuel pour une couche sélectionnée, puis choisissez Générer des dépendances.

En général, des dépendances qui ne devraient pas exister s'affichent.Vous pouvez modifier ces dépendances pour les ajuster à la conception prévue.

Modifiez les couches et les dépendances pour afficher la conception prévue

Pour décrire les modifications que vous envisagez d'apporter à votre système ou à l'architecture prévue, modifiez le diagramme de couche :

Pour	Exécuter ces étapes
Changer ou restreindre la direction d'une dépendance	Définissez sa propriété Direction.
Créer de nouvelles dépendances	Utilisez les outils Dépendance et Dépendance bidirectionnelle. Pour dessiner plusieurs dépendances, double-cliquez sur l'outil.Lorsque vous avez terminé, choisissez l'outil Pointeur ou appuyez sur la touche Échap .
Spécifier que les artefacts associés à une couche ne peuvent pas dépendre des espaces de noms spécifiés	Tapez les espaces de noms dans la propriété Forbidden Namespace Dependencies (Dépendances d'espaces de noms interdits) de la couche.Utilisez un point-virgule (;) pour séparer les espaces de noms.
Spécifier que les artefacts associés à une couche ne doivent pas appartenir aux espaces de noms spécifiés	Tapez les espaces de noms dans la propriété Forbidden Namespaces (Espaces de noms interdits) de la couche.Utilisez un point-virgule (;) pour séparer les espaces de noms.
Spécifier que les artefacts associés à une couche doivent appartenir à un des espaces de noms spécifiés	Tapez l'espace de noms dans la propriété Required Namespaces (Espace de noms requis) de la couche.Utilisez un point-virgule (;) pour séparer les espaces de noms.

Modifiez la façon dont les éléments apparaissent sur le diagramme

Vous pouvez modifier la taille, façonner couleurs, et la position des couches ou de la couleur des dépendances en modifiant leurs propriétés.

Voir aussi

Concepts

Visualisation et description du code

Partager via