Ressourcenadapter konfigurieren

Sie können Ressourcenadapter konfigurieren, die der Spezifikation Java™ EE Connector Architecture (JCA) Version 1.6, 1.5 oder 1.0 entsprechen.

Informationen zu diesem Vorgang

Sie können einen Ressourcenadapter und die verschiedenen Verbindungsfactorys, verwalteten Objekte und Aktivierungsspezifikationen gemäß Definition in der JCA-Spezifikation installieren und konfigurieren.

Vorgehensweise

  1. Aktualisieren Sie die Datei server.xml, um das Feature jca-1.6 im Tag "featureManager" hinzuzufügen. Sie finden die Datei server.xml unter [Pfad_zu_Liberty\wlp\usr\servers\Servername].
     <featureManager>
      <feature>jca-1.6</feature>
     </featureManager>
  2. (Optional) Aktivieren Sie die folgenden zusätzlichen Features basierend auf den Anforderungen Ihres Systems:
    • Wenn Ihr Ressourcenadapter JMS-Spezifikationsschnittstellen bereitstellt, aktivieren Sie das Feature jms-1.1.
      <feature>jms-1.1</feature>
    • Wenn Sie Verbindungsfactorys und verwaltete Objekte Ihrer Anwendung suchen möchten, aktivieren Sie das Feature jndi-1.0.
      <feature>jndi-1.0</feature>
    • Wenn Ihr Ressourcenadapter Aktivierungsspezifikationen für Message-driven Beans bereitstellt, aktivieren Sie das Feature mdb-3.1 .
      <feature>mdb-3.1</feature>
    • Wenn Ihr Ressourcenadapter eingehende Sicherheit unterstützt, aktivieren Sie das Feature jcaInboundSecurity-1.0.
      <feature>jcaInboundSecurity-1.0</feature>
    • Wenn Ihr Ressourcenadapter Beanvalidierung unterstützt, können Sie das Feature beanValidation-1.0 aktivieren.

      <feature>beanValidation-1.0</feature>
  3. Konfigurieren Sie einen oder mehrere Ressourcenadapter im Server. Sie können eine der folgenden Methoden zum Konfigurieren des Ressourcenadapters verwenden.
    • Konfigurieren Sie einen eigenständigen Ressourcenadapter, indem Sie die Datei server.xml bearbeiten.
      <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    • Konfigurieren Sie einen integrierten Ressourcenadapter, indem Sie die Datei server.xml bearbeiten, um eine Anwendung zu installieren, die einen oder mehrere Ressourcenadapter integriert. Das folgende Beispiel setzt voraus, dass die Datei app1.ear eine oder mehrere RAR-Dateien enthält:
       <application location="C:/applications/app1.ear"/>
    • Durch Speichern der RAR-Datei im Serverordner "dropins" kann der Server einen eigenständigen Ressourcenadapter automatisch konfigurieren.
       wlp/usr/servers/Name-Ihres-Servers/dropins/MyDropinAdapter.rar
    • Durch Speichern der EAR-Datei im Serverordner "dropins" kann der Server einen oder mehrere integrierte Ressourcenadapter automatisch konfigurieren. Das folgende Beispiel setzt voraus, dass die Datei app2.ear eine oder mehrere RAR-Dateien enthält:
      wlp/usr/servers/Name-Ihres-Servers/dropins/app2.ear
  4. Starten Sie den Anwendungsserver. Nachdem der Server gestartet ist, werden Nachrichten ähnlich den folgenden in der Datei console.log angezeigt:
    [AUDIT ] J2CA7001I: Der Ressourcenadapter MyAdapter wurde innerhalb von 0,495 Sekunden installiert. [AUDIT ] J2CA7001I: Der Ressourcenadapter MyDropinAdapter wurde innerhalb von
    0,311 Sekunden installiert. [AUDIT ] J2CA7001I: Der Ressourcenadapter app1.MyEmbeddedAdapter wurde innerhalb von 0,247 Sekunden installiert.
    [AUDIT ] J2CA7001I: Der Ressourcenadapter app2.anotherEmbeddedAdapter wurde innerhalb von 0,518 Sekunden installiert. 

Beispiel

Ein Ressourcenadapter benötigt eine eindeutige ID, damit konfigurierte Verbindungsfactory-Instanzen, verwaltete Objekte und Aktivierungsspezifikationen als zum installierten Ressourcenadapter zugehörige Elemente angegeben werden können. Bei eigenständigen Ressourcenadaptern wird als ID der Modulname verwendet. Bei Ressourcenadaptern in integrierten Anwendungen wird die Kombination aus dem Anwendungsnamen und dem Modulnamen (voneinander durch einen Punkt abgetrennt) als ID verwendet.

  • Geben Sie Folgendes ein, wenn Sie für einen eigenständigen Ressourcenadapter Eigenschaften mit einem Unterelement properties.MyAdapter, das die Ressourcenadapter-ID "MyAdapter" enthält, angeben möchten:

    <resourceAdapter location="C:/adapters/MyAdapter.rar">
      <properties.MyAdapter logFile="${server.output.dir}/logs/myAdapter.log"/>
    </resourceAdapter>
  • Geben Sie Folgendes ein, wenn Sie eine Verbindungsfactory einem eigenständigen Ressourcenadapter mit einem Unterelement properties.MyAdapter, das die Ressourcenadapter-ID "MyAdapter" enthält, zuordnen möchten:

    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    <connectionFactory jndiName="eis/cf">
     <properties.MyAdapter serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • Geben Sie Folgendes ein, um eine Verbindungsfactory einem Ressourcenadapter "MyEmbeddedAdapter" mit einem Unterelement properties.app1.MyEmbeddedAdapter zuzuordnen, der in der Anwendung app1 aktiviert ist:

    <application location="C:/applications/app1.ear"/>
    <connectionFactory jndiName="eis/cf">
     <properties.app1.MyEmbeddedAdapter serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • In einigen Fällen ist der Modulname nicht eindeutig genug, um als ID zu fungieren. Dieser Fall könnte beispielsweise eintreten, wenn Sie zwei verschiedene Versionen desselben Ressourcenadapters installieren. In einem anderen Fall könnte zwar der Modulname eindeutig sein, jedoch für die Verwendung in der Konfiguration ungeeignet, weil er zu lang ist oder nicht alphanumerische Zeichen enthält. Sie können die Ressourcenadapter-ID durch Angabe des ID-Attributs überschreiben.

    Das folgende Beispiel veranschaulicht, wie Sie die ID für eigenständige Ressourcenadapter überschreiben:

    <resourceAdapter id="MyAdapterV1" location="C:/adapters/version-1.0/MyAdapter.rar"/>
    <resourceAdapter id="MyAdapterV2" location="C:/adapters/version-2.0/MyAdapter.rar"/>
    <connectionFactory jndiName="eis/cf1">
     <properties.MyAdapterV1 serverName="localhost" portNumber="1234"/>
    </connectionFactory>
    <connectionFactory jndiName="eis/cf2">
     <properties.MyAdapterV2 serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • Das folgende Beispiel veranschaulicht, wie Sie die ID für einen Ressourcenadapter überschreiben, der in einer Anwendung integriert ist. Im Beispiel wird die ID in "MyEmbeddedRA" geändert:

    <application location="C:/applications/app1.ear">
     <resourceAdapter id="MyEmbeddedAdapter" alias="MyEmbeddedRA"/>
    </application>
    <connectionFactory jndiName="eis/cf">
     <properties.app1.MyEmbeddedRA serverName="localhost" portNumber="1234"/>
    </connectionFactory>
  • Wenn Sie den Modulnamen für integrierte Ressourcenadapter berechnen möchten, hat der Eintrag <module-name> im Implementierungsdeskriptor des Ressourcenadapters (ra.xml) Vorrang vor dem Modulnamen. Sehen Sie sich dazu beispielsweise die folgende Definition in der Datei ra.xml an:

    <connector ...> 
    	<module-name>MyRARModule</module-name> 
    </connector>

    Laut dieser Definition wird der Modulname auf "MyRARModule" gesetzt.

    Wenn der Modulname im Implementierungsdeskriptor des Connectors nicht vorhanden ist, wird die Kurzform der URI verwendet, die sich auf das Ressourcenadaptermodul im Anwendungsimplementierungsdeskriptor (application.xml) bezieht. Sehen Sie sich dazu beispielsweise die folgende Moduldefinition in der Datei application.xml an:

    <module>         
    	<connector>connectors/MyRARModule.rar</connector>     
    </module>

    Laut dieser Definition wird der Modulname "MyRARModule" berechnet.

    Wenn mehrere Ressourcenadapter in einer Anwendung integriert sind, die denselben Wert <module-name> definieren, verwendet der Ressourcenadapter den Modulnamen, der in der Datei "application.xml" an erster Stelle aufgelistet ist. Die Modulnamen der übrigen Connectors mit demselben problematischen Namen werden aus der vollständigen Form des URI berechnet, wobei alle normalen Schrägstriche (/) in einen Punkt (.) konvertiert werden. Angenommen zwei in einer Anwendung integrierte Connectors haben die folgende Definition in der Datei ra.xml:

    <connector ...> 
    	<module-name>MyRARModule</module-name> 
    </connector>

    und die folgenden Definitionen in der Datei application.xml:

    <module>         
    	<connector>subfolder1/connector1.rar</connector>     
    </module>     
    <module>         
    	<connector>subfolder2/connector2.rar</connector>     
    </module>

    Daraus würde als Modulname für den ersten Connector der Name "MyRARModule" resultieren und der Modulname für den zweiten Connector wäre "subfolder2.connector2.rar"


Symbol das den Typ des Artikels anzeigt. Taskartikel



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