Notions de base relatives au code généré

Lorsque vous définissez une classe de mise en oeuvre, les détails de la mise en oeuvre de l'association sont toujours générés dans les classes d'origine et/ou de destination de l'association navigable.

Les détails de la mise en oeuvre d'une association ne sont pas générés dans le code de l'association, en revanche la génération utilise des balises de documentation spécifiques pour stocker les informations relatives à l'association. Ces balises de commentaire rassemblent tous les détails requis pour recréer l'association à l'issue d'un reverse engineering. Les balises de commentaires de documentation sont traitées lors du reverse engineering afin de rendre possible l'ingénierie par va-et-vient.

Les balises de documentation suivantes sont utilisées :

Avertissement !  

Prenez garde à ne pas modifier ces balises afin de préserver vos possibilités d'ingénierie par va-et-vient.

Dans Java

La syntaxe de tag javadoc est utilisée /**@valeur balise*/.

Dans l'exemple suivant, la balise @pdRoleInfo est utilisée pour stocker des détails de la mise en oeuvre d'association, et @pdGenerated est utilisée pour indiquer que la méthode getter est automatiquement générée et ne doit pas faire l'objet d'un reverse engineering.

   /**@pdRoleInfo name=Person coll=java.util.Collection impl=java.util.LinkedList mult=1..* */
   public java.util.Collection employee;
   /** @pdGenerated default getter */
 public java.util.Collection getEmployee()
   {
      if (employee == null)
         employee = new java.util.HashSet();
      return employee;
   }
...

Dans C#

La balise de documentation ///<valeur balise /> est utilisée.

Dans l'exemple suivant, la balise <pdRoleInfo> est utilisée pour stocker les détails de mise en oeuvre d'association, et <pdGenerated> est utilisée pour indiquer que la méthode getter est automatiquement générée et ne doit pas faire l'objet d'un reverse engineering.

   ///<pdRoleInfo name='Person' coll='System.CollectionsArrayList' impl='java.util.LinkedList' mult='1..*' type='composition'/>
   public java.util.Collection employee;
   ///<pdGenerated> default getter </pdGenerated>
...

Dans VB .NET

La balise de documentation "<valeur balise /> est utilisée.

Dans l'exemple suivant, la balise <pdRoleInfo> est utilisée pour stocker les détails de la mise en oeuvre d'association, et <pdGenerated> est utilisée pour indiquer que la méthode getter est automatiquement générée et ne doit pas faire l'objet d'un reverse engineering.

   "<pdRoleInfo name='Person' coll='System.CollectionsArrayList' impl='java.util.LinkedList' mult='1..*' type='composition'/>
   public java.util.Collection employee;
   "<pdGenerated> default getter </pdGenerated>
...