Ressourcenreferenzen für URLs und Ressourcenmanager manuell migrieren

Die JBoss-Implementierungsdeskriptoren jboss-web.xml und jboss.xml können Ressourcenreferenzen enthalten, die die Ressourcenreferenz einem Ressourcenmanager oder einer Ressourcen-URL zuordnen, wie im folgenden Beispiel gezeigt wird. Damit die Referenzen ordnungsgemäß in WebSphere Traditional oder Liberty funktionieren, müssen sie in die Bindungsdatei von WebSphere Application Server umgesetzt werden. Alternativ können Liberty-Referenzen in die Datei server.xml verschoben werden.

Gemäß Definition in der JBoss-DTD kann den Tag <resource-ref> hinter dem Tag <res-ref-name> drei unterschiedliche Tags enthalten:

<!ELEMENT resource-ref (res-ref-name , (resource-name | jndi-name | res-url))>

Diese Regel markiert die Fälle "resource-name" und "res-url".

Konstrukte der Datei jboss-web.xml
< jboss-web>
< span class="indent"> < /span> < span class="indent"> < /span> < Referenz-ref>
<res-ref-name>ejb/myBean</res-ref-name>
<resource-name>resMgrMail</resource-name>
</reference-ref>
...
< span class="indent"> < /span> < span class="indent"> < /span> < Ressourcenmanager>
< span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < resource-manager>
<res-name>resMgrMail</res-name>
<res-jndi-name>java: Mail</res-jndi-name>
</resource-manager>
</resource-managers>

Konstrukte der Datei jboss.xml
< 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="indent"> < /span> < resource-ref>
<res-ref-name>test/mail</res-ref-name>
<resource-name>resMgrMail</resource-name>
</resource-ref>
</session>
</enterprise-beans>
...
< span class="indent"> < /span> < span class="indent"> < /span> < Ressourcenmanager>
< span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < span class="indent"> < /span> < resource-manager>
<res-name>resMgrMail</res-name>
<res-jndi-name>java: Mail</res-jndi-name>
</resource-manager>
</resource-managers>


Manuelle Migration:

Der Anwendungsentwickler kann die Bindungen manuell mit dem Tool IBM(R) Rational(R) Application Developer erstellen. Gehen Sie wie folgt vor, um die erforderlichen Änderungen in Rational Application Developer vorzunehmen:

  1. Starten Sie das Entwicklertool.
  2. Öffnen Sie das richtige EJB- bzw. Webprojekt.
  3. Klicken Sie doppelt auf den Implementierungsdeskriptor, um den Editor für Implementierungsdeskriptoren zu öffnen.
  4. Klicken Sie auf der Registerkarte "Referenzen" auf Hinzufügen.
  5. Wählen Sie in diesem Dialog "Ressourcenreferenzen" und anschließend Weiter aus.
  6. Geben Sie die Ressourcenreferenz, den Namen, den Typ und den Authentifizierungstyp ein.
  7. Klicken Sie auf Fertig stellen.
  8. Blättern Sie zum Abschnitt "WebSphere-Bindungen" der Seite vor.
  9. Geben Sie den JNDI-Namen für diese Ressourcenreferenz ein.

Wenn der Abschnitt "WebSphere-Bindungen" im Editor für Implementierungsdeskriptoren nicht sichtbar ist, aktivieren Sie die Bindungen über die Projektfacetten in den Projekteigenschaften. Für EJB-Projekte wählen Sie die Facette "WebSphere-EJB (erweitert)" aus. Für Webprojekte wählen Sie die Facette "WebSphere-Web (Koexistenz)" aus.