Syntaxe de l'adresse URL de noeud final JMS du propriétaire IBM (obsolète)
Une URL de noeud final JMS (Java™ Message Service) permet d'accéder à des services Web JAX-WS (Java API for XML Web Services) ou JAX-RPC (Java API for XML-based RPC) à l'aide du transport JMS. Cette URL propriétaire indique la destination et la fabrique de connexions JMS (Java Message Service) 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.

jms:/[file d'attente|topic]?<propriété>=<valeur>&<propriété>=<valeur>&...
L'URL est constituée du type de transport jms:, suivi de /queue
ou /topic afin d'indiquer le type de destination JMS, suivi de la chaîne de
demande contenant une liste de paires de propriétés et valeurs utilisées pour
spécifier les informations du noeud final JMS.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 |
---|---|
destination | Spécifie le nom JNDI (Java Naming and Directory Interface) de la file d'attente ou de la rubrique de destination. |
connectionFactory | Indique le nom JNDI de la fabrique de connexions. |
targetService | Indique le nom du composant de port auquel la demande est diffusée. |
Nom de la propriété | Description |
---|---|
initialContextFactory | Indique le nom de la fabrique de contexte initial pour utiliser celui qui est mappé vers la propriété java.naming.factory.initial. |
jndiProviderURL | Indique l'URL du fournisseur JNDI qui est mappé vers 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 autorisées sont 1 pour un message non persistant et 2 pour un message persistant. La valeur par défaut est 1. |
timeToLive | Indique, en millisecondes, la durée de vie du message de demande JMS. La valeur par défaut égale à 0 indique que la durée de vie est illimitée. Toutefois, si vous utilisez les services Web, cette propriété est contrainte par la valeur de la propriété synchTimeout. La valeur de la propriété synchTimeout détermine le temps pendant lequel un client attend une réponse du serveur. Cette contrainte empêche le message JMS de rester actif alors que le client n'attend plus la réponse du serveur. |
Priority | Indique la priorité JMS associée au message de demande. Les valeurs possibles sont comprises entre 0 et 9. La valeur par défaut est 4. Une valeur nulle (0) correspond à la priorité la plus basse et une valeur égale à 9 à la priorité la plus élevée. |
replyToDestination | Indique le nom JNDI d'une file d'attente à utiliser pour recevoir des messages de réponse. Cette propriété facultative permet au client d'utiliser une file d'attente permanente, à la place d'une file d'attente temporaire, pour la réception de réponses. |
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.
Les propriétés requises : destination, connectionFactory et targetService, doivent figurer dans la chaîne de l'URL de noeud final JMS. Le reste des propriétés est facultatif.
Vous pouvez définir n'importe quelles propriétés sur l'objet Stub client. Vous pouvez spécifier les diverses propriétés en les incluant en tant que parties de l'URL du noeud final ou définir ces propriétés par programme exécuté par le client sur l'objet Stub. Les propriétés spécifiées sur l'objet Stub client sont prioritaires sur celles spécifiées comme partie d'une chaîne d'URL de point de contact JMS.