Syntaxe d'URL de noeud final JMS
Dans le cadre du protocole SOAP sur JMS de norme industrielle émergente, nous avons défini une syntaxe d'URL de noeud final JMS (Java™ Message Service). Une URL de noeud final JMS permet d'accéder à JAX-WS (Java API for XML Web Services) ou à des services Web JAX-RPC (Java API for XML-based RPC) avec le transport JMS. Cette URL spécifie la fabrique de connexions et de destinations JMS, ainsi que le nom du composant de port pour la demande de service Web. Elle est similaire à l'URL de noeud final HTTP qui spécifie l'hôte et le port, ainsi que la racine de contexte et le nom du composant de port.
Configurations prises en charge: Ce produit prend en charge le protocole de norme industrielle émergent SOAP sur JMS.
La spécification SOAP
sur JMS fournit un ensemble standard d'instructions de mise en oeuvre pour l'utilisation d'un transport compatible JMS avec des messages SOAP pour activer l'interopérabilité entre les implémentations de différents fournisseurs. Cette norme permet l'interopération d'un ensemble de composants
client et serveur de différents fournisseurs lors de l'échange de messages de demande et
de réponse SOAP via le transport JMS pour les services Web JAX-WS (Java API
for XML Web Services) et JAX-RPC (Java API for XML-based RPC). L'utilisation de JMS permet à vos clients et serveurs de services Web basés sur les beans entreprise de
communiquer au moyen de files d'attente et de sujets JMS au
lieu de passer par des connexions HTTP.sptcfgIBM® et d'autres fournisseurs travaillent sur la spécification W3C SOAP sur JMS depuis 2005. La spécification a été soumise à W3C et un groupe de travail a été constitué. La soumission de ce document aux membres actuels a été conjointement publiée en octobre 2007. Le serveur d'applications prend en charge la spécification provisoire actuelle de W3C.
Configurations prises en charge: Une URL de noeud final JMS est de la forme générale suivante : jms:jndi:<destination-jndi-name>?<property>=<value>&<property>=<value>&...
L'URL consiste en un type de transport jms:, suivi du type de variante jndi:, suivi du nom JNDI de la file d'attente ou de la rubrique de destination, suivi de la chaîne de requête contenant une liste de paires propriété et valeur utilisées pour spécifier différentes informations de noeud final JMS. La variante jndi: signifie que JNDI est utilisé pour localiser des noms d'objet dans la chaîne URL du noeud final.sptcfgLes propriétés prises en charge dans la chaîne de l'URL sont décrites dans les tableaux suivants :
| Nom de la propriété | Description |
|---|---|
| jndiConnectionFactoryName | Indique le nom JNDI de la fabrique de connexions qui est utilisée par l'exécution du client pour établir une connexion vers le moteur de messagerie JMS. |
| targetService | Indique le nom du composant de port auquel la demande est diffusée. |
| Nom de la propriété | Description |
|---|---|
| jndiInitialContextFactory | Indique le nom de la classe de fabrique de contexte initiale à utiliser. Cette valeur est mappée avec la propriété java.naming.factory.initial. |
| jndiURL | Spécifie l'URL du fournisseur JNDI. Cette valeur est mappée avec la propriété java.naming.provider.url. |
| Nom de la propriété | Description |
|---|---|
| deliveryMode | Indique si le message de demande est persistant ou non. Les valeurs valides sont PERSISTENT et NON_PERSISTENT. La valeur par défaut est NON_PERSISTENT. |
| timeToLive | Indique la durée de vie, en millisecondes, du message de demande. Une valeur égale à 0 indique que la durée de vie est illimitée. Si ce paramètre n'est pas spécifié, la valeur par défaut définie de JMS est alors utilisée. |
| Priority | Indique la priorité JMS associée au message de demande. Cette valeur doit être un entier positif compris entre 0, la priorité la plus basse, et 9, la priorité la plus élevée. Si ce paramètre n'est pas spécifié, la valeur par défaut définie de JMS est alors utilisée. |
| replyToName | Indique le nom JNDI de la destination JMS à laquelle le message de réponse est envoyé. Cette propriété facultative permet au client d'utiliser une file d'attente permanente précédemment définie, au lieu d'une file d'attente temporaire, pour la réception de réponses. |
| messageType | Indique le type de message associée au message de demande. La valeur BYTES spécifie l'utilisation de l'objet javax.jms.BytesMessage. La valeur TEXT spécifie l'utilisation de l'objet javax.jms.TextMessage. La valeur par défaut est BYTES. |
Les propriétés jndiConnectionFactoryName et targetService obligatoires doivent figurer dans la chaîne URL du noeud final JMS. Les propriétés restantes sont facultatives.
Si vous définissez des valeurs pour les propriétés deliveryMode, timeToLive et priority pour la demande JMS, elles sont transmises au message de réponse JMS à partir du message de demande JMS correspondant.
Pour plus d'informations sur cette norme industrielle, voir la spécification SOAP sur JMS (Java Message Service) dans la documentation relative aux API et aux spécifications de services Web.
Rubrique de référence