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.

Wie in der DTD JBoss definiert, kann der <resource-ref>-Tag drei verschiedene Tags haben verschiedene Tags nach dem <res-ref-name>-Tag haben:

<!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>
<reference-ref>
<res-ref-name>ejb/myBean</res-ref-name>
<resource-name>resMgrMail</resource-name>
</reference-ref>
...
<resource-managers>
<resource-manager>
<res-name>resMgrMail</res-name>
<res-jndi-name>java:Mail</res-jndi-name>
</resource-manager>
</resource-managers>

Konstrukte in jboss.xml
<jboss>
<enterprise-beans>
<session>
<ejb-name>myBean</ejb-name>
<resource-ref>
<res-ref-name>test/E-Mail</res-ref-name>
<resource-name>resMgrMail</resource-name>
</resource-ref>
</session>
</enterprise-beans>
...
<resource-managers>
<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 Fertigstellen.
  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.