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.

IBM® 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.

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.