[8.5.5.2 ou ultérieure]Référentiel Liberty

Configuration des fabriques de connexions JCA

Vous pouvez configurer des fabriques de connexions conformes à la spécification JCA (Java™ EE Connector Architecture).

Pourquoi et quand exécuter cette tâche

Vous pouvez configurer une ou plusieurs instances de fabrique de connexions pour les types de fabrique de connexions fournis par un adaptateur de ressources installé.
Remarque : Pour configurer la prise en charge JCA pour le profil Liberty, vous devez éditer le fichier server.xml depuis la vue Source de l'Editeur de configuration de serveur de WebSphere® Application Server Developer Tools for Eclipse ou depuis un autre éditeur de texte. Cette rubrique suppose qu'un adaptateur de ressources avec un identificateur unique MyAdapter a déjà été configuré sur le serveur. Reportez-vous à la documentation sur la configuration d'adaptateurs de ressources pour plus de détails. Les étapes ci-dessous fournissent un exemple de bout en bout de configuration d'un scénario de base.
Remarque : L'édition des sous-éléments de propriétés de la configuration du serveur pour les fabriques de connexions, les objets d'administration, les spécifications d'activation et les adaptateurs de ressources dans la vue Conception de WebSphere® Development Tools (WDT) n'est pas prise en charge.

Procédure

  1. Mettez à jour le fichier server.xml en lui ajoutant la fonction jca-1.6 sous la balise featureManager.
    <featureManager>  
    	<feature>jca-1.6</feature> 
    	<feature>jndi-1.0</feature>  <!-- Ajoutez la fonction
    jndi pour activer la recherche de fabriques de connexions et d'objets gérés. -->   
    		... 
    </featureManager>
  2. Installez un adaptateur de ressources. Par exemple, mettez à jour le fichier server.xml comme suit :
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
  3. Configurez une ou plusieurs instances de fabrique de connexions. Lorsque vous configurez ces instances, vous devez fournir un sous-élément properties, même si vous ne désirez pas remplacer des propriétés de configuration, afin d'associer l'élément connectionFactory à une interface de fabrique de connexions fournie par un adaptateur de ressources spécifique. Dans l'exemple suivant, l'adaptateur de ressources MyAdapter fournit un seul type de fabrique de connexions :
    <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. (Facultatif) Si nécessaire, identifiez les noms de sous-éléments des propriétés de fabrique de connexions disponibles.
    • Si un adaptateur de ressource fournit exactement une interface de fabrique de connexions, à l'exclusion de fabriques de connexions JMS, le nom du sous-élément est : properties.<identificateur_rar>

    • Si le nom d'interface est unique sans le nom du package, le nom du sous-élément est : properties.<identificateur_rar>.<nom_interface>
    • Si le nom d'implémentation est unique sans le nom de package, le nom du sous-élément est : properties.<identificateur_rar>.<nom_implémentation>
    • Dans les autres cas, le nom du sous-élément est : properties.<identificateur_rar>.<nom_d'interface_qualifié_complet>

Exemple

Utilisez l'exemple suivant pour savoir comment configurer les adaptateurs de ressources avec deux fabriques de connexions avec noms de classe d'interface uniques.

Dans le fragment suivant issu d'un fichier ra.xml, l'adaptateur de ressources MyAdapter fournit deux fabriques de connexion avec noms de classe d'interface uniques :

<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> 
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<connectionFactory jndiName="eis/cf">
 <properties.MyAdapter.ConnectionFactory serverName="localhost"/>
</connectionFactory>

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

Utilisez l'exemple suivant pour savoir comment configurer les adaptateurs de ressources avec deux fabriques de connexions avec noms de classe d'implémentation uniques.

Dans le fragment suivant issu d'un fichier ra.xml, l'adaptateur de ressources MyAdapter fournit deux fabriques de connexion avec noms de classe d'implémentation uniques :

<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>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<connectionFactory jndiName="eis/cf1">
 <properties.MyAdapter.ConnectionFactoryImpl serverName="localhost"/>
</connectionFactory> 

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

Utilisez l'exemple suivant pour savoir comment configurer des adaptateurs de ressources avec deux fabriques de connexions où ni les noms de classe d'interface simple, ni les noms de classe d'implémentation, ne sont uniques.

Dans le fragment suivant issu d'un fichier ra.xml, l'adaptateur de ressources MyAdapter fournit deux fabriques de connexions où ni le nom de classe d'interface simple, ni le nom de classe d'implémentation, ne sont uniques :

<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>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<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>
Il est possible de redéfinir les suffixes des noms des éléments de configuration. Pour savoir comment redéfinir les suffixes des noms des éléments de configuration, reportez-vous aux rubriques sur la personnalisation des éléments de configuration JCA.

Icône indiquant le type de rubrique Rubrique Tâche

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_jca_config_confact
Nom du fichier : twlp_jca_config_confact.html