Ajout de patterns et de paramètres dans des bibliothèques

Un auteur de pattern peut ajouter un ou plusieurs patterns à la bibliothèque de patterns. Chaque pattern est indépendant pour ce qui est de son fonctionnement et de son application, mais un pattern ne peut être distribué qu'avec sa bibliothèque dans un plug-in de patterns.

Avant d'exécuter ces étapes, vous devez créer une bibliothèque de patterns.

L'assistant Nouveau pattern vous permet de définir les propriétés du pattern et d'ajouter tous ses paramètres de canevas. Une fois le pattern ajouté à la bibliothèque, vous pouvez modifier ses propriétés et lui ajouter, redéfinir ou supprimer des paramètres. Beaucoup d'étapes sont optionnelles. Vous pouvez créer un pattern simple en acceptant toutes les valeurs par défaut.

Pour ajouter un pattern et ses paramètres à la bibliothèque de patterns :

  1. Dans la vue Création de pattern, cliquez avec le bouton droit sur le noeud de bibliothèque, puis sélectionnez Nouveau pattern. La page Général de l'assistant Nouveau pattern apparaît.
  2. Définissez les propriétés de base du pattern en effectuant les étapes suivantes :
    1. Saisissez un nom pour le pattern dans la zone Nom de pattern. Il s'agit du nom qui identifiera le pattern dans la vue Explorateur de patterns.
    2. Acceptez les noms de classe et de package générés à partir du nom de pattern ou modifiez-les dans les zones Nom de classe et Package.
    3. Dans la liste Type de pattern, sélectionnez le type de pattern (Classe, Collaboration, ou Package) que vous créez.
    4. Cliquez sur le bouton Ajouter situé juste à côté de la zone Groupes afin d'ouvrir la fenêtre Ajout de groupe et d'ajouter des noms de groupe au pattern. Les patterns doivent être affectés à au moins un groupe et peuvent être affectés à plusieurs groupes. Tous les patterns apparaissent dans des groupes dans la vue Explorateur de patterns. Le groupe par défaut, Patterns divers, peut être supprimé.
    5. Dans la zone Version, modifiez le numéro de version. Le numéro doit être au format nn nn nn, les n étant des chiffres.
    6. Cliquez sur l'onglet Détails pour afficher la page Détails de l'assistant Nouveau pattern.
    7. Saisissez votre nom dans la zone Auteur.
    8. Tapez une brève description du pattern dans la zone Description abrégée. Cette description apparaîtra sur la page Description abrégée de la vue Explorateur de patterns.
    9. Cliquez sur le bouton Ajouter situé en regard de la zone Mots clés et ajoutez des mots clés pour le pattern. Ajoutez des mots clés qu'un utilisateur de pattern emploierait pour rechercher votre pattern. Les recherches de correspondances s'effectuant également dans les métafichiers du pattern, il n'est pas nécessaire de répéter le contenu des propriétés comme les descriptions ou les noms.
  3. Ajoutez les paramètres en effectuant les étapes suivantes :
    1. Cliquez sur l'onglet Général pour revenir à la page Général de l'assistant Nouveau pattern.
    2. Cliquez sur le bouton Ajouter, à côté de la zone Paramètres, afin d'afficher la page Général de l'assistant Nouveau paramètre de pattern. Vous pouvez toujours ajouter ou modifier des paramètres après avoir fini d'utiliser l'assistant.
    3. Saisissez un nom pour le paramètre dans la zone Nom. Le nom de classe est généré automatiquement à partir du nom de paramètre.
    4. Acceptez le nom de classe généré ou changez-le dans la zone Nom de classe.
    5. Saisissez une brève description du paramètre qui pourra aider l'applicateur du pattern à spécifier les arguments de celui-ci. Cette description apparaîtra sur la page Description abrégée de la vue Explorateur de patterns, ainsi que dans une info-bulle lorsque l'applicateur du pattern fera passer le pointeur de la souris sur le paramètre de canevas dans l'éditeur de diagramme.
    6. Dans le champ Type, acceptez le type UML 2.0 par défaut (Classe) pour le paramètre, ou bien cliquez sur Parcourir et sélectionnez un autre type UML 2.0.
    7. Si le champ Sous-types autorisés est activé, acceptez la valeur par défaut pour que tous les sous-types soient proposés à l'applicateur de pattern comme choix possibles d'arguments, ou bien cliquez sur Parcourir pour sélectionner un jeu limité de sous-types.
    8. Laissez cochée ou désélectionnez la case Autoriser l'entrée de texte comme valeur de l'argument, selon que vous souhaitez ou non autoriser l'applicateur à spécifier ou à créer des arguments en tapant leur nom.
      Remarque : Lorsque vous créez un paramètre avec plusieurs options de sous-type possibles, le sous-type qui est créé à partir du texte entré par l'applicateur de pattern est contrôlé par le code que vous fournissez dans la méthode de mise à jour du paramètre. Si vous ne fournissez pas ce code, un sous-type par défaut, tiré de la liste des sous-types autorisés, est sélectionné.
    9. Si vous êtes en train d'ajouter le premier paramètre du pattern ou que vous ne souhaitez pas ajouter de dépendance de paramètre, passez à l'étape 3.k. Pour ajouter une dépendance, cliquez sur l'onglet Dépendance de paramètre.
    10. Sur la page Dépendance de paramètre, cliquez dans la zone Paramètres existants sur un ou plusieurs noms de paramètre puis sur la flèche droite pour placer ces noms dans la zone Paramètres client ou Paramètres fournisseurs. Lorsque vous affectez un autre paramètre comme paramètre client ou fournisseur, cela ajoute dynamiquement l'affectation réciproque au paramètre que vous ajoutez. Ainsi, le fait d'amener un paramètre existant dans la zone Paramètres fournisseurs affecte le rôle de client au paramètre que vous ajoutez.
    11. Cliquez sur OK pour revenir à l'assistant Nouveau pattern.
    12. Pour ajouter d'autres paramètres, répétez les étapes 3.b à 3.k.
    13. Cliquez sur OK pour refermer l'assistant Nouveau pattern et terminer l'ajout du pattern.
Le nouveau pattern est ajouté comme noeud à la bibliothèque de patterns dans la vue Création de patterns ; le métafichier RAS de support de l'actif de pattern est créé, ainsi que les classes Java du pattern et de chacun des paramètres.
Concepts associés
Patterns de conception IBM Rational
Code de pattern et fichiers d'assistance
Conditions d'utilisation | Retours d'informations
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.