Les paramètres du moteur MDA

Ecran 1 : Options Source Code Engineering

• Auto generate roles names when creating code : cette option est nécessaire pour que EA ajoute à la classe traitée un attribut (y compris les accesseurs et modifieurs) correspondant à la classe reliée par une association qui ne dispose pas de nom de rôle explicite.
  Le nom de l'attribut est alors généré en reprenant le nom de la classe distante. Si je me réfère à l'exemple de la classe Contrat présentée dans l'étude de cas, elle est reliée à la classe LigneDetail par une association de type composition ne disposant pas de nom de rôle côté LigneDetail. EA a malgré tout généré un membre nommé m_LigneDetail et les accesseur et modifieur correspondant (également désignés getter et setter si j'utilise les termes anglais).
• Do not generate members where association direction is 'Unspecified' : comme son intitulé l'indique, cette option lorsqu'elle est activée, exclut de la transformation les associations pour lesquelles la direction n'est pas spécifiée (valeur de la Direction à unspecified dans les propriétés de l'association).
  En revanche lorsqu'elle est désactivée, EA ajoute à la classe source un attribut correspondant à la classe cible lorsqu'elles sont toutes deux reliées par une association dont la direction est à Unspecified.
  Une association doit être représentée par une double flèche (valeur de la Direction à Bi-Direction dans les propriétés de l'association) pour qu'un attribut de la classe distante soit ajouté aux deux classes reliées entre-elles.
• Remove prefixes when generating Get/Set properties : permet de supprimer les préfixes renseignés dans la liste pour générer les accesseurs et modifieurs dans la classe transformée. Par exemple, pour un attribut nommé m_prenom, l'accesseur se nomme getPrenom() et le modifieur setPrenom().
• Capitalized Attribute Name for Properties : indique lorsque l'option est cochée que le nom de l'attribut doit commencer par une lettre majuscule pour nommer les accesseurs et mutateurs.
  Ce qui donne pour un attribut nommé nom dans le modèle PIM l'accesseur getNom() et le mutateur setNom() dans le modèle PSM.

Ecran 2 : Options Java

• Get prefix et Set prefix : vous pouvez personnaliser le préfixe des méthodes d'accès aux membres des classes. Les valeurs get et set proposées par défaut conviennent cela dit parfaitement.
• Default Collection Class : nom de la classe de collection à utiliser par défaut comme type des membres ajoutés aux classes disposant d'associations 1..*.
  En choisissant par exemple la classe de collection java.util.List, la déclaration du membre m_LigneDetail généré pour la classe Contrat (voir l'exemple de la rubrique Le code Java généré) devient :

             private java.util.List m_LigneDetail;

  Les méthodes d'accès quant à elles deviennent :

             public java.util.List getGroupeUtilisateur() {
                     return m_GroupeUtilisateur;
             }
   
             public void setGroupeUtilisateur(java.util.List newVal){
                     m_GroupeUtilisateur = newVal;
             }

Il est possible d'aller encore plus loin dans la définition des classes de collection en cliquant sur le bouton Collection Classes de l'écran 2.

Ecran 3 : Options Java - Collection Casses

La fenêtre Collection Classes for Association Roles prévoit la saisie d'une classe de collection par défaut pour les associations d'une multiplicité > à 1, mais également une classe de collection en particulier pour les associations dont le rôle cible dispose de l'option ordered ou encore pour les associations disposant d'un ou plusieurs qualificatifs (voir les onglets Source Role ou Target Role dans les propriétés de l'association).

A noter également que EA supporte les collections Java de type Generics. Le mot clé #TYPE# peut être ajouté à la définition de la classe de collection pour préciser le type des objets qu'elle devra contenir. Par exemple :

• Default Collection Class: java.util.Collection<#TYPE#>
• Collection Class for Ordered Multiplicity: java.util.List<#TYPE#>
• Collection Class for Qualified Multiplicity: java.util.Map<KeyType, #TYPE#>

Sachez pour finir que la définition des collections est permise pour une classe en particulier, depuis la fenêtre d'affichage de ses propriétés (menu Element | Properties...) à l'onglet Details en cliquant sur le bouton Collection Classes...

Ecran 4 : propriétés d'une classe UML, onglet Details

La classe pour laquelle la collection est redéfinie correspond aux objets contenus dans la collection en question.

Ecran 5 : options Object Lifetime

• Generate constructor : lorsque cette option est cochée, un constructeur par défaut est ajouté à la classe PSM.
• Generate destructor : ajoute un finaliseur (méthode finalize()) à la classe dans le cas d'un génération en code Java et un destructeur dans les langages objets tels que le C++. Cette option peut à mon sens être décochée compte-tenu du besoin plutôt rare de nettoyage de l'objet avant sa désallocation par le ramasse-miettes
.

Ecran 6 : options Attributes/Operations

• Default name for associated attrib : indique le format des attributs ajoutés à une classe pour accéder aux objets liés dont la multiplicité est supérieure à 1. Par défaut, le format proposé est m_$LinkClass où $LinkClass est le nom de classe de l'objet lié.

Les templates de génération de code (ou modèles de génération de code) sont assez similaires à ceux utilisés par les traitements de transformation.

Ils sont invoqués pour produire le code source du logiciel à partir des classes PSM.

Ils peuvent également être personnalisés en vue de générer du code sur mesure.

Le langage utilisé pour coder les traitements de génération de code correspond à celui utilisé par les templates de transformation.

La documentation en ligne livrée avec EA décrit en détail la syntaxe de ce langage à la rubrique SDK for Enterprise Architect | Code Template Framework in SDK | Code Template Syntax, également consultable sur le site internet de Sparx Systems.

L'éditeur de templates de génération de code est affiché en cliquant dans le menu Settings | Code Generation Templates... (raccourci clavier Ctrl + Maj + P).

Ecran 9 : éditeur des templates de génération de code

A l'instar du processus de transformation, le template File affiché en premier dans la liste intitulée Templates, est le premier appelé par EA à la génération de code.

Je ne passerai pas en revue les templates du langage Java comme j'ai pu le faire au paragraphe précédent, mais je souhaite malgré tout m'arrêter quelques instants sur les templates suivants :

• Templates Class Notes, Attribute Notes, Linked Attribute Notes et Operation Notes : la fonction JAVADOC_COMMENT() ajoute sous forme de commentaires Javadoc les notes renseignées pour les classes et les attributs de classe.
• Templates Import Section : il ajoute en début de fichier du code Java généré, autant d'instructions import que de classes à importer parmi celles renseignées à la génération de code (voir champ Import(s) / Header(s) de la fenêtre Generate Code au paragraphe Génération du code Java).
  Le template se termine par l'appel du template Import chargé d'ajouter une instruction d'import pour chacune des classes reliées (association, généralisation, réalisation et dépendance) connectées à la classe en cours de génération de code.
• Template Operation Body : notez pour ce template-ci, qu'il en existe plusieurs variantes (concept de Stereotype Overrides pour désigner les variantes de code d'un template, applicables à un stéréotype en particulier, voire même à la combinaison de deux stéréotypes).
  Selon le stéréotype de l'opération en cours de traitement par le processus de génération de code, EA choisit le template conçu sur mesure pour générer le code.
  Par exemple pour les opérations stéréotypées property get, EA ajoute dans le corps de la méthode l'instruction return appliquée au membre de la classe pris en charge par l'accesseur.
  Dernier point intéressant, l'usage de la macro de substitution opTag qui associée au nom de la Tagged Value attribute_name, permet de retrouver le nom de l'attribut de classe dont il est question dans l'accesseur. Ce nom d'attribut a été associé à l'opération lors du processus de transformation grâce à la fonctionnalité de Tagged Values disponible dans EA pour associer à tout élément UML, des propriétés supplémentaires à celles prévues en standard.

Maintenant que vous êtes familiers des concepts de transformation de classes UML et de génération de code en langage Java, je vous invite à lire le chapitre suivant Quelques limites rencontrées.