Verwaltete JCA-Objekte konfigurieren

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

Informationen zu diesem Vorgang

Sie können eine oder mehrere Instanzen von verwalteten Objekten 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 ermöglichen-->   
    		... 
    </featureManager>
  2. Installieren Sie einen Ressourcenadapter. Aktualisieren Sie beispielsweise die Datei server.xml wie folgt:
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
  3. Konfigurieren Sie ein oder mehrere verwaltete Objekte. Wenn Sie Instanzen verwalteter Objekte konfigurieren, müssen Sie ein Unterelement properties angeben, selbst wenn Sie keine Konfigurationseigenschaften überschreiben möchten, um das Element "adminObject" einem Typ verwalteter Objekte zuzuordnen, der von einem bestimmten Ressourcenadapter bereitgestellt wird. Im folgenden Beispiel stellt der Ressourcenadapter MyAdapter nur einen einzigen Typ verwalteter Objekte bereit:
    <adminObject jndiName="eis/interactionSpec">
     <properties.MyAdapter functionName="find" executionTimeout="5000"/>
    </adminObject>
  4. (Optional) Identifizieren Sie, sofern erforderlich, die Namen der properties-Unterelemente für die verfügbaren verwalteten Objekte.
    • Wenn ein Ressourcenadapter nur eine einzige Schnittstelle für verwaltete Objekte bereitstellt und damit alle JMS-Ziele, -Warteschlangen und -Topics ausschließt, hat das Unterelement den Namen properties.<RAR-ID>.

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

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

    • Wenn die Kombination von Schnittstellenname und Implementierungsname ohne den Paketnamen eindeutig ist, hat das Unterelement den Namen properties.<RAR-ID>.<Schnittstellenname>-<Implementierungsname>.

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

Beispiel

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

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

<adminobject>
<adminobject-interface>javax.resource.cci.ConnectionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.ConnectionSpecImpl</adminobject-class>
<config-property> 
 <config-property-name>isolationLevel</config-property-name>
 <config-property-type>java.lang.Integer</config-property-type>
</config-property>
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.InteractionSpecImpl</adminobject-class>
<config-property>
 <config-property-name>FunctionName</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
</config-property>
... 
</adminobject>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<adminObject jndiName="eis/connectionSpec">
 <properties.MyAdapter.ConnectionSpec isolationLevel="4"/>
</adminObject>

<adminObject jndiName="eis/interactionSpec">
 <properties.MyAdapter.InteractionSpec functionName="find"/>
</adminObject>

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

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

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.FinderInteractionSpec</adminobject-class>
<config-property>
 <config-property-name>ResultSetType</config-property-name>
 <config-property-type>java.lang.Integer</config-property-type>
</config-property> 
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.UpdaterInteractionSpec</adminobject-class> 
<config-property> 
 <config-property-name>ExecutionTimeout</config-property-name>
 <config-property-type>java.lang.Long</config-property-type> 
</config-property>
...
</adminobject>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<adminObject jndiName="eis/finder">
 <properties.MyAdapter.FinderInteractionSpec resultSetType="1003"/>
</adminObject>

<adminObject jndiName="eis/updater">
 <properties.MyAdapter.UpdaterInteractionSpec executionTimeout="3000"/>
</adminObject>

Verwenden Sie das folgende Beispiel, um zu lernen, wie Ressourcenadapter mit zwei verwalteten Objekten 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 verwalteten Objekten bereit, bei denen weder die einfachen Schnittstellen- noch die Implementierungsklassennamen eindeutig sind:

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.finder.InteractionSpecImpl</adminobject-class>
<config-property> 
 <config-property-name>ResultSetType</config-property-name>
 <config-property-type>java.lang.Integer</config-property-type>
</config-property>
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.resource.cci.InteractionSpec</adminobject-interface>
<adminobject-class>com.vendor.adapter.updater.InteractionSpecImpl</adminobject-class>
<config-property> 
 <config-property-name>ExecutionTimeout</config-property-name>
 <config-property-type>java.lang.Long</config-property-type>
</config-property>
...
</adminobject>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<adminObject jndiName="eis/finder">
 <properties.MyAdapter.javax.resource.cci.InteractionSpec-com.vendor.adapter.finder.InteractionSpecImpl resultSetType="1003"/>
</adminObject> 

<adminObject jndiName="eis/updater"> 
 <properties.MyAdapter.javax.resource.cci.InteractionSpec-com.vendor.adapter.updater.InteractionSpecImpl executionTimeout="3000"/>
</adminObject>

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

Dateiname: twlp_jca_config_admobj.html