Propriétés d'une opération

Pour visualiser ou modifier les propriétés d'une opération, double-cliquez sur son symbole dans le diagramme ou sur l'entrée correspondante dans l'Explorateur d'objets ou dans une liste. Les onglets de feuille de propriétés et zones répertoriés ici sont ceux disponibles par défaut, avant toute personnalisation de l'interface par vous ou par un administrateur.

L'onglet Général contient les propriétés suivantes :

Propriété

Description

Parent

Spécifie le classificateur parent auquel l'opération appartient.

Nom/Code/Commentaire

Identifient l'objet. Le nom doit permettre à des utilisateurs non spécialistes de savoir à quoi sert l'objet, tandis que le code, qui est utilisé afin de générer du code ou des scripts, peut être abrégé, et ne doit normalement contenir aucun espace. Vous pouvez également spécifier un commentaire afin de fournir des informations plus détaillées sur l'objet. Par défaut, le code est généré à partir du nom en appliquant les conventions de dénomination spécifiées dans les options du modèle. Pour supprimer la synchronisation du nom et du code, cliquez sur le bouton = en regard de la zone Code.

Stéréotype

Etend la sémantique de l'objet au-delà de la définition UML. Vous pouvez saisir un stéréotype directement dans cette zone, ou bien ajouter des stéréotypes dans la liste en les spécifiant dans un fichier d'extension.

Les stéréotypes communs suivants sont disponibles par défaut :
  • <<constructor>> - Opération appelée lors de l'instanciation d'un objet et qui crée une instance d'une classe

  • <<create>> - Opération utilisée par une classe lorsqu'elle instancie un objet.

  • <<destroy>> - Opération utilisée par une classe et qui détruit une instance d'une classe

  • <<storedProcedure>> - Opération qui deviendra une procédure stockée dans le MPD généré

  • <<storedFunction>> - Opération qui deviendra une fonction stockée dans le MPD généré

  • <<EJBCreateMethod>> - CreateMethod spécifique aux EJB

  • <<EJBFinderMethod>> - FinderMethod spécifique aux EJB.

  • <<EJBSelectMethod>> - SelectMethod spécifique aux EJB.

Pour plus d'informations sur les méthodes spécifiques aux EJB, voir Définition d'opérations pour un EJB.

Type de résultat

Une liste de valeurs renvoyées par un appel de l'opération. Si l'opération ne renvoie aucune valeur, la valeur Type de résultat est NULL

Visibilité

[opérateurs de classe] Visibilité de l'opération, dont les valeurs indiquent comment elle est perçue hors de son espace de noms. N'existe que dans les classes :
  • Private - Uniquement par la classe à laquelle elle appartient

  • Protected - Uniquement par la classe et ses objets dérivés.

  • Package - Par tous les objets du même package.

  • Public - Par tous les objets

Evénement de langage

Lorsque les classes représentent des éléments d'interfaces, cette zone permet de montrer une opération comme déclenchée par une occurrence significative d'un événement.

Statique

L'opération est associée à la classe, les opérations statiques sont donc partagées par toutes les instances de la classe et ont la même valeur pour toutes ces instances.

Tableau

Indicateur définissant le type de résultat de l'opération. A la valeur "true" si la valeur renvoyée est un tableau.

Abstrait

Indique que l'opération ne peut pas être instanciée et qu'elle n'est donc dotée d'aucune instance directe.

Final

Indique que l'opération ne peut pas être redéfinie

Lecture seule

Opération dont l'exécution ne change pas l'instance de la classe.

Méthode de service Web

Si affichée et sélectionnée, implique que l'opération est utilisée comme méthode de service Web.

Objet influent

Opération qui influence l'opération courante. Les liens d'influence les plus courants sont "Redéfinit" et "'Met en oeuvre", décrits ci-dessous.

Redéfinit

Indique quelle opération parent l'opération courante redéfinit via un lien de généralisation.

Met en oeuvre

Nom de l'opération d'interface que l'opération courante met en oeuvre via un lien de réalisation.

Générique

Spécifie que l'opération est une méthode générique (voir Types et méthodes génériques).

Mots clés

Permet de grouper de façon informelle des objets. Pour saisir plusieurs mots clés, séparez-les de virgules.

Onglet Paramètres

L'onglet Paramètres répertorie les paramètres de votre opération. Chaque paramètre est une variable qui peut être modifiée, transmise ou renvoyée. Les propriétés d'un paramètre sont les suivantes :

Propriété

Description

Parent

Spécifie l'opération à laquelle le paramètre appartient.

Nom

Spécifie le nom de l'élément. Il doit s'agir d'un nom clair et explicite, qui permette à des utilisateurs non spécialistes de savoir à quoi sert l'élément.

Code

Spécifie le nom technique de l'élément, qui est utilisé pour la génération de code ou de scripts.

Commentaire

Commentaire descriptif relatif à l'objet.

Type de données

Série d'instances qui partagent les mêmes opérations, attributs abstraits, relations et sémantique

Tableau

Lorsque sélectionné, permet de présenter les attributs sous forme de tableau.

Taille de tableau

Spécifie une taille de tableau précise lorsque la multiplicité est supérieure à 1.

Argument variable

Spécifie que la méthode peut prendre un nombre variable de paramètres pour un argument donné. Vous ne pouvez sélectionner cette propriété que si le paramètre est le dernier de la liste.

Type de paramètre

Direction du flux d'information du paramètre. Indique le type de valeur renvoyé lorsque le paramètre est appelé par l'opération lors de la procédure d'exécution. Vous pouvez définir les valeurs suivantes pour le type de paramètre :
  • Entrée - Paramètre d'entrée passé par une valeur. La valeur finale ne peut pas être modifiée et l'information n'est pas disponible pour l'appelant

  • Entrée/Sortie - Paramètre d'entrée qui peut être modifié. La valeur finale peut être modifiée pour communiquer l'information à l'appelant

  • Sortie - Paramètre de sortie. La valeur finale peut être modifiée pour communiquer l'information à l'appelant

Valeur par défaut

Valeur par défaut lorsqu'un paramètre est omis. Par exemple :

Vous utilisez une opération oper(string param1, integer param2), et spécifiez deux arguments oper(val1, val2) lors de l'invocation. Certains langages, par exemple C++, permettent de définir une valeur par défaut qui est ensuite mémorisée lorsque le paramètre est omis lors de l'invocation.

Si la déclaration de la méthode est oper(string param1, integer param2 = default), l'invocation oper(val1) équivaut à oper(val1, default).

Type de données WSDL

Uniquement disponible avec les services Web. Définit le type XML Schema/ SOAP utilisé lors de l'appel d'une méthode Web (en utilisant HTTP ou Soap)

Onglet Mise en oeuvre

L'onglet Mise en oeuvre permet de spécifier le code qui sera utilisé pour mettre en oeuvre l'opération, et contient les sous-onglets suivants, en bas de la boîte de dialogue :

Elément

Description

Corps

Code de la mise en oeuvre

Exceptions

Signal émis en réponse à une erreur de comportement lors de l'exécution du système. Utilisez l'outil Ajouter une exception pour sélectionner un classificateur d'exception à ajouter à l'emplacement du curseur.

Pré-condition

Contrainte qui doit être vérifiée lorsqu'une opération est appelée.

Post-condition

Contrainte qui doit être vérifiée à la fin d'une opération.

Spécification

Similaire à un pseudo code, il s'agit de la description d'une séquence normale d'actions.

Les onglets suivants sont également disponibles :

  • Générique - permet de spécifier les paramètres de type d'une méthode générique (voir Types et méthodes génériques)

  • Diagrammes associés - répertorie et permet d'ajouter des diagrammes de modèles liés à l'opération (voir Guide des fonctionnalités générales > L'interface de PowerAMC > Diagrammes, matrices et symboles > Diagrammes > Spécification de diagrammes comme diagrammes associés).