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

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 la prise en charge JCA pour le profil Liberty, vous devez éditer le fichier server.xml depuisla vue Source de l'Editeur 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>  <!-- Ajoutez la fonction
    jndi pour activer la recherche de fabriques de connexions
    et d'objets gérés.  -->
     ...
    </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>  <!-- Ajoutez la
    fonction jndi pour activer la recherche de fabriques de
    connexions
    et d'objets gérés.  --> 
    	...    
    </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>  <!-- Ajoutez la
    fonction jndi pour activer la recherche de fabriques de
    connexions
    et d'objets gérés.  -->
    	...
    </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>  <!-- Ajoutez la fonction
    jndi pour activer la recherche de fabriques de connexions
    et d'objets gérés.  -->
    	...
    </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

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_custelements
Nom du fichier : twlp_jca_config_custelements.html