Comando createWSGWProxyService

Use o comando createWSGWProxyService para configurar o gateway a fim de atuar como um proxy para seu serviço e, em seguida, usar os manipuladores JAX-RPC para configurar os terminais para mensagens de solicitações recebidas para o serviço.

É possível criar uma nova configuração de serviço de proxy ao usar a ferramenta wsadmin, conforme descrito neste tópico, ou ao usar o console administrativo, conforme descrito em Criando uma Nova Configuração de Serviço de Proxy.

Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.

[IBM i][IBM i]O cliente de script wsadmin é executado do Qshell. [IBM i]Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.

A ajuda da linha de comandos é fornecida para comandos do barramento de integração de serviços:
  • Para obter uma lista dos comandos de gateway disponíveis, além de uma breve descrição de cada comando, digite o seguinte comando no prompt wsadmin:

    print AdminTask.help('WSGateway')

  • Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:

    print AdminTask.help('command_name')

Após utilizar o comando, salve suas alterações na configuração principal, utilizando o seguinte comando:

AdminConfig.save()

Propósito

Este comando cria um novo objeto ProxyService com um objeto InboundService associado e um objeto TargetService com um objeto OutboundService associado.

Em seguida, use um comando de serviços da web ativados pelo barramento de integração de serviços para incluir quaisquer objetos InboundPort associados ao objeto InboundService. Para obter informações adicionais, consulte o exemplo trabalhado no final deste tópico.

Objeto de destino

ObjectName da instância do gateway dentro do qual o serviço de proxy é criado.

O comando cria o destino de solicitação do proxy e o destino de resposta correspondente. O destino de pedido do proxy é configurado para atualizar o caminho de resposta para incluir o destino da resposta de proxy. Se já existir um destino com os nomes especificados ou padrão, o comando falhará.

Se já existir um serviço de gateway ou proxy com o mesmo nome, o comando falhará.

Se você especificar o nome do destino de pedido de proxy, esse destino e os destinos da porta serão criados com nomes derivados do nome do destino de pedido de proxy. Caso contrário, o destino de serviço de proxy e os destinos da porta serão criados com nomes derivados do nome do serviço de proxy. O nome do destino de serviço de proxy é criado incluindo-se "ProxyService" ao destino de pedido de proxy ou ao nome de serviço de proxy. Cada destino da porta de proxy é então nomeado após o destino de serviço de proxy, seguido de dois pontos (":"), do nome da porta, seguido de "Port". Se já existir um destino algum desses nomes, o comando falhará.

Especifique o nó e o servidor ou especifique o cluster. Se não existir mecanismo do sistema de mensagens definido para o nó e servidor ou cluster especificados, o comando falhará.

O comando cria um objeto OutboundService com o mesmo nome do serviço de proxy. Esse novo serviço de saída utiliza os destinos criados, o local fornecido e o local proxy padrão de WSDL para a instância do gateway ou (se especificado) o local do arquivo WSDL de proxy. O novo serviço de saída está associado a objeto ProxyService.

O WSDL do proxy deve ter somente um único elemento de serviço. Se houver várias portas dentro do único elemento de serviço, será criado um objeto da porta de saída para cada um.

O WSDL do proxy nunca deve ser originado do UDDI, portanto, apenas um endereço da web é suportado para o local WSDL padrão e substituído pelo proxy.

O comando usa o destino do proxy para criar um objeto InboundService com o mesmo nome que o serviço de proxy e usa o local WSDL padrão ou especificado pelo proxy como o local do WSDL de modelo.

Parâmetros necessários

-name
O nome de serviço do proxy.

Parâmetros Condicionais

-node
O nó no qual os destinos estão localizados.
-server
O servidor no qual os destinos estão localizados.
-cluster
O cluster no qual os destinos estão localizados.

Parâmetros Opcionais

-requestDestination
O nome do destino de pedido do proxy.
-replyDestination
O nome do destino de resposta de proxy.
-wsdlLocation
O local do arquivo WSDL de proxy. Este é um endereço da web.

Por exemplo:

A seguir há um exemplo mínimo de uma seqüência de comandos para criar um serviço de proxy totalmente funcional com conexões de protocolos SOAP sobre HTTP de entrada e saída:
  1. Crie o serviço de proxy, em que wsgw é a instância do gateway:
    • Utilizando Jython:
      proxyService = AdminTask.createWSGWProxyService(wsgw, ["-name",
       "MyProxyService", "-node", "MyNode", "-server", "server1"])
    • Utilizando Jacl:
      set proxyService [$AdminTask createWSGWProxyService $wsgw {-name
       "ProxyService" -node "MyNode" -server "server1"}]
  2. Obtenha o serviço de entrada do serviço de gateway, em que busName é o nome do barramento de integração de serviços:
    • Utilizando Jython:
      inServiceName = AdminConfig.showAttribute(proxyService, 
       "inboundServiceName")
      inService = AdminConfig.getid("/
       SIBus:"+busName+"/SIBWSInboundService:"+inServiceName+"/")
    • Utilizando Jacl:
      set inServiceName [$AdminConfig showAttribute $proxyService
       "inboundServiceName"]
      set inService [$AdminConfig getid 
      /SIBus:$busName/SIBWSInboundService:$inServiceName/]
  3. Inclua uma porta SOAP sobre HTTP, em que o listener do terminal 1 de SOAP sobre HTTP já esteja configurado:
    • Utilizando Jython:
      inPort = AdminTask.addSIBWSInboundPort(inPort, ["-name", "SOAPHTTPPort",
       "-endpointListener", "soaphttp1", "-node", "MyNode", "-server", "server1"])
    • Utilizando Jacl:
      set inPort [$AdminTask addSIBWSInboundPort $inPort {-name "SOAPHTTPPort"
       -endpointListener "soaphttp1" -node "MyNode" -server "server1"}]
  4. Conclua a configuração das portas e dos serviços de entrada e saída. Por exemplo, aplique Manipuladores JAX-RPC ou WS-Security.
Nota:
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 Referência



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