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

Configuration de destinations JMS

Vous pouvez configurer les destinations JMS fournies par des adaptateurs de ressources 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 destination JMS, file d'attente ou type de rubrique fournis par un adaptateur de ressources installé.
Des éléments de configuration sont fournis pour les types de destination JMS suivants :
  • javax.jms.Destination: jmsDestination
  • javax.jms.Queue: jmsQueue
  • javax.jms.Topic: jmsTopic
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. Configurez une ou plusieurs instances de destination, file d'attente ou rubrique JMS. Lorsque vous configurez les instances de destination, 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 jmsDestination, jmsQueue ou jmsTopic avec une interface de destination JMS fournie par un adaptateur de ressources spécifique. Dans l'exemple suivant, l'adaptateur de ressources MyAdapter fournit un seul type de destination JMS, un type de file d'attente JMS et un type de rubrique JMS :
    <jmsDestination jndiName="jms/destination1">
     <properties.MyAdapter name="DEST1"/>
    </jmsDestination>
    
    <jmsQueue jndiName="jms/queue1">
     <properties.MyAdapter queueName="QUEUE1"/> 
    </jmsQueue> 
    
    <jmsTopic id="topic1" jndiName="jms/topic1">
     <properties.MyAdapter topicName="TOPIC1"/>
    </jmsTopic>
  2. (Facultatif) Si nécessaire, identifiez les noms de sous-éléments des propriétés de destination, file d'attente et rubrique disponibles.
    Remarque : Cette rubrique suppose qu'un adaptateur de ressources avec un identificateur unique MyAdapter a déjà été configuré sur le serveur. Reportez-vous à la rubrique Configuration d'adaptateurs de ressources pour plus de détails.

    Limitation : 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.

    • Si un adaptateur de ressource fournit exactement un type d'objet géré avec l'interface javax.jms.Destination, le nom du sous-élément est : properties.<identificateur_rar>

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

    • Si un adaptateur de ressource fournit exactement un type d'objet géré avec l'interface javax.jms.Queue, le nom du sous-élément est : properties.<identificateur_rar>

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

    • Si un adaptateur de ressource fournit exactement un type d'objet géré avec l'interface javax.jms.Topic, le nom du sous-élément est : properties.<identificateur_rar>

    • 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 destinations JMS 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 destinations JMS avec noms de classe d'implémentation uniques :

<adminobject>
<adminobject-interface>javax.jms.Destination</adminobject-interface>
<adminobject-class>com.vendor.adapter.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>queueName</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
</config-property>
 ... 
</adminobject>

<adminobject>
<adminobject-interface>javax.jms.Destination</adminobject-interface>
<adminobject-class>com.vendor.adapter.TopicImpl</adminobject-class> 
<config-property> 
 <config-property-name>topicName</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 :
<jmsDestination jndiName="jms/destination1">
 <properties.MyAdapter.QueueImpl queueName="D1"/>
</adminObject> 

<jmsDestination jndiName="jms/destination2">
 <properties.MyAdapter.TopicImpl topicName="D2"/> 
</jmsDestination>

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

<adminobject>
<adminobject-interface>javax.jms.Queue</adminobject-interface>
<adminobject-class>com.vendor.adapter.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>queueName</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
</config-property>
... 
</adminobject>

<adminobject>
<adminobject-interface>javax.jms.Queue</adminobject-interface>
<adminobject-class>com.vendor.adapter.advanced.QueueImpl</adminobject-class>
<config-property>
 <config-property-name>name</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 :
<jmsQueue jndiName="jms/myQueue">
 <properties.MyAdapter.com.vendor.adapter.QueueImpl queueName="Q1"/>
</jmsQueue>

<jmsQueue jndiName="jms/myAdvancedQueue">
 <properties.MyAdapter.com.vendor.adapter.advanced.QueueImpl name="Q1"/>
</jmsQueue>
Sous certains scénarios, des noms d'éléments de configuration trop longs peuvent être indésirables. 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_jms_config_dest
Nom du fichier : twlp_jms_config_dest.html