JCA-Verbindungsfactorys konfigurieren

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

Informationen zu diesem Vorgang

Sie können eine oder mehrere Verbindungsfactory-Instanzen für Verbindungsfactory-Typen konfigurieren, die von einem installierten Ressourcenadapter bereitgestellt werden.
Anmerkung: Zum Konfigurieren der JCA-Unterstützung für das Liberty-Profil 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 Verbindungsfactory-Instanzen. Wenn Sie Verbindungsfactory-Instanzen konfigurieren, müssen Sie ein Unterelement properties angeben, selbst wenn Sie keine Konfigurationseigenschaften überschreiben möchten, um das Element "connectionFactory" einer Verbindungsfactory-Schnittstelle zuzuordnen, die von einem bestimmten Ressourcenadapter bereitgestellt wird. Im folgenden Beispiel stellt der Ressourcenadapter MyAdapter nur einen einzigen Typ von Verbindungsfactory bereit:
    <connectionFactory jndiName="eis/cf1">
     <properties.MyAdapter portNumber="1234" someVendorProperty="100"/>
    </connectionFactory>
    
    <connectionFactory jndiName="eis/cf2" containerAuthDataRef="auth2">
     <connectionManager maxPoolSize="20" connectionTimeout="0"/>
     <properties.MyAdapter portNumber="1234" someVendorProperty="200"/>
    </connectionFactory>
    <authData id="auth2" user="user2" password="{xor}Lz4sLCgwLTtt"/>
  4. (Optional) Identifizieren Sie, sofern erforderlich, die Namen der properties-Unterelemente für die verfügbaren Verbindungsfactorys.
    • Wenn ein Ressourcenadapter nur eine einzige Verbindungsfactory-Schnittstelle bereitstellt und damit alle JMS-Verbindungsfactorys 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>.
    • In anderen Fällen hat das Unterelement den Namen properties.<RAR-ID>.<vollständig.qualifizierter.Schnittstellenname>.

Beispiel

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

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

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.sql.DataSource</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.DataSourceImpl</connectionfactory-impl-class>
</connection-defintion> 
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<connectionFactory jndiName="eis/cf">
 <properties.MyAdapter.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="jdbc/ds">
 <properties.MyAdapter.DataSource serverName="localhost"/>
</connectionFactory>

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

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

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>com.vendor.adapter.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.MyConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<connectionFactory jndiName="eis/cf1">
 <properties.MyAdapter.ConnectionFactoryImpl serverName="localhost"/>
</connectionFactory> 

<connectionFactory jndiName="eis/cf2">
 <properties.MyAdapter.MyConnectionFactoryImpl serverName="localhost"/>
</connectionFactory>

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

<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>HostName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>com.vendor.adapter.custom.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.custom.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
Im Folgenden sehen Sie ein Beispiel für eine Serverkonfiguration für dieses Szenario:
<connectionFactory jndiName="eis/cci-cf">
 <properties.MyAdapter.javax.resource.cci.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="eis/custom-cf">
 <properties.MyAdapter.com.vendor.adapter.custom.ConnectionFactory hostName="localhost"/>
</connectionFactory>
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_confact
Dateiname: twlp_jca_config_confact.html