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 :
- 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.
- Définissez les propriétés de base du pattern en effectuant les étapes suivantes :
- 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.
- 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.
- Dans la liste Type de pattern, sélectionnez le
type de pattern (Classe, Collaboration,
ou Package) que vous créez.
- 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é.
- 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.
- Cliquez sur l'onglet Détails pour afficher la page Détails
de l'assistant Nouveau pattern.
- Saisissez votre nom dans la zone Auteur.
- 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.
- 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.
- Ajoutez les paramètres en effectuant les étapes suivantes :
- Cliquez sur l'onglet Général pour revenir à la page Général de l'assistant Nouveau pattern.
- 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.
- 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.
- Acceptez le nom de classe généré ou changez-le
dans la zone Nom de classe.
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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.
- Cliquez sur OK pour revenir à l'assistant Nouveau pattern.
- Pour ajouter d'autres paramètres, répétez les étapes 3.b à 3.k.
- 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.