Configuration d'objets gérés JCA

Vous pouvez configurer des objets gérés qui se conforment à la spécification JCA (Java™ EE Connector Architecture).

Pourquoi et quand exécuter cette tâche

Vous pouvez configurer une ou plusieurs instances d'objets gérés fournis par un adaptateur de ressources installé.
Remarque : Pour configurer la prise en charge JCA pour 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>  <!-- Add the jndi feature to enable look up of connection factories and administered objects. -->   
    		... 
    </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 d'objet géré. Lorsque vous configurez des instances d'objet géré, 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 adminObject avec le type d'objet géré fourni par l'adaptateur de ressources. Dans l'exemple suivant, l'adaptateur de ressources MyAdapter fournit un seul type d'objet géré :
    <adminObject jndiName="eis/interactionSpec">
     <properties.MyAdapter functionName="find" executionTimeout="5000"/>
    </adminObject>
  4. (Facultatif) Si nécessaire, identifiez les noms de sous-éléments des propriétés d'objet géré disponibles.
    • Si un adaptateur de ressource fournit exactement une interface d'objet géré, à l'exclusion de destinations JMS, de files d'attente ou de sujets, le nom du sous-élément est : properties.<rar_identifier>

    • 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>

    • Si la combinaison du nom d'interface et du nom d'implémentation est unique sans le nom du package, le nom du sous-élément est : properties.<identificateur_rar>.<nom_interface>-<nom_implémentation>

    • Dans les autres cas, le nom du sous-élément est : properties.<identificateur_rar>.<nom_d'interface_qualifié_complet>-<nom_d'implémentation_qualifié_complet>

Exemple

Utilisez l'exemple suivant pour savoir comment configurer les adaptateurs de ressources avec deux objets gérés avec noms de classe d'interface uniques.

Dans le fragment suivant issu d'un fichier ra.xml, l'adaptateur de ressources MyAdapter fournit deux objets gérés avec noms de classe d'interface uniques :

<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>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<adminObject jndiName="eis/connectionSpec">
 <properties.MyAdapter.ConnectionSpec isolationLevel="4"/>
</adminObject>

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

Utilisez l'exemple suivant pour savoir comment configurer les adaptateurs de ressources avec deux objets gérés 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 objets gérés avec noms de classe d'implémentation uniques :

<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>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<adminObject jndiName="eis/finder">
 <properties.MyAdapter.FinderInteractionSpec resultSetType="1003"/>
</adminObject>

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

Utilisez l'exemple suivant pour savoir comment configurer des adaptateurs de ressources avec deux objets gérés 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 objets gérés où ni le nom de classe d'interface simple, ni le nom de classe d'implémentation, ne sont uniques :

<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>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<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>

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

Nom du fichier : twlp_jca_config_admobj.html