UML vers EJB - Notes sur l'édition


1.0 Problèmes connus
   1.1 Des éléments visualisés peuvent masquer des informations
   1.2 Il arrive que des transformations n'actualisent pas des éléments Java
   1.3 Il arrive que des transformations suppriment des éléments Java du code source

1.0 Problèmes connus

1.1 Des éléments visualisés peuvent masquer des informations

Lors de la transformation d'UML en EJB, il arrive que les éléments visualisés du fichier .dnx de diagramme par défaut, dans le projet EJB cible, viennent s'empiler les uns sur les autres et masquent ainsi des informations.

Pour désempiler les éléments visualisés :

  1. Sélectionnez l'élément du dessus.
  2. Cliquez sur Diagramme > Réorganiser > Tout.

1.2 Il arrive que des transformations n'actualisent pas des éléments Java

Une transformation d'UML en EJB risque de ne pas actualiser un élément Java si cet élément est précédé de deux commentaires Javadoc.

Si, par exemple, une transformation génère un élément Java qui contient une balise @generated dans son Javadoc et qu'un autre commentaire Javadoc précède l'élément Java, ce dernier (par exemple, transformGenerated()) ne sera pas actualisé lors de la réapplication de la transformation.

    /**
* Méthode commentée créée par un utilisateur
*/
// private void userCreated() {
// }

/**
* @generated "..."
*/
public void transformGenerated() {
}

Pour pallier ce problème, supprimez les commentaires de la totalité des éléments Java (totalité des définitions de méthodes, de zones, de classes ou d'interfaces) et déplacez-les, sans omettre les éventuels commentaires qui les précèdent, à la fin du fichier source Java avant les accolades finales (}). Notre exemple devra donc ressembler à ceci :

    /**
* @generated "..."
*/
public void transformGenerated() {
}

... fin du fichier source, avant les accolades finales...

/**
* Méthode commentée créée par un utilisateur
*/
// private void userCreated() {
// }

1.3 Il arrive que des transformations suppriment des éléments Java du code source

La transformation d'un UML en EJB peut supprimer un élément Java du code source s'il n'est plus spécifié dans le modèle source.

Par exemple, lors de la réapplication d'une transformation, si une méthode (par exemple, importantUserCreated()) n'est pas définie dans le modèle source, cette méthode sera supprimée du code source, en même temps que le code commenté qui contient le Javadoc.

     /**
* @generated "..."
*/
// public void generatedMethodUserWantsToSave() {
// }

private void importantUserCreated() {
}

Pour pallier ce problème, supprimez les commentaires de la totalité des éléments Java (totalité des définitions de méthodes, de zones, de classes ou d'interfaces) et déplacez-les, sans omettre les éventuels commentaires qui les précèdent, à la fin du fichier source Java avant les accolades finales (}). Notre exemple devra donc ressembler à ceci :

     private void importantUserCreated() {
}

... fin du fichier source, avant les accolades finales...

/**
* @generated "..."
*/
// public void generatedMethodUserWantsToSave() {
// }

Retour au fichier Readme principal