Création de destinations dans une application JMS

Au lieu d'extraire des destinations en tant qu'objets gérés à partir d'un espace de nom JNDI ( Java Naming and Directory Interface), une application JMS peut utiliser une session pour créer des destinations de manière dynamique lors de l'exécution. Une application peut utiliser un identificateur URI (Uniform Resource Identifier) pour identifier une file d'attente IBM® MQ ou une rubrique et, éventuellement, pour spécifier une ou plusieurs propriétés d'un objet de file d'attente ou de rubrique.

Utilisation d'une session pour créer des objets de file d'attente

Pour créer un objet File d'attente, une application peut utiliser la méthode createQueue() d'un objet Session, comme le montre l'exemple suivant :

Session session;
.
Queue q1 = session.createQueue("Q1");

Ce code crée un objet File d'attente avec les valeurs par défaut pour toutes ses propriétés. L'objet représente une file d'attente IBM MQ appelée Q1 qui appartient au gestionnaire de files d'attente local. Cette file d'attente peut être une file d'attente locale, une file d'attente alias ou une définition de file d'attente éloignée.

La méthode createQueue() accepte également un URI de file d'attente comme paramètre. Un URI de file d'attente est une chaîne qui spécifie le nom d'une file d'attente IBM MQ et, en option, le nom du gestionnaire de files d'attente qui possède la file d'attente et une ou plusieurs propriétés de l'objet Queue. L'instruction suivante contient un exemple d'URI de file d'attente:

Queue q2 = session.createQueue("queue://QM2/Q2?persistence=2&priority=5");

L'objet File d'attente créé par cette instruction représente une file d'attente IBM MQ appelée Q2 qui appartient à un gestionnaire de files d'attente appelé QM2, et tous les messages envoyés à cette destination sont persistants et ont une priorité de 5. Le gestionnaire de files d'attente identifié de cette manière peut être le gestionnaire de files d'attente local ou un gestionnaire de files d'attente éloignées. S'il s'agit d'un gestionnaire de files d'attente éloignées, IBM MQ doit être configuré de sorte que, lorsque l'application envoie un message à cette destination, WebSphere MQ puisse acheminer le message du gestionnaire de files d'attente local vers le gestionnaire de files d'attente QM2. Pour plus d'informations sur les URI, voir Uniform Resource Identifier (URI).

Notez que le paramètre de la méthode createQueue() contient des informations spécifiques au fournisseur. Par conséquent, l'utilisation de la méthode createQueue() pour créer un objet de file d'attente, au lieu de récupérer un objet de file d'attente en tant qu'objet administré à partir d'un espace de noms JNDI, peut rendre votre application moins portable.

Une application peut créer un objet TemporaryQueue en utilisant la méthode createTemporaryQueue() d'un objet Session, comme le montre l'exemple suivant :

TemporaryQueue q3 = session.createTemporaryQueue();

Bien qu'une session soit utilisée pour créer une file d'attente temporaire, la portée d'une file d'attente temporaire correspond à la connexion utilisée pour créer la session. Toutes les sessions de la connexion peuvent créer des expéditeurs et des consommateurs de messages pour la file d'attente temporaire. La file d'attente temporaire est conservée jusqu'à la fin de la connexion ou jusqu'à ce que l'application supprime explicitement la file d'attente temporaire à l'aide de la méthode TemporaryQueue.delete (), la date la plus proche étant retenue.

Lorsqu'une application crée une file d'attente temporaire, IBM MQ classes for JMS crée une file d'attente dynamique dans le gestionnaire de files d'attente auquel l'application est connectée. La propriété TEMPMODEL de la fabrique de connexions indique le nom de la file d'attente modèle utilisée pour créer la file d'attente dynamique, et la propriété TEMPQPREFIX de la fabrique de connexions indique le préfixe utilisé pour former le nom de la file d'attente dynamique.

Utilisation d'une session pour créer des objets de rubrique

Pour créer un objet Topic, une application peut utiliser la méthode createTopic() d'un objet Session, comme le montre l'exemple suivant :

Session session;
.
Topic t1 = session.createTopic("Sport/Football/Results");

Ce code crée un objet Topic avec les valeurs par défaut pour toutes ses propriétés. L'objet représente un sujet appelé Sport / Football/Résultats.

La méthode createTopic() accepte également un URI de sujet comme paramètre. Un URI de rubrique est une chaîne qui spécifie le nom d'une rubrique et, en option, une ou plusieurs propriétés de l'objet Rubrique. Le code suivant contient un exemple d'URI de rubrique:

String uri = "topic://Sport/Tennis/Results?persistence=1&priority=0";
Topic t2 = session.createTopic(uri);

L'objet Topic créé par ce code représente une rubrique appelée Sport / Tennis/Results, et tous les messages envoyés à cette destination sont non persistants et ont une priorité de 0. Pour plus d'informations sur les URI de rubrique, voir URI (Uniform Resource Identifier).

Notez que le paramètre de la méthode createTopic() contient des informations spécifiques au fournisseur. Par conséquent, l'utilisation de la méthode createTopic() pour créer un objet Topic, au lieu de récupérer un objet Topic en tant qu'objet administré à partir d'un espace de noms JNDI, peut rendre votre application moins portable.

Une application peut créer un TemporaryTopic en utilisant la méthode createTemporaryTopic() d'un objet Session, comme le montre l'exemple suivant :

TemporaryTopic t3 = session.createTemporaryTopic();

Bien qu'une session soit utilisée pour créer une rubrique temporaire, la portée d'une rubrique temporaire est la connexion qui a été utilisée pour créer la session. Toutes les sessions de la connexion peuvent créer des expéditeurs et des consommateurs de message pour la rubrique temporaire. La rubrique temporaire est conservée jusqu'à la fin de la connexion ou jusqu'à ce que l'application supprime explicitement la rubrique temporaire à l'aide de la méthode TemporaryTopic.delete (), la date la plus proche étant retenue.

Lorsqu'une application crée un sujet temporaire, IBM MQ classes for JMS crée un sujet dont le nom commence par les caractères TEMP/tempTopicPrefix, où tempTopicPrefix est la valeur de la propriété TEMPTOPICPREFIX de la fabrique de connexions.

uniform resource identifier (URI)

Un URI de file d'attente est une chaîne qui spécifie le nom d'une file d'attente IBM MQ et, en option, le nom du gestionnaire de files d'attente qui possède la file d'attente et une ou plusieurs propriétés de l'objet File d'attente créé par l'application. Un URI de rubrique est une chaîne qui spécifie le nom d'une rubrique et, éventuellement, une ou plusieurs propriétés de l'objet de rubrique créé par l'application.

Un URI de file d'attente a le format suivant:

queue://[ qMgrName ]/qName [? propertyName1 = propertyValue1
& propertyName2 = propertyValue2
&...]

Le format d'un URI de rubrique est le suivant:

topic://topicName [? propertyName1 = propertyValue1
& propertyName2 = propertyValue2
&...]

Les variables de ces formats ont les significations suivantes:

qMgrName

Nom du gestionnaire de files d'attente propriétaire de la file d'attente identifiée par l'URI.

Le gestionnaire de files d'attente peut être le gestionnaire de files d'attente local ou un gestionnaire de files d'attente éloignées. S'il s'agit d'un gestionnaire de files d'attente éloignées, IBM MQ doit être configuré de sorte que, lorsqu'une application envoie un message à la file d'attente, WebSphere MQ puisse acheminer le message du gestionnaire de files d'attente locales vers le gestionnaire de files d'attente éloignées.

Si aucun nom n'est spécifié, le gestionnaire de files d'attente local est utilisé.

qName

Nom de la file d'attente IBM MQ .

La file d'attente peut être une file d'attente locale, une file d'attente alias ou une définition de file d'attente éloignée.

Pour connaître les règles de création de noms de file d'attente, voir Règles de dénomination des objets IBM MQ.

topicName

Nom de la rubrique.

Pour connaître les règles de création de noms de rubrique, voir Règles de dénomination des objets IBM MQ. Evitez d'utiliser les caractères génériques +, #, * et? dans les noms de rubrique. Les noms de rubrique contenant ces caractères peuvent générer des résultats inattendus lorsque vous vous y abonnez. Voir Combinaison de chaînes de rubrique.

propertyName1, propertyName2, ...

Noms des propriétés de l'objet de file d'attente ou de rubrique créé par l'application. Le tableau 1 répertorie les noms de propriété valides qui peuvent être utilisés dans un URI.

Si aucune propriété n'est spécifiée, l'objet de file d'attente ou de rubrique possède les valeurs par défaut pour toutes ses propriétés.

propertyValue1, propertyValue2, ...

Valeurs des propriétés de l'objet Queue ou Topic créé par l'application. Le tableau 1 répertorie les valeurs de propriété valides qui peuvent être utilisées dans un URI.

Les crochets ([ ]) indiquent un composant facultatif et les points de suspension (...) indiquent que la liste des paires nom-valeur de propriété, si elle est présente, peut contenir une ou plusieurs paires nom-valeur.

Le tableau 1 répertorie les noms de propriété et les valeurs valides qui peuvent être utilisés dans les URI de file d'attente et de rubrique. Bien que l'outil d'administration de IBM MQ JMS utilise des constantes symboliques pour les valeurs des propriétés, les URI ne peuvent pas contenir de constantes symboliques.

Tableau 1. Noms de propriété et valeurs valides à utiliser dans les URI de file d'attente et de rubrique
Nom de la propriété	Description	Valeur valides
CCSID	Représentation des données de type caractères dans le corps d'un message lorsque IBM MQ classes for JMS transfère le message à la destination	Tout identificateur de jeu de caractères codés pris en charge par IBM MQ.
codage	Représentation des données numériques dans le corps d'un message lorsque IBM MQ classes for JMS transfère le message à la destination	Toute valeur valide pour la zone `Codage` dans un descripteur de message IBM MQ .
expiration	Durée de vie des messages envoyés à la destination	--2 - Comme spécifié dans l'appel send() ou, si cela n'est pas spécifié dans l'appel send(), le délai de vie par défaut du producteur du message. 0-Un message envoyé à la destination n'expire jamais. Entier positif indiquant la durée de vie en millisecondes.
multidiffusion	Paramètre de multidiffusion pour une rubrique lors de l'utilisation d'une connexion en temps réel à un courtier	La liste suivante contient les valeurs valides. La valeur correspondante de la propriété MULTICAST, telle qu'elle est utilisée dans l'outil d'administration de IBM MQ JMS , est associée à chaque valeur. Pour une description de la propriété MULTICAST et de ses valeurs valides, voir Propriétés des objets IBM MQ classes for JMS. --1 - ASCF 0 - désactivé 3-NOTR 5-FIABLE 7-ACTIVE
persistance	Persistance des messages envoyés à la destination	--2 - Comme spécifié dans l'appel send() ou, si ce n'est pas le cas, la persistance par défaut du producteur de messages. --1 - Comme spécifié par l'attribut `DefPersistence` de la IBM MQ file d'attente ou du sujet. 1-Non persistant. 2-Persistant. 3-Equivalent à la valeur HIGH de la propriété PERSISTENCE telle qu'elle est utilisée dans l'outil d'administration de IBM MQ JMS . Pour une explication de cette valeur, voir Messages persistants JMS.
priority	Priorité des messages envoyés à la destination	--2 - Comme spécifié dans l'appel send() ou, si elle n'est pas spécifiée dans l'appel send(), la priorité par défaut du producteur de messages. --1 - Comme spécifié par l'attribut `DefPriority` de la IBM MQ file d'attente ou du sujet. Entier compris entre 0 et 9 indiquant la priorité des messages envoyés à la destination.
targetClient	Indique si les messages envoyés à la destination contiennent un en-tête MQRFH2	0-Les messages contiennent un en-tête MQRFH2 . 1-Les messages ne contiennent pas d'en-tête MQRFH2 .

Par exemple, l'URI suivant identifie une file d'attente IBM MQ appelée Q1 qui appartient au gestionnaire de files d'attente local. Un objet de file d'attente créé à l'aide de cet URI possède les valeurs par défaut pour toutes ses propriétés.

queue:///Q1

L'URI suivant identifie une file d'attente IBM MQ appelée Q2 qui appartient à un gestionnaire de files d'attente appelé QM2. Tous les messages envoyés à cette destination ont une priorité de 6. Les autres propriétés de l'objet File d'attente créé à l'aide de cet URI ont leurs valeurs par défaut.

queue://QM2/Q2?priority=6

L'URI suivant identifie une rubrique appelée Sport / Athlétiques / Résultats. Tous les messages envoyés à cette destination sont non persistants et ont une priorité de 0. Les autres propriétés de l'objet Topic créé à l'aide de cet URI ont leurs valeurs par défaut.

topic://Sport/Athletics/Results?persistence=1&priority=0