Sintaxe de URL do Terminal JMS
Como parte de um SOAP padrão de mercado emergente no protocolo JMS, a sintaxe de URL do terminal JMS Java™ (Message Service) foi definido. Uma URL de terminal JMS é usada para acessar os serviços da Web Java API for XML Web Services (JAX-WS) ou Java API for XML-based RPC (JAX-RPC) com o transporte JMS. Esse URL especifica o destino de JMS e a Connection Factory, assim como o nome do componente da porta para o pedido de serviço da Web. Esse URL de nó de extremidade é semelhante à URL de nó de extremidade HTTP, que especifica o host e a porta, assim como a raiz de contexto e o nome do componente da porta.

A IBM® e outros fornecedores têm trabalhado na especificação W3C SOAP via JMS desde 2005. A especificação foi submetida à W3C, e um grupo de trabalho foi estabelecido. A submissão de membro atual deste documento foi publicada conjuntamente em outubro de 2007. O servidor de aplicativos suporta a especificação do rascunho atual da W3C.

jms:jndi:<destination-jndi-name>?<property>=<value>&<property>=<value>&...
A URL consiste no tipo de transporte jms:, seguida pelo tipo de variantejndi:, pelo nome de JNDI da fila ou do tópico de destino
e pela cadeia de consultas que contém uma lista de pares de propriedade e valor que são utilizados para especificar várias informações de terminal JMS. A variante jndi: significa que o JNDI é utilizado para
localizar nomes de objetos na cadeia de URL do terminal.sptcfgAs propriedades suportadas na cadeia de URL são descritas nas seguintes tabelas:
Nome da Propriedade | Description |
---|---|
jndiConnectionFactoryName | Especifica o nome de JNDI da conection factory utilizada pelo tempo de execução do cliente para estabelecer uma conexão com o mecanismo do sistema de mensagens do JMS. |
targetService | Especifica o nome do componente da porta para o qual o pedido é despachado. |
Nome da Propriedade | Description |
---|---|
jndiInitialContextFactory | Especifica o nome da classe de factory de contexto inicial a ser utilizada. Esse valor mapeia para a propriedade inicial java.naming.factory.initial. |
jndiURL | Especifica a URL do provedor de JNDI. Esse valor mapeia para a propriedade java.naming.provider.url. |
Nome da Propriedade | Description |
---|---|
deliveryMode | Indica se a mensagem do pedido é persistente ou não. Os valores válidos são PERSISTENT e NON_PERSISTENT. O valor padrão é NON_PERSISTENT. |
timeToLive | Especifica o tempo de vida, em milissegundos, da mensagem do pedido. Um valor 0 indica um tempo de vida infinito. Se esse parâmetro não for especificado, o valor padrão definido por JMS será utilizado. |
priority | Especifica a prioridade do JMS associada à mensagem do pedido. Especifique esse valor como um número inteiro positivo a partir de 0, a prioridade mais baixa, até 9, a prioridade mais alta). Se esse parâmetro não for especificado, o valor padrão definido por JMS será utilizado. |
replyToName | Especifica o nome de JNDI do destino JMS para o qual a mensagem de resposta é enviada. O uso dessa propriedade opcional possibilita ao cliente utilizar uma fila permanente predefinida, no lugar de uma fila temporária, para receber respostas. |
messageType | Especifica o tipo de mensagem a ser usado com a mensagem de pedido. Um valor deBYTES indica que o objeto javax.jms.BytesMessage é usado. Um valor de TEXT indica que o objeto javax.jms.TextMessage é usado. O valor padrão é BYTES. |
As propriedades necessárias jndiConnectionFactoryName e targetService devem estar na cadeia de URL do terminal JMS. As propriedades restantes são opcionais.
Se você configurar valores para as propriedades deliveryMode, timeToLive e priority no pedido JMS, esses valores serão propagados da mensagem de pedido JMS para a mensagem de resposta JMS correspondente.
Consulte a especificação SOAP sobre Java Message Service nas especificações de serviços da Web e na documentação de APIs para saber mais sobre esse padrão de mercado.