Configuration des spécifications d'activation JCA

Vous pouvez configurer des spécifications d'activation 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 de spécifications d'activation fournies 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 spécifications d'activation. Lorsque vous configurez des spécifications d'activation, 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 activationSpec avec un type de programme d'écoute de messages fourni par un adaptateur de ressources spécifique. Dans l'exemple suivant, l'adaptateur de ressources MyAdapter fournit un seul type de programme d'écoute de messages :
    <activationSpec id="app1/module1/MyMessageDrivenBean">
     <properties.MyAdapter messageFilter="ALL"/>
    </activationSpec>
  4. Si nécessaire, identifiez les noms de sous-éléments des propriétés de spécification d'activation disponibles.
    • Si un adaptateur de ressource fournit exactement une interface de programme d'écoute de messages, à l'exclusion de fabriques de connexions JMS, le nom du sous-élément est : properties.<identificateur_rar>

    • Si le nom d'interface du programme d'écoute de message est unique sans le nom du package, le nom du sous-élément est :properties.<identificateur_rar>.<nom_interface_programme_écoute_message>

    • Si la spécification d'activation de nom d'implémentation est unique sans le nom de package, le nom du sous-élément est : properties.<identificateur>.<nom_implémentation_spécification_d'activation>

    • Si la spécification d'activation de nom d'implémentation est unique sans le nom de package, le nom du sous-élément est : properties.<identificateur>.<nom_implémentation_spécification_d'activation>

    • Dans les autres cas, le nom du sous-élément est :properties.<identificateur_rar>.<nom_interface_programme_écoute_messages_qualifié_complet>

  5. Pour plus d'informations sur l'association de la spécification d'activation avec un bean géré par message, consultez la documentation relative au déploiement des beans gérés par message

Exemple

Utilisez l'exemple suivant pour savoir comment configurer les adaptateurs de ressources avec deux types de programme d'écoute de message avec noms de classe d'interface uniques.

Dans le fragment suivant issu d'un fichier ra.xml, l'adaptateur de ressources MyAdapter fournit deux types de programme d'écoute de message avec noms de classe d'interface uniques :

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.CCIActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name>
  <config-property-type>java.lang.Long</config-property-type>
 </config-property>
 ...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MyMessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.MyActivationSpec</activationspec-class>
 <config-property> 
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 ...
</activationspec>
...
</messagelistener>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.MessageListener maxSize="1024"/>
</activationSpec> 

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.MyMessageListener messageFilter="ALL"/>
</activationSpec>

Utilisez l'exemple suivant pour savoir comment configurer les adaptateurs de ressources avec deux types de programme d'écoute de message 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 types de programme d'écoute de message avec noms de classe d'implémentation uniques :

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec> 
 <activationspec-class>com.vendor.adapter.CCIActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name> 
  <config-property-type>java.lang.Long</config-property-type>
 </config-property> 
...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.MyActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.CCIActivationSpec maxSize="1024"/>
</activationSpec>

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.MyActivationSpec messageFilter="ALL"/>
</activationSpec>

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

<messagelistener>
<messagelistener-type>javax.resource.cci.MessageListener</messagelistener-type>
<activationspec>
 <activationspec-class>com.vendor.adapter.cci.ActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>maxSize</config-property-name>
  <config-property-type>java.lang.Long</config-property-type>
 </config-property> 
...
</activationspec>
...
</messagelistener>

<messagelistener>
<messagelistener-type>com.vendor.adapter.MessageListener</messagelistener-type> 
<activationspec>
 <activationspec-class>com.vendor.adapter.ActivationSpec</activationspec-class>
 <config-property>
  <config-property-name>messageFilter</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
...
</activationspec>
...
</messagelistener>
Ci-dessous figure un exemple de configuration de serveur pour ce scénario :
<activationSpec id="app1/module1/CCIMessageDrivenBean">
 <properties.MyAdapter.javax.resource.cci.MessageListener maxSize="1024"/>
</activationSpec>

<activationSpec id="app1/module1/MyMessageDrivenBean">
 <properties.MyAdapter.com.vendor.adapter.MessageListener messageFilter="ALL"/>
</activationSpec>

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



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_actspec
Nom du fichier : twlp_jca_config_actspec.html