Définition de packages et d'espaces de noms.

  • Article

Dans Visual Studio Ultimate, un package est un conteneur pour les éléments de définitions UML tels que les classes, les cas d'usage et les composants.Un package peut également contenir d'autres packages.

Dans l'Explorateur de modèles UML, toutes les définitions à l'intérieur d'un package sont imbriquées sous le package.Le modèle UML est un genre de package et forme la racine de l'arborescence.

Dans cette rubrique

Espaces de noms

Création et consultation de packages

Création d'éléments de modèle à l'intérieur des packages

Déplacement d'éléments dans ou hors d'un package

Collage d'éléments dans un package

Importation de relations entre des packages

Références d'un espace de noms à un autre

Propriétés des packages

Espaces de noms

Les packages sont utiles au travail de séparation dans des zones différentes.Chaque package définit un espace de noms afin que les noms définis dans les différents packages ne soient pas en conflit les uns avec les autres.

La propriété de nom qualifié de chaque élément est le nom qualifié du package auquel il appartient, suivi par le propre nom de l'élément.Par exemple, si votre package est appelé MyPackage, une classe dans le package aura un nom qualifié comme MyPackage::MyClass.Étant donné que chaque élément est contenu à l'intérieur d'un modèle, chaque nom qualifié commence par le nom du modèle.

Un modèle définit également un espace de noms, afin que le nom qualifié de chaque élément dans un modèle commence par le nom du modèle.

D'autres éléments de modèle définissent également des espaces de noms.Par exemple, une opération appartient à l'espace de noms défini par sa classe parente, afin que son nom qualifié soit comme MyModel ::MyPackage ::MyClass ::MyOperation.De la même manière, une action appartient à l'espace de noms défini par son activité parente.

Les packages sont des conteneurs.Si vous déplacez ou supprimez un package, les classes, packages, etc. définis à l'intérieur de lui sont également déplacés ou supprimés.Il en va de même des autres éléments qui définissent des espaces de noms.

Création et consultation de packages

Vous pouvez créer un package sur un diagramme de classes UML ou dans l'Explorateur de modèles UML.

Pour créer un package dans un diagramme de classes UML

  1. Ouvrez un diagramme de classes UML ou créez-en un.

  2. Cliquez sur l'outil Package.

  3. Cliquez n'importe où sur le diagramme.Une nouvelle forme de package s'affichera.

    Vous pouvez cliquer à l'intérieur d'un package existant pour imbriquer un package dans un autre.

  4. Tapez un nouveau nom pour le package.

Pour créer un package dans l'Explorateur de modèles UML

  1. Ouvrez l'Explorateur de modèles UML.Dans le menu Architecture, pointez sur Fenêtres, puis cliquez sur l'Explorateur de modèles UML.

  2. Cliquez avec le bouton droit sur un package ou un modèle auquel vous souhaitez ajouter un nouveau package.

    [!REMARQUE]

    Vous pouvez imbriquer un package à l'intérieur d'un autre package.

  3. Pointez sur Ajouter, puis cliquez sur Package.

    Un nouveau package s'affiche dans le modèle.

  4. Tapez un nouveau nom pour le package.

Si vous avez créé un package dans l'Explorateur de modèles UML, vous pouvez l'afficher sur un diagramme de classes UML.Vous pouvez également afficher un package sur plusieurs diagrammes de classes UML.

Pour afficher un package existant sur un diagramme de classes UML

  • Faites glisser le package de l'Explorateur de modèles UML sur le diagramme de classes.

    [!REMARQUE]

    Ainsi est créée une vue du package sur ce diagramme.Cette vue n'affichera pas nécessairement tous les éléments que le package contient.Pour vous assurer que vous affichez tous les contenus d'un package, consultez ce dernier dans l'Explorateur de modèles UML.

Création d'éléments de modèle à l'intérieur des packages

Il existe quatre manières de placer des éléments de modèle à l'intérieur d'un package :

  • Ajoutez un nouvel élément à un package dans l'Explorateur de modèles UML.

  • Ajoutez des classes et d'autres types aux packages dans un diagramme de classes UML.

  • Définissez la propriété LinkedPackage d'un diagramme afin que les nouveaux éléments créés sur le diagramme soient placés à l'intérieur du package que vous spécifiez.Les diagrammes de classes, de composants et de cas d'usage peuvent être liés de cette façon à un package.

  • Déplacez les éléments dans ou hors d'un package dans l'Explorateur de modèles UML.

Un élément dans un package s'affiche sous le package dans l'Explorateur de modèles UML, et son nom qualifié commence par le nom qualifié du package.Pour consulter le nom qualifié de tout élément, cliquez avec le bouton droit sur l'élément, puis cliquez sur Propriétés.La propriété Nom qualifié s'affiche dans la fenêtre Propriétés.

Pour créer un élément dans un package dans l'Explorateur de modèles UML

  1. Ouvrez l'Explorateur de modèles UML.Dans le menu Affichage, pointez sur Autres fenêtres, puis cliquez sur Explorateur de modèles UML.

  2. Cliquez avec le bouton droit sur un package ou un modèle auquel vous souhaitez ajouter un nouvel élément.

  3. Pointez sur Ajouter, puis cliquez sur le genre d'élément que vous souhaitez ajouter.

    Le nouvel élément s'affiche sous le package.

  4. Tapez un nom pour le nouvel élément.

    [!REMARQUE]

    Le nouvel élément ne s'affiche pas sur n'importe quel diagramme.Pour créer une vue du nouvel élément, vous pouvez le faire glisser depuis l'Explorateur de modèles UML sur un diagramme.Le diagramme doit être un type qui affichera ce genre d'élément.

Pour créer un élément dans un package sur un diagramme de classes UML

  1. Ouvrez un diagramme de classes sur lequel le package s'affiche.

    • Créez un nouveau package, si vous ne l'avez pas déjà fait.

    • Pour qu'un package existant apparaissent sur un diagramme de classes, vous pouvez faire glisser le package depuis l'Explorateur de modèles UML sur le diagramme de classes.

  2. Cliquez sur l'outil pour une classe, une interface, une énumération ou un package.

  3. Cliquez sur le package sur lequel vous souhaitez placer le nouvel élément.

    Le nouvel élément s'affiche à l'intérieur du package.

Pour créer tous les éléments d'un diagramme dans un package spécifié

  1. Créez le package, si vous ne l'avez pas déjà fait.

  2. Ouvrez un diagramme de composant, utilisez un diagramme de cas d'usage ou de classes UML.

  3. Ouvrez les propriétés du diagramme.Cliquez avec le bouton droit dans une partie vide du diagramme, puis cliquez sur Propriétés.

  4. Dans la propriété Linked Package, choisissez le package susceptible de contenir le contenu du diagramme.

  5. Créez de nouveaux éléments dans le diagramme.Ceux-ci seront placés dans le package.

    • Le Nom qualifié de chaque élément commencera par le nom qualifié du package.

    • Dans l'Explorateur de modèles UML, chaque élément s'affichera sous le package.

Déplacement d'éléments dans ou hors d'un package

Vous pouvez déplacer un ou plusieurs éléments dans ou hors d'un package.

Si vous déplacez un package, tout ce qui est à l'intérieur de lui se déplace avec lui.

Pour déplacer un élément dans ou hors d'un package

  • Dans l'Explorateur de modèles UML, faites glisser l'élément dans ou hors de l'arborescence dont la racine est le package.

    Le nom qualifié de l'élément changera pour afficher son nouveau package ou modèle propriétaire.

    - ou -

  • Dans un diagramme de classes, faites glisser l'élément dans une forme de package.

    Le nom qualifié de l'élément changera pour afficher son nouveau package propriétaire.

    [!REMARQUE]

    Si vous faites glisser un élément hors d'un package dans une partie vide du diagramme, son package propriétaire ne change pas.Cela vous permet de faire un diagramme qui affiche des éléments de plusieurs packages sans devoir afficher les packages eux-mêmes.

Collage d'éléments dans un package

Vous pouvez coller un élément dans un package.Si vous collez un groupe d'éléments connexes dans un package, leurs relations le seront également.

Pour coller des éléments dans un package sur un diagramme de classes UML

  1. Sur un diagramme de classes UML, sélectionnez tous les éléments que vous souhaitez copier.Cliquez avec le bouton droit sur l'un d'entre eux, puis cliquez sur Copier.

  2. Cliquez avec le bouton droit sur le package, puis cliquez sur Coller.

    [!REMARQUE]

    Le package peut être sur un diagramme différent.

Importation de relations entre des packages

Vous pouvez définir une relation d'importation entre des packages, à l'aide de l'outil Importer.

L'importation signifie que les éléments définis dans le package importé, qui sont les éléments en fin de flèche de la relation, sont aussi définis efficacement dans le package d'importation.Tous les éléments dont la visibilité est définie comme Package seront également visibles dans le package d'importation.

Évitez de créer des boucles dans les relations d'importation.

Références d'un espace de noms à un autre

Si vous souhaitez faire référence à un élément d'un package à partir d'un autre, vous devez utiliser le nom qualifié de l'élément.

.Par exemple, supposons que le package SalesCommon définisse le type CustomerAddress.Dans un autre package RestaurantSales, vous souhaitez définir un type MealOrder, qui a un attribut de type Customer Address.Pour ce faire, vous disposez de deux options :

  • Spécifiez le type de l'attribut à l'aide du nom qualifié complet SalesCommon::CustomerAddress.Vous devez faire cela uniquement si la valeur Public est affectée à la propriété Visibilité de CustomerAddress.

  • Créez une relation d'importation à partir du package RestaurantSales au package SalesCommon.Vous pouvez utiliser ensuite CustomerAddress sans utiliser son nom qualifié.

Propriétés des packages

Chaque package a les propriétés suivantes.Pour consulter les propriétés, cliquez avec le bouton droit sur le package ou sur un diagramme ou dans l'Explorateur de modèles UML, puis cliquez sur Propriétés.

Propriété

Valeur par défaut

Description

Nom

(nouveau nom)

Nom du package.Vous pouvez le modifier sur le diagramme ou dans la fenêtre Propriétés.

Qualified Name

Conteneur:: nom de package

Nom complet, précédé du nom de package ou de modèle qui contient ce package.Pour plus d'informations, consultez Espaces de noms.

Profils

(vide)

Liste des profils liée à ce package.Ces profils fournissent des stéréotypes qui peuvent être appliqués aux éléments à l'intérieur du package.Pour plus d'informations, consultez Personnalisation de votre modèle avec des profils et des stéréotypes.

Visibilité

Public

Visibilité du package à l'extérieur de son package parent.

Éléments de travail

(vide)

Liste d'éléments de travail liés.Pour plus d'informations, consultez Lier des éléments de modèle et des éléments de travail.

Emplacement de définition

(un nom)

Nom de fichier dans lequel les détails du package sont stockés.Les fichiers sont à l'intérieur du dossier de projet ModelDefinition.Ces informations peuvent être utiles à des fins de contrôle de code source.

Description

(vide)

Description du package.

Stéréotypes

(vide)

Stéréotypes appliqués à ce package.La liste de stéréotypes disponible est déterminée par les profils que vous avez choisis pour ce package et les packages qui le contiennent.Pour plus d'informations, consultez Personnalisation de votre modèle avec des profils et des stéréotypes.

Stockage des packages

Lorsque vous créez un nouveau package, un nouveau fichier .uml est créé dans le dossier ModelDefinition du projet.Le modèle racine, qui est également un package, est également stocké dans un fichier .uml.

De plus, chaque diagramme est stocké dans deux fichiers : un fichier qui représente les formes du diagramme et un fichier .layout qui enregistre les positions des formes.

Voir aussi

Référence

Gestion de modèles et graphiques sous contrôle de version

Concepts

Comment : modifier des modèles et diagrammes UML

Diagrammes de classes UML : référence

Diagrammes de classes UML : indications