Les descripteurs de déploiement JBoss (fichiers jboss-web.xml et jboss.xml) peuvent contenir des références de ressource. Ces références peuvent mapper une référence de ressource à un gestionnaire de ressources ou à une adresse URL de ressource, comme dans l'exemple fourni plus loin.
Pour que ces références fonctionnent correctement dans WebSphere Traditional ou Liberty,
elles doivent être transférées dans le fichier de liaisons de WebSphere
Application Server. Les références Liberty peuvent également être transférées vers le fichier server.xml.
Comme défini dans le fichier DTD de JBoss, la balise <resource-ref> peut contenir trois balises différentes à la suite de la balise <res-ref-name> :
- resource-name
- jndi-name
- res-url
<!ELEMENT resource-ref (res-ref-name , (resource-name | jndi-name | res-url))>
Cette règle s'applique aux balises resource-name et res-url.
< jboss-web>
< span class="indent"> < /span> < span class="indent"> < /span> < reference-ref>
<res-ref-name>ejb /myBean</res-ref-name>
<resource-name>resMgrCourrier</resource-name>
</reference-ref>
...
< span class="indent"> < /span> < span class="indent"> < /span> < resource-managers>
< span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < resource-manager>
<res-name>resMgrCourrier</res-name>
<res-jndi-name>java: Mail</res-jndi-name>
</resource-manager>
</resource-managers>
< jboss>
< span class="indent"> < /span> < span class="indent"> < /span> < enterprise-beans>
< span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < session>
<ejb-name>myBean</ejb-name>
< span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="span class="indent"> < /span> < resource-ref>
<res-ref-name>test / messagerie</res-ref-name>
<resource-name>resMgrMail</resource-name>
</resource-ref>
</session>
</enterprise-beans>
...
< span class="indent"> < /span> < span class="indent"> < /span> < resource-managers>
< span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < resource-manager>
<res-name>resMgrCourrier</res-name>
<res-jndi-name>java: Mail</res-jndi-name>
</resource-manager>
</resource-managers>
Le développeur d'applications peut créer manuellement les liaisons nécessaires avec l'utilitaire IBM(R) Rational(R) Application Developer.
Pour faire les modifications dans Rational Application Developer, procédez comme suit :
- Démarrez l'utilitaire de développement.
- Ouvrez l'EJB ou le projet Web requis.
- Double-cliquez sur le descripteur de déploiement pour ouvrir l'éditeur de descripteur de déploiement.
- Dans l'onglet References, cliquez sur Add.
- Dans la boîte de dialogue, sélectionnez Resource References, puis cliquez sur Next.
- Entrez le nom de la référence de ressource, son type et son type d'authentification.
- Cliquez sur Finish.
- Descendez jusqu'à la section WebSphere Bindings de la page.
- Entrez le nom JNDI correspondant à cette référence de ressource.
Si la section WebSphere Bindings n'apparaît pas dans l'éditeur de descripteur de déploiement, activez les liaisons WebSphere à l'aide de la propriété
Project Facets, dans les propriétés du projet. Pour les projets
EJB, sélectionnez la facette WebSphere EJB (Extended). Pour les projets Web, sélectionnez la facette WebSphere Web (Co-existence).