Criando uma Nova Configuração de Serviço de Proxy

É possível configurar o gateway de serviços da Web para atuar simplesmente como um proxy para seu serviço e, em seguida, utilizar as listas de manipuladores JAX-RPC para configurar os terminais para mensagens de solicitações recebidas para o serviço.

Antes de Iniciar

Para uma visualização de tarefas de alto nível de como configurar o gateway de serviços da Web como parte de uma configuração geral de serviços da Web ativados para barramento, consulte Ativando Serviços da Web por meio do Barramento de Integração de Serviços.

Você configura cada serviço de proxy para uma instância de gateway específica, portanto, é necessário criar a instância de gateway antes de configurar quaisquer serviços de proxy para ela.

Decida que método usar para configurar esses recursos. É possível criar um novo serviço de proxy utilizando o console administrativo conforme descrito nesta tarefa ou utilizando o Comando createWSGWProxyService.

Sobre Esta Tarefa

Quando você criar uma nova configuração do serviço de proxy, o gateway não executará nenhuma ação em relação a esse serviço a não ser chamá-lo. Ao configurar um serviço de proxy, você também configura uma lista de rotinas de tratamento JAX-RPC que utiliza o javax.xml.rpc.service.endpoint.address para configurar o nó de extremidade de destino para o serviço. Em seguida, você anexa a lista de manipuladores à porta de entrada do serviço de proxy.

Uma configuração do serviço de proxy não possui nenhum serviço de destino real e, portanto, nenhum WSDL que o gateway pode usar para configurar a chamada de serviço. Um arquivo WSDL de proxy genérico é utilizado para configurar os parâmetros básicos para a chamada (por exemplo, qual ligação utilizar), mas é possível substituir o padrão fornecendo seu próprio arquivo WSDL de proxy genérico equivalente. Se a lista de manipuladores JAX-RPC não estiver implementada, então o gateway tentará enviar todas as solicitações para o endereço da Web falso especificado na tag <soap:target address> no arquivo WSDL do proxy.

Para obter informações mais detalhadas, consulte Rotinas de Tratamento JAX-RPC e Operação do Proxy.

Para criar uma nova configuração de serviço de proxy utilizando o console administrativo, conclua as seguintes etapas:

Procedimento

  1. Crie um Manipulador JAX-RPC que utilize javax.xml.rpc.service.endpoint.address para configurar o terminal de destino para o serviço. Depende de você decidir como deseja estabelecer o nó de extremidade de destino e criar e configurar a rotina de tratamento JAX-RPC javax.xml.rpc.service.endpoint.address.
  2. Crie um nova configuração do manipulador JAX-RPC para o manipulador que configura o terminal de destino para esse serviço.
  3. Crie uma nova lista de manipuladores JAX-RPC, selecione o manipulador que configura o terminal de destino para este serviço e inclua-o na lista de manipuladores.
  4. Inicie o administrative console.
  5. Na área de janela de navegação, clique em Integração de serviços -> Barramentos -> bus_name -> [Propriedades Adicionais] Instâncias de gateway de serviço da Web -> instance_name-> Serviços Proxy . É exibido o formulário de coleta de serviços de proxy.
  6. Clique em Nova. É exibido o Assistente de Novo serviço de proxy.
  7. Utilize o assistente para criar a nova configuração do serviço de proxy concluindo as seguintes etapas. Para obter informações adicionais sobre as propriedades configuradas com o assistente, consulte Configurações de Serviços de Proxy.
    1. Especifique o nome do serviço de proxy, o ponto da porta de proxy, os destinos de serviço e mediações.
      Nota:
      • Escolha um nome de serviço de proxy que seja exclusivo em todos os serviços de gateway e proxy dentro da instância de gateway atual. Se você digitar um nome que não é exclusivo, uma mensagem de erro será exibida.
      • O ponto da porta de proxy é o ponto no qual o destino da porta de proxy deve estar localizado.
      • Você precisa fornecer nomes de destino de proxy. Se qualquer um desses campos ficar em branco, um nome padrão será gerado quando o assistente concluir sua operação. Os nomes padrão não são exibidos no painel. Eles são construídos da seguinte forma:
        • O nome do destino de pedido é o mesmo nome do serviço de proxy. Exemplo: myProxyService.
        • O nome do destino de resposta é o mesmo nome do destino de pedido, seguido por "Reply". Exemplo: myProxyServiceReply.
      • As listas de mediações disponíveis contêm todas as mediações que são atualmente implementadas para esse barramento de integração de serviço. Se você tiver criado uma mediação e implementado-a no barramento, ela ficará disponível para seleção nessas duas listas. Se você não desejar utilizar uma mediação com esse serviço de proxy, selecione nenhum em qualquer uma das listas de seleção ou em ambas.
      • Os membros do barramento são servidores de aplicativos ou clusters que são incluídos neste barramento. As propriedades Membro do barramento de mediação de pedido e Membro do barramento de mediação de resposta definem os membros do barramento aos quais a mediação correspondente está designada. Se você selecionar uma mediação, deverá atribuí-la a um membro de barramento; Se você configurar o valor da propriedade Mediação de Pedido ou Mediação de Resposta como (nenhum), deverá alterar também o valor da propriedade do membro de barramento correspondente para (nenhum).

        Se você não fizer isto, o console administrativo exibirá uma mensagem de erro.

      • Um arquivo WSDL de proxy genérico é utilizado para configurar os parâmetros básicos para a chamada (por exemplo, qual ligação utilizar), mas é possível substituir o padrão digitando o local do arquivo WSDL genérico de substituição no campo URL de substituição do WSDL de proxy.
    2. Selecione listeners do terminal para a configuração de entrada deste serviço de proxy.
  8. Clique em Concluir.

Resultados

Se o processamento for concluído com êxito, a lista de serviços de proxy para esta instância de gateway será atualizada para incluir o novo serviço de proxy. Caso contrário, uma mensagem de erro é exibida.

O que Fazer Depois

Certifique-se de que todos os solicitantes de serviços anexem um parâmetro de cadeia de consulta operationMode ao endereço para o serviço de proxy. O valor desse parâmetro é oneway ou requestResponse e o padrão érequestResponse. Exemplo:
  • Para operação HTTP, se o endereço da Web do serviço proxy for
    http://host_name:port_number/wsgwsoaphttp1/soaphttpengine
    /your_bus/ProxyService/ProxyServiceInboundPort
    então, os clientes solicitantes indicarão que estão enviando um pedido de uma via utilizando o seguinte URL:
    http://host_name:port_number/wsgwsoaphttp1/soaphttpengine
    /your_bus/ProxyService/ProxyServiceInboundPort?operationMode=oneway
  • Para operação JMS, se o endereço do JMS do serviço de proxy for
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=your_bus/ProxyService/ProxyServiceInboundPort
    então, os clientes solicitantes indicarão que estão enviando um pedido de uma via utilizando o seguinte URL:
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=
    your_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway

Í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=twsg_proxy_new
Nome do arquivo: twsg_proxy_new.html