JCA-Aktivierungsspezifikationen konfigurieren

Sie können Aktivierungsspezifikationen konfigurieren, die der Spezifikation Java EE Connector Architecture (JCA) entsprechen.

Informationen zu diesem Vorgang

Sie können eine oder mehrere Instanzen von Aktivierungsspezifikationen konfigurieren, die von einem installierten Ressourcenadapter bereitgestellt werden.
Anmerkung: Zum Konfigurieren der JCA-Unterstützung für Liberty müssen Sie die Datei server.xml in der Quellenansicht des Serverkonfigurationseditors von WebSphere® Application Server Developer Tools for Eclipse oder in einem Texteditor bearbeiten. In diesem Abschnitt wird angenommen, dass ein Ressourcenadapter mit der eindeutigen ID "MyAdapter" bereits im Server konfiguriert wurde. Weitere Informationen finden Sie in der Dokumentation zur Konfiguration von Ressourcenadaptern. Die folgenden Schritte beschreiben ein umfassendes Beispiel für die Konfiguration eines Basisszenarios.
Anmerkung: Die Bearbeitung der Unterelemente "properties" in der Serverkonfiguration für Verbindungsfactorys, verwaltete Objekte, Aktivierungsspezifikationen und Ressourcenadapter in der Designansicht von WebSphere® Development Tools (WDT) wird nicht unterstützt.

Vorgehensweise

  1. Aktualisieren Sie die Datei server.xml, um das Feature jca-1.6 im Tag "featureManager" hinzuzufügen.
    <featureManager> 
    	<feature>jca-1.6</feature> 
    	<feature>jndi-1.0</feature>  <!-- JNDI-Feature hinzufügen, um die Suche von Verbindungsfactorys und verwalteten Objekten zu aktivieren -->   
    		... 
    </featureManager>
  2. Installieren Sie einen Ressourcenadapter. Aktualisieren Sie beispielsweise die Datei server.xml wie folgt:
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
  3. Konfigurieren Sie eine oder mehrere Aktivierungsspezifikationen. Wenn Sie Aktivierungsspezifikationen konfigurieren, müssen Sie ein Unterelement properties angeben, selbst wenn Sie keine Konfigurationseigenschaften überschreiben möchten, um das Element "activationSpec" einem Nachrichtenlistenertyp zuzuordnen, der von einem bestimmten Ressourcenadapter bereitgestellt wird. Im folgenden Beispiel stellt der Ressourcenadapter MyAdapter nur einen einzigen Typ von Nachrichtenlistener bereit:
    <activationSpec id="app1/module1/MyMessageDrivenBean">
     <properties.MyAdapter messageFilter="ALL"/>
    </activationSpec>
  4. Identifizieren Sie, sofern erforderlich, die Namen der properties-Unterelemente für die verfügbaren Aktivierungsspezifikationen.
    • Wenn ein Ressourcenadapter nur eine einzige Nachrichtenlistenerschnittstelle bereitstellt und damit alle JMS-Verbindungsfactorys ausschließt, hat das Unterelement den Namen properties.<RAR-ID>.

    • Wenn der Name der Nachrichtenlistenerschnittstelle ohne den Paketnamen eindeutig ist, hat das Unterelement den Namen properties.<RAR-ID>.<Name_der_Nachrichtenlistenerschnittstelle>.

    • Wenn der Name der Aktivierungsspezifikationsimplementierung ohne den Paketnamen eindeutig ist, hat das Unterelement den Namen properties.<RAR-ID>.<Name_der_Aktivierungsspezifikationsimplementierung>.

    • Wenn der Name der Aktivierungsspezifikationsimplementierung ohne den Paketnamen eindeutig ist, hat das Unterelement den Namen properties.<RAR-ID>.<Name_der_Aktivierungsspezifikationsimplementierung>.

    • In anderen Fällen hat das Unterelement den Namen properties.<RAR-ID>.<vollständig.qualifizierter.Name_der_Nachrichtenlistenerschnittstelle>.

  5. Informationen darüber, wie Sie die Aktivierungsspezifikation einer Message-driven Bean zuordnen, finden Sie in der Dokumentation unter Message-driven Beans implementieren.

Beispiel

Verwenden Sie das folgende Beispiel, um zu lernen, wie Ressourcenadapter mit zwei Nachrichtenlistenertypen mit eindeutigen Schnittstellenklassennamen konfiguriert werden.

Im folgenden Snippet aus einer Datei ra.xml stellt der Ressourcenadapter MyAdapter zwei Nachrichtenlistenertypen mit eindeutigen Schnittstellenklassennamen bereit:

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.CCIActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name>
  <config-property-type>java.lang.Long</config-property-type>
 </config-property>
 ...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MyMessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.MyActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 ...
</activationspec>
...
</messagelistener>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.MessageListener maxSize="1024"/>
</activationSpec> 

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.MyMessageListener messageFilter="ALL"/>
</activationSpec>

Verwenden Sie das folgende Beispiel, um zu lernen, wie Ressourcenadapter mit zwei Nachrichtenlistenertypen mit eindeutigen Implementierungsklassennamen konfiguriert werden.

Im folgenden Snippet aus einer Datei ra.xml stellt der Ressourcenadapter MyAdapter zwei Nachrichtenlistenertypen mit eindeutigen Implementierungsklassennamen bereit:

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec> 
 <activationspec-class>com.vendor.adapter.CCIActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name>
  <config-property-type>java.lang.Long</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MessageListener</messagelistener-type>
<activationspec> 
 <activationspec-class>com.vendor.adapter.MyActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.CCIActivationSpec maxSize="1024"/>
</activationSpec> 

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.MyActivationSpec messageFilter="ALL"/>
</activationSpec>

Verwenden Sie das folgende Beispiel, um zu lernen, wie Ressourcenadapter mit zwei Nachrichtenlistenertypen konfiguriert werden, bei denen weder die einfachen Schnittstellen- noch die Implementierungsklassennamen eindeutig sind.

Im folgenden Snippet aus einer Datei ra.xml stellt der Ressoucenadapter MyAdapter zwei Nachrichtenlistenertypen bereit, bei denen weder die einfachen Schnittstellen- noch die Implementierungsklassennamen eindeutig sind:

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec> 
 <activationspec-class>com.vendor.adapter.cci.ActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name>
  <config-property-type>java.lang.Long</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MessageListener</messagelistener-type> 
<activationspec> 
 <activationspec-class>com.vendor.adapter.ActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.javax.resource.cci.MessageListener maxSize="1024"/>
</activationSpec> 

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.com.vendor.adapter.MessageListener messageFilter="ALL"/>
</activationSpec>

Es ist möglich, die Suffixe von Konfigurationselementnamen zu überschreiben. Wie Sie die Suffixe von Konfigurationselementnamen überschreiben, können Sie den Informationen zum Anpassen von JCA-Konfigurationselementen entnehmen.


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_actspec
Dateiname: twlp_jca_config_actspec.html