Reverse engineering de descripteur de déploiement d'EJB

Chapter 14 Travailler avec Java

Reverse engineering de descripteur de déploiement d'EJB

Les composants EJB sont définis dans l'élément <enterprise-beans>. Les associations entre classes Bean sont décrites dans l'élément <relationships>, en outre, les types d'EJB sont définis dans les éléments suivants :

Chaque bean d'entité est défini au sein d'un élément <entity>
Chaque bean de session est défini au sein d'un élément <session>
Chaque bean commandé par message (Message Driven Bean) est défini au sein d'un élément <message-driven>

Exemple de <entity>

Le type d'EJB Entity Bean est décrit plus en détail à titre d'exemple dans cette section.

Attributs

Le tableau suivant établit les correspondances entre les éléments et propriétés suivantes :

Elément	Propriété
<description>	Commentaire du composant
<display-name>	Nom du composant
<ejb-name>	Code du composant
<home>	Code d'interface Remote Home
<remote>	Code d'interface Remote
<local-home>	Code d'interface Local Home
<local>	Code d'interface Local
<ejb-class>	Code de classe Bean
<persistence-type>	'Container' pour CMP et 'Bean' pour BMP
<prim-key-class>	Code de classe de clé primaire
<reentrant>	Attribut étendu de composant (reentrant = true/false)
<cmp-version>	Attribut étendu de composant (cmpVersion)

<cmp-field>

Pour chaque attribut persistant, un champ cmp est généré. Le <cmp-field-name> contient le code d'attribut.

<primkey-field>

Si la clé primaire ne se compose que d'un attribut avec un type de données de type java.lang, la classe de clé primaire peut être vide. Dans ce cas, un <primkey-field> contenant le code d'attribut de clé primaire est généré.

<ejb-ref>

<ejb-ref> est utilisé pour la déclaration d'une référence à l'interface Home de l'EJB. Il est généré lorsqu'une dépendance ayant le stéréotype <<ejb-ref>> est liée au bean référencé dans un autre package.

Elément ejb-ref	Résultat dans le diagramme de composants
<ejb-ref-name>	EJB/{Code de l'EJB référencé}
<ejb-ref-type>	Bean d'entité ou de session
<home>	Code de l'interface Home de l'EJB
<remote>	Code de l'interface Remote de l'EJB
<ejb-link>	{Nom qualifié du fichier JAR de l'EJB référencé}#{Code de l'EJB référencé}

<ejb-local-ref>

<ejb-local-ref> est utilisé pour la déclaration d'une référence à l'interface Local Home de l'EJB. Il est généré lorsqu'une dépendance ayant le stéréotype <<ejb-ref>> est liée au bean référencé dans un autre package.

Elément ejb-ref	Résultat dans le diagramme de composants
<ejb-ref-name>	EJB/{Code de l'EJB référencé}
<ejb-ref-type>	Bean d'entité ou de session
<local-home>	Code de l'interface Local Home de l'EJB référencé
<local>	Code de l'interface Local de l'EJB référencé
<ejb-link>	Code de l'EJB référencé

Exemple de <relationships>

Les associations entre classes Bean sont décrites plus en détail à titre d'exemple dans cette section.

Dans l'élément <relationships>, chaque <ejb-relation> définit une association entre deux classes.

Attributs

Le tableau suivant établit les correspondances entre les éléments et propriétés :

Elément	Propriété
<ejb-relation-name>	Code d'association

<ejb-relationship-role>

Chaque extrémité d'association est définie par un élément <ejb-relationship-role>.

Elément ejb-ref	Résultat dans le diagramme de composants
<ejb-relationship-role-name>	Nom de rôle
<multiplicity>	Multiplicité de rôle (Un ou Plusieurs)
<cascade-delete>	Association EXA (roleACMRCascadeDelete ou roleBCMRCascadeDelete)

<relationship-role-source>

Cet élément spécifie l'EJB dont la classe Bean est associée au rôle courant.

Elément ejb-ref	Résultat dans le diagramme de composants
<ejb-name>	Code de l'EJB

<cmr-field>

Dans un rôle navigable, l'attribut migré est généré en tant que <cmr-field>.

Elément ejb-ref	Résultat dans le diagramme de composants
<cmr-field-name>	Code d'attribut migré