Configurando a Política de Transporte JMS (Java Message Service)

Você poderá definir uma configuração da política de transporte JMS (Java™ Message Service) se estiver utilizando SOAP via JMS com seus aplicativos JAX-WS (Java API for XML-Based Web Services).

Antes de Iniciar

É possível configurar algumas configurações de políticas para conjuntos de política customizados. Os conjuntos de política padrão fornecidos não podem ser editados. Você deve criar uma cópia do conjunto de política padrão ou criar um novo conjunto de política a fim de especificar as políticas para ele.

Sobre Esta Tarefa

Ao usar o transporte SOAP sobre JMS com aplicativos JAX-WS, é possível customizar o transporte, configurando a política de transporte JMS. O transporte SOAP em JMS oferece uma alternativa para o HTTPS transportar pedidos SOAP e mensagens de resposta entre os clientes e os servidores. Consulte a documentação sobre como usar SOAP via JMS para transportar serviços da Web, para aprender mais sobre esse protocolo de transporte.

É possível configurar apenas uma política por meio de um conjunto de política. Portanto, antes de você configurar a política de transporte JMS, um conjunto de política deverá existir contendo a política de transporte JMS. Para customizar um conjunto de política que contenha a política de transporte JMS, você deve primeiro criar uma cópia do conjunto de política padrão WSHTTPS ou criar um novo conjunto de política e incluir a política de transporte JMS no novo conjunto de política.

Utilize o painel de configurações da política de transporte JMS para customizar os valores das propriedades de política de transporte JMS, como o valor de tempo limite do pedido. Seus valores customizados para a política de transporte JMS agora se aplicam ao conjunto de política que contém essa política de transporte JMS customizada. É possível conectar esse conjunto de política que contém sua política de transporte JMS customizada com seu aplicativo JAX-WS, seus serviços, terminais ou operações. Essa alteração afeta todos os aplicativos JAX-WS aos quais esse conjunto de política está conectado. Para saber mais sobre a conexão dos conjuntos de políticas com os aplicativos, consulte a documentação para gerenciamento de conjuntos de políticas para provedores de serviço e clientes de serviço no nível de aplicativo.

Procedimento

  1. Crie um conjunto de política que contenha a política de transporte JMS.
    1. Crie um conjunto de política customizado. No console administrativo, clique em Serviços > Conjuntos de Políticas > Conjuntos de Políticas de Aplicativo. Nesse painel, é possível criar um novo conjunto de política, importar uma cópia de um conjunto de política do repositório padrão ou importar um conjunto de política existente de seu local especificado.
    2. Inclua a política de transporte JMS no conjunto de política. A partir do console administrativo, clique em Serviços > Conjuntos de políticas > Conjuntos de políticas do aplicativo > policy_set_name. Na coleta de política, clique em Transporte JMS. A janela de transporte JMS exibe as opções para configurar as configurações JMS para a política de transporte.
    3. Especifique as propriedades de conexão do JMS para os pedidos de transporte de JMS. Os campos a seguir configuram os recursos JMS para esse transporte:
      Tempo Limite do Pedido
      Especifica se deve ativar um valor de tempo limite. O valor de tempo limite do pedido é o tempo que o cliente aguarda por uma resposta depois de enviar o pedido para o servidor. O intervalo é de 0 a 2147483647.
      Permitir sistema de mensagens transacional para operações assíncronas unidirecionais
      Especifica para ativar um cliente para utilizar transações unidirecionais ou bidirecionais assíncronos. Selecione esta caixa de opção para ativar o sistema de mensagens transacional.
      Se esta opção for selecionada, o ambiente de tempo de execução do cliente trocará mensagens de pedido e resposta SOAP com o servidor pelo transporte JMS de maneira transacional, se o cliente estiver operando em uma transação. Este processo indica que a transação dos clientes é utilizada para enviar a mensagem de pedido SOAP para a fila ou o tópico de destino e o servidor recebe a mensagem de pedido apenas depois que o cliente confirma a transação. Da mesma forma, o servidor recebe a mensagem de pedido sob o controle de uma transação gerenciada por contêiner e envia a mensagem de resposta, se for aplicável, novamente para o cliente utilizando essa mesma transação. Em seguida, o cliente recebe a mensagem de resposta apenas depois que a transação do servidor é confirmada.
      Se esta opção não estiver selecionada, os ambientes de tempo de execução do cliente e do servidor executarão operações do sistema de mensagens de uma maneira não-transacional, uma vez que as transações são temporariamente suspensas para o pedido JMS. As transações são ativadas novamente depois que o pedido tiver sido concluído.
      Configurações suportadas Configurações suportadas: As operações transacionais do sistema de mensagens não são suportadas para operações síncronas bidirecionais porque isso conduz a uma condição de conflito.sptcfg
  2. Customize as ligações do provedor de transporte JMS.
    1. Navegue até as ligações do provedor de transporte JMS. No console administrativo, clique em Serviços > Conjuntos de Políticas > Ligações Gerais do Conjunto de Políticas do Provedor > provider_policy_set_binding_name > Transporte JMS.

      A janela Ligações do Provedor de Transporte JMS exibe opções para definir a autenticação básica para respostas de serviços assíncronos e propriedades customizadas para configuração de ligação do provedor de serviços JMS.

    2. Especifique as propriedades para autenticação básica para respostas de serviço assíncronas.

      É possível utilizar as ligações da política do provedor de transporte JMS para configurar um serviço que utiliza o transporte JMS para enviar mensagens de resposta assíncronas de volta para o cliente. O ambiente de tempo de execução do servidor de aplicativos utiliza o nome do usuário e a senha configurados ao conectar-se ao provedor do sistema de mensagens JMS e essa configuração possibilitará ao serviço enviar uma mensagem de resposta assíncrona para o cliente de maneira segura.

      Os seguintes campos determinam os requisitos de autenticação para respostas do servidor:

      Nome de Usuário
      Especifica o nome do usuário para as respostas de serviço assíncrono do provedor de serviços.
      Senha
      Exibe um espaço reservado para a senha de respostas de serviço assíncrono do provedor de serviços. É possível digitar ou editar a senha nesse campo. A senha real é mascarada.
      Confirmar Senha
      Especifica um sinalizador de substituição para a senha para as respostas de serviço assíncronas do provedor de serviços que deverá corresponder com a senha do campo Senha. A senha real é mascarada.
  3. Customize as ligações do cliente de transporte JMS.
    1. Navegue até as ligações do cliente de transporte JMS. No console administrativo, clique em Serviços > Conjuntos de Políticas > Ligações Gerais do Conjunto de Políticas do Cliente > client_policy_set_binding_name > Transporte JMS.

      A janela Ligações do Provedor de Transporte JMS exibe opções para definir a autenticação básica para pedidos de serviço de saída e propriedades customizadas para a configuração de ligação de cliente JMS.

    2. Especifique a autenticação básica para as propriedades de pedidos de serviço de saída.

      É possível utilizar as ligações da política do cliente de transporte JMS para configurar um cliente que utiliza o transporte JMS para enviar uma mensagem de pedido para o servidor. O ambiente de tempo de execução do cliente utiliza o nome do usuário e a senha configurados ao conectar-se ao provedor do sistema de mensagens JMS. Essa configuração possibilita ao cliente enviar a mensagem de pedido ao servidor de uma maneira segura.

      Os campos a seguir determinam os requisitos de autenticação para pedidos enviados para o servidor:

      Nome de Usuário
      Especifica o nome do usuário utilizado pelo tempo de execução do cliente ao conectar-se ao provedor de sistema de mensagens JMS para enviar um pedido de saída à fila ou ao tópico de destino. Digite um nome de usuário nesse campo.
      Senha
      Especifica um sinalizador de substituição para a senha utilizada pelo tempo de execução do cliente ao conectar-se ao provedor de sistemas de mensagens JMS para enviar um pedido de saída à fila ou ao tópico de destino. É possível digitar ou editar a senha nesse campo. A senha real é mascarada.
      Confirmar Senha
      Especifica um sinalizador de substituição para a senha utilizada pelo tempo de execução do cliente ao conectar-se ao provedor de sistemas de mensagens JMS para enviar um pedido de saída à fila ou ao tópico de destino. Digite novamente a senha nesse campo. Essa senha deve corresponder à do campo Senha. A senha real é mascarada.
  4. Configure a propriedade customizada de JVM com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse como true.

    Consulte o tópico Propriedades Customizadas de Java virtual machine para obter uma descrição de como especificar essa propriedade.

  5. Salve suas mudanças.

Resultados

Depois de ter customizado a política de transporte JMS, o conjunto de política associado utilizará essa política para configurar o comportamento do tempo de execução para SOAP no transporte JMS.

Exemplo

É possível conectar os conjuntos de política a um aplicativo, seus serviços, terminais e operações. Neste cenário de exemplo, suponha que você tenha dois clientes de serviço JAX-WS diferentes para seu aplicativo, mas queira utilizar valores de tempo limite de pedido de transporte JMS diferentes para cada cliente de serviço. Para modificar os valores de tempo limite de pedido de transporte JMS, é possível editar os valores da política de transporte JMS contidos no conjunto de política conectado ao seu aplicativo ou, neste caso, seu cliente de serviço. Essa alteração afeta todos os aplicativos aos quais o conjunto de política contendo a política de transporte JMS customizada está conectado.

Este exemplo descreve as etapas de configuração de valores de tempo limite de pedido diferentes para clientes de serviço implementados no mesmo servidor de aplicativos. Esse exemplo faz as seguintes suposições:
  • Existem dois clientes de serviço do JAX-WS, ServiceClient1 e ServiceClient2, que são implementados no servidor de aplicativos.
  • A política de transporte JMS não foi conectada anteriormente a esses aplicativos.
  1. Crie dois novos conjuntos de política e inclua neles a política de transporte JMS. Por exemplo: JMSServiceClient1Policy e JMSServiceClient2Policy
    1. Clique em Serviços > Conjuntos de Políticas > Conjuntos de Políticas do Aplicativo > Novo.
    2. Digite o nome do novo conjunto de política, JMSServiceClient1Policy.
    3. Na coleta de Políticas, clique em Incluir > Transporte JMS.
    4. Clique em Aplicar eSalvar para salvar as mudanças na configuração principal.
    5. Repita essas etapas para criar o JMSServiceClient2Policy.
  2. Customize as configurações de política de transporte JMS para os conjuntos de política JMSServiceClient1Policy e JMSServiceClient2Policy recém-criados. Por exemplo, configure o valor de tempo limite do pedido como 180 segundos para a política de transporte JMS contida no JMSServiceClient1Policy. A política de transporte JMS contida no JMSServiceClient2Policy especifica 300 segundos como o valor de tempo limite do pedido.
    1. Clique em Serviços > Conjuntos de Políticas > Conjuntos de Políticas do Aplicativo > JMSServiceClient1Policy .
    2. Na coleta de Políticas, clique em JMS transport.
    3. No painel de configuração da política de transporte JMS, especifique 180 segundos para o valor de tempo limite do pedido.
    4. Clique em Aplicar eSalvar para salvar as mudanças na configuração principal.
    5. Clique em Serviços > Conjuntos de Políticas > Conjuntos de Políticas do Aplicativo > JMSServiceClient2Policy .
    6. Na coleta de Políticas, clique em JMS transport.
    7. No painel de configuração de política de transporte JMS, especifique 300 segundos para o valor de tempo limite do pedido.
    8. Clique em Aplicar eSalvar para salvar as mudanças na configuração principal.
  3. Conecte a política de transporte JMS customizada, JMSServiceClient1Policy, ao seu aplicativo, ServiceClient1. Da mesma maneira, conecte a política de transporte JMS, JMSServiceClient2Policy, ao ServiceClient2.
    1. Clique em Serviços > Clientes de serviços > ServiceClient1.
    2. Em Coleta de Conexões do Conjunto de Política, selecione o serviçoServiceClient1.
    3. Clique em Conectar Conjunto de Política do Cliente e em JMSServiceClient1Policy.
    4. Clique em Salvar para salvar suas mudanças na configuração principal.
    5. Clique em Serviços > Clientes de serviços > ServiceClient2.
    6. Em Coleta de Conexões do Conjunto de Política, selecione o serviçoServiceClient1.
    7. Clique em Conectar Conjunto de Política do Cliente e em JMSServiceClient2Policy.
    8. Clique em Salvar para salvar suas mudanças na configuração principal.

Como resultado, o aplicativo ServiceClient1 agora tem o JMSServiceClient1Policy conectado e as sessões JMS utilizam um tempo limite de pedido de 180 segundos. O aplicativo ServiceClient2 tem a política JMSServiceClient2Policy conectada e as sessões JMS utilizam um tempo limite de pedido de 300 segundos.

O que Fazer Depois

É possível customizar outras políticas que você pode precisar para seu aplicativo.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wsspsptjms
Nome do arquivo: twbs_wsspsptjms.html