Personnalisation des éléments de configuration JCA

Vous pouvez personnaliser le mode de génération des sous-éléments des propriétés JCA lors de l'installation d'un adaptateur de ressources.

Pourquoi et quand exécuter cette tâche

Lorsque vous installez un adaptateur de ressources autonome ou imbriqué dans une application, vous pouvez ajouter un ou plusieurs sous-éléments <customize> sous l'élément <resourceAdapter> afin de choisir le suffixe utilisé pour le sous-élément des propriétés pour l'interface ou la classe d'implémentation spécifiée. La personnalisation du sous-élément évite d'avoir des noms de sous-éléments longs qui pourraient être requis autrement pour que les éléments de configuration aient des noms uniques.
Remarque :

Pour ajouter une prise en charge de JCA dans Liberty, vous devez éditer le fichier server.xml depuis la vue Source de l'éditeur de configuration de serveur de WebSphere® Application Server Developer Tools for Eclipse ou depuis un autre éditeur de texte. L'édition de portions de la configuration pour les fabriques de connexions, les objets d'administration, les spécifications d'activation et les adaptateurs de ressource, n'est pas prise en charge dans la version bêta.

Procédure

  1. Dans le cas d'un adaptateur de ressources autonome, partez de la configuration existante que vous désirez personnaliser. Par exemple, si un adaptateur de ressources nommé MyAdapter fournit deux fabriques de connexion où ni le nom de classe d'interface simple, ni le nom de classe d'implémentation, ne sont uniques :
    <featureManager>
     <feature>jca-1.6</feature>
     <feature>jndi-1.0</feature>  <!-- Add the jndi feature to enable look up of connection factories and administered objects.  -->
     ...
    </featureManager>
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    
    <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>
  2. Ajoutez des sous-éléments customize à resourceAdapter pour choisir les suffixes des interfaces des deux fabriques de connexions.
    <featureManager>
     <feature>jca-1.6</feature> 
     <feature>jndi-1.0</feature>  <!-- Add the jndi feature to enable look up of connection factories and administered objects.  --> 
    	...    
    </featureManager> 
    
    <resourceAdapter location="C:/adapters/MyAdapter.rar">
     <customize interface="javax.resource.cci.ConnectionFactory" suffix="cci"/>
     <customize interface="com.vendor.adapter.custom.ConnectionFactory" suffix="custom"/>
    </resourceAdapter>
    
    <connectionFactory jndiName="eis/cci-cf">
     <properties.MyAdapter.cci serverName="localhost"/>
    </connectionFactory> 
    
    <connectionFactory jndiName="eis/custom-cf">
     <properties.MyAdapter.custom hostName="localhost"/>
    </connectionFactory>
  3. Dans le cas d'un adaptateur de ressources imbriqué dans une application, partez de la configuration existante que vous désirez personnaliser. Supposons par exemple que vous disposez d'une application nommée app1 avec un adaptateur de ressources imbriqué nommé MyAdapter, comme ci-dessous :
    <featureManager>
     <feature>jca-1.6</feature>
     <feature>jndi-1.0</feature>  <!-- Add the jndi feature to enable look up of connection factories and administered objects.  -->
    	...
    </featureManager>
    
    <application name="app1" type="ear" location="C:/applications/app1.ear"/>
    
    <adminObject jndiName="eis/interactionSpec-find">
     <properties.app1.MyAdapter.javax.resource.cci.InteractionSpec-com.vendor.adapter.finder.InteractionSpecImpl resultSetType="1003"/>
    </adminObject>
    
    <adminObject jndiName="eis/interactionSpec-update">
     <properties.app1.MyAdapter.com.vendor.adapter.InteractionSpec-com.vendor.adapter.updater.InteractionSpecImpl executionTimeout="3000"/> 
    </adminObject>
  4. Spécifiez un élément resourceAdapter pour le module RAR (Resource Adapter Archive) dans l'application. Spécifiez pour l'attribut ID le nom du module RAR. Ajoutez des sous-éléments customize pour choisir les suffixes des deux objets gérés basés sur l'interface ou la classe d'implémentation. Dans cet exemple, seule la classe d'implémentation est spécifiée, ce qui est suffisant pour identifier les objets gérés :
    <featureManager>
     <feature>jca-1.6</feature>
     <feature>jndi-1.0</feature>  <!-- Add the jndi feature to enable look up of connection factories and administered objects.  -->
    	...
    </featureManager>
    
    <application name="app1" type="ear" location="C:/applications/app1.ear">
     <resourceAdapter id="MyAdapter">
      <customize implementation="com.vendor.adapter.finder.InteractionSpecImpl" suffix="finder"/>
      <customize implementation="com.vendor.adapter.updater.InteractionSpecImpl" suffix="updater"/>
     </resourceAdapter>
    </application>
    
    <adminObject jndiName="eis/interactionSpec-find">
     <properties.app1.MyAdapter.finder resultSetType="1003"/>
    </adminObject>
    
    <adminObject jndiName="eis/interactionSpec-update">
     <properties.app1.MyAdapter.updater executionTimeout="3000"/>
    </adminObject>

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



Icône d'horodatage Dernière mise à jour: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_jca_config_custelements
Nom du fichier : twlp_jca_config_custelements.html