Ressourcenreferenz erstellen oder ändern

Eine Ressourcenreferenz unterstützt den Zugriff des von Anwendungen auf eine Ressource (z. B. eine Datenquelle, einen URL oder einen Mail-Provider) durch Angabe eines logischen Namens an Stelle des tatsächlichen Namens in der Laufzeitumgebung. Mit dieser Funktionalität ist es nicht mehr erforderlich, Anwendungscode zu ändern, wenn die Laufzeitkonfigurationen von Ressourcen geändert werden.

Vorbereitende Schritte

Dieser Artikel führt Sie durch die Aktualisierung der Ressourcenreferenzen einer Unternehmensanwendung, die Sie zuvor assembliert haben. Im Artikel "Anwendungen assemblieren" wird die Assemblierungsprozedur detailliert beschrieben.

Informationen zu diesem Vorgang

Ressourcenreferenzen werden im Implementierungsdeskriptor vom Anwendungsprovider deklariert. Während der Anwendungsimplementierung müssen Sie die Ressourcenreferenz an den tatsächlichen Namen der Ressource in der Laufzeitumgebung binden. Wenn Sie eine Verbindungsfactory oder eine Datenquelle im Anwendungsserver erstellen, stellt der Anwendungsserver einen JNDI-Namen bereit, den eine Komponente verwenden kann, um auf die Verbindungsfactory bzw. Datenquelle zuzugreifen. Der Anwendungsserver verwendet einen indirekten Namen mit dem Präfix "java:comp/env". Beispiele:
  • Wenn Sie eine Datenquelle erstellen, wird der JNDI-Standardname auf "jdbc/Name_der_Datenquelle" gesetzt.
  • Wenn Sie eine Verbindungsfactory erstellen, ist der Standardname "eis/Name_der_J2C-Verbindungsfactory".
Wenn Sie diese Werte durch eigene Angaben überschreiben, müssen Sie das Präfix "java:comp/env" beibehalten. Ein indirekter JNDI-Name ermöglicht der Infrastruktur für die Verbindungsverwaltung auf alle Daten über eine Ressourcenreferenz zuzugreifen, die der Anwendung zugeordnet ist. Dies ermöglicht Ihnen eine effizientere Verwaltung von Ressourcen auf der Basis der Einstellungen für Authentifizierung, Isolationsstufe, Geltungsbereich der gemeinsamen Nutzung und Auflösungssteuerung.

In diesem Artikel wird beschrieben, wie Sie die Ressourcenreferenzen einer Unternehmensanwendung mit einem Assembliertool aktualisieren. Nach der Definition der Ressourcenreferenz können Sie indirekte JNDI-Lookup-Operationen über den Kontext "java:comp/env" durchführen.

Vorgehensweise

  1. Starten Sie ein Assembliertool.
  2. Konfigurieren Sie das Assembliertool, falls noch nicht geschehen, für Java-EE-Module.
  3. Importieren Sie die Unternehmensanwendung (EAR-Datei), die Sie ändern möchten, in das EJB-Projekt.
  4. Gehen Sie wie folgt vor, um die Ressourcenreferenzen für den Typ des Moduls anzuzeigen:
    • Wenn die Ressourcenreferenz von einer Enterprise-Bean verwendet wird:
      1. Klicken Sie auf den Namen der EAR-Datei.
      2. Klicken Sie auf EJB Modules.
      3. Klicken Sie auf das gewünschte EJB-Modul.
      4. Klicken Sie auf den Typ der Enterprise-Bean (Session-Beans oder Entity-Beans).
      5. Klicken Sie auf die Enterprise-Bean.
    • Wenn die Ressourcenreferenz von einem Servlet verwendet wird:
      1. Klicken Sie auf den Namen der EAR-Datei.
      2. Klicken Sie auf Web Modules.
      3. Blenden Sie das gewünschte Webmodul ein.
    • Wenn die Ressourcenreferenz von einem Anwendungsclient verwendet wird:
      1. Klicken Sie auf den Namen der EAR-Datei.
      2. Klicken Sie auf Application Clients.
      3. Klicken Sie auf das gewünschte Application-Client-Modul.
  5. Klicken Sie mit der rechten Maustaste auf das Modul, dessen Ressourcenreferenzen Sie ändern möchten, und klicken Sie anschließend auf Open With > Deployment Descriptor Editor.
  6. Klicken Sie für Servlets und Anwendungsclients auf Add. Wählen Sie für EJB-Module die gewünschte Bean aus, und klicken Sie auf Add.
  7. Wählen Sie die Ressourcenreferenzoption aus, und klicken Sie auf Next.
  8. Geben Sie die Einstellungen für die Ressourcenreferenz an, und klicken Sie auf Finish.
  9. Optional: Wählen Sie das Register References und anschließend unter WebSphere Extensions eine Isolationsstufe aus. Wenn diesen Schritt überspringen, wird standardmäßig die Isolationsstufe TRANSACTION_NONE verwendet.
  10. Optional: Geben Sie unter WebSphere Bindings einen JNDI-Namen ein. Wenn Sie diesen Schritt überspringen, können Sie die Bindung bei der Implementierung der Anwendung definieren (oder überschreiben).
  11. Schließen Sie den Editor für Implementierungsdeskriptoren, und speichern Sie Ihre Änderungen.

Ergebnisse

Dateien für das aktualisierte Modul werden in der Ansicht "Project Explorer" angezeigt.

Nächste Schritte

Überprüfen Sie den Inhalt der aktualisierten Unternehmensanwendung in der Ansicht "Project Explorer". Implementieren Sie anschließend Ihre Unternehmensanwendung.

Sie können in einem Schritt EJB-Implementierungscode generieren und das Modul in einem Zielserver implementieren. Klicken Sie in der Ansicht "Project Explorer" mit der rechten Maustaste auf das EJB-Projekt, und klicken Sie dann auf Deploy. Sehen Sie sich auch den Artikel "EJB-Module implementieren" an.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tatk_crtresref
Dateiname:tatk_crtresref.html