Mandato createWSGWProxyService

Utilice el mandato createWSGWProxyService para establecer la pasarela para que actúe como un proxy para el servicio, utilice los manejadores JAX-RPC para establecer los puntos finales para los mensajes de solicitud de entrada para el servicio.

Puede crear una nueva configuración de servicio proxy utilizando la herramienta wsadmin como se describe en este tema, o bien utilizando la consola administrativa como se describe en Creación de una configuración de servicio proxy nueva.

Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.

[IBM i][IBM i]El cliente de scripts wsadmin se ejecuta desde Qshell. [IBM i]Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.

Para los mandatos del bus de integración de servicios se proporciona ayuda de línea de mandatos:
  • Si desea una lista de los mandatos disponibles de pasarela, además de una breve descripción de cada mandato, escriba el mandato siguiente en el indicador de wsadmin:

    print AdminTask.help('WSGateway')

  • Si desea ayuda general sobre un mandato determinado, especifique el mandato siguiente en el indicador de wsadmin:

    print AdminTask.help('nombre_mandato')

Después de utilizar el mandato, guarde los cambios en la configuración maestra utilizando el mandato siguiente:

AdminConfig.save()

Finalidad

Este mandato crea un objeto ProxyService nuevo con un objeto InboundService asociado y un objeto TargetService con un objeto OutboundService asociado.

Utilice un mandato de servicios web habilitado para el bus de integración de servicios para añadir cualquier objeto InboundPort asociado al objeto InboundService. Para obtener más información, consulte el ejemplo de trabajo que se encuentra al final de este tema.

Objeto de destino

ObjectName de la instancia de pasarela en la que se ha creado el servicio de proxy.

El mandato crea el destino de la solicitud proxy y el destino de la respuesta correspondiente. El destino de solicitud de proxy se configura para actualizar la vía de acceso de respuesta de modo que se añada el destino de respuesta. Si ya existe un destino con el nombre especificado o el nombre predeterminado, el mandato no se ejecuta correctamente.

Si ya existe un servicio Gateway o un servicio proxy con el mismo nombre, el mandato no se ejecuta correctamente.

Si especifica el nombre del destino de solicitud del proxy, el destino del servicio del proxy y los destinos de puertos se crean con nombres derivados del nombre de destino de solicitud del proxy. De lo contrario, el destino de servicio del proxy y los destinos de puertos se crean con nombres derivados del nombre del servicio proxy. El nombre del destino del servicio proxy se crea añadiendo "ProxyService" al destino de solicitud del proxy o al nombre del servicio proxy. Cada destino de puerto del proxy se denomina según el destino de servicio del proxy, seguido de dos puntos (":"), seguidos del nombre del puerto, seguido de "Port". Si ya existe un destino con cualquiera de estos nombres, el mandato no se ejecuta correctamente.

Especifique el nodo y el servidor, o bien especifique el clúster. Si no hay un motor de mensajería definido para el nodo y servidor o clúster especificados, el mandato fallará.

el mandato crea un objeto OutboundService con el mismo nombre que el servicio proxy. Este nuevo servicio de salida utiliza los destinos creados, la ubicación suministrada y la ubicación del WSDL del proxy predeterminado para la instancia de pasarela o, si se ha especificado, la ubicación del archivo WSDL del proxy. El nuevo servicio de salida se asocia con el objeto ProxyService.

El WSDL de proxy debe tener solamente un elemento de servicio. Si hay varios puertos en el elemento de servicio individual, se crea un puerto de salida para cada uno.

El WSDL de proxy nunca debe proceder del UDDI, sólo se da soporte a una dirección web para la ubicación de WSDL de proxy predeterminado y alterado.

El mandato utiliza el destino del proxy para crear un objeto InboundService con el mismo nombre que el servicio del proxy y utiliza el valor predeterminado o la ubicación WSDL del proxy especificado como la ubicación del WSDL de plantilla.

Parámetros necesarios

-name
El nombre del servicio del proxy.

Parámetros condicionales

-node
El nodo en el que se localizan los destinos.
-server
El servidor en el que se localizan los destinos.
-cluster
El clúster en el que se localizan los destinos.

Parámetros opcionales

-requestDestination
El nombre del destino de solicitud de proxy.
-replyDestination
El nombre del destino de respuesta de proxy.
-wsdlLocation
La ubicación del archivo WSDL del proxy. Ésta es una dirección web.

Ejemplo

El siguiente es un ejemplo mínimo de una secuencia de mandatos para crear un servicio proxy totalmente funcional con asociaciones de protocolo de salida SOAP sobre HTTP.
  1. Cree el servicio proxy, donde wsgw es la instancia de pasarela:
    • 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. Obtenga el servicio de entrada para el servicio Gateway, dondebusName es el nombre del bus de integración de servicios:
    • 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. Añada un puerto SOAP sobre HTTP, donde el escucha de punto final 1 SOAP sobre HTTP ya está 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. Complete la configuración de los servicios de entrada y salida y de los puertos. Por ejemplo, aplique manejadores JAX-RPC o WS-Security.
Nota:
Asegúrese de que todos los solicitantes de servicio añadan un parámetro de serie de consulta operationMode en la dirección del servicio proxy. El valor de este parámetro es oneway o requestResponse y el valor predeterminado es requestResponse. Por ejemplo:
  • Para la operación HTTP, si la dirección web del servicio proxy es
    http://nombre_host:número_puerto/wsgwsoaphttp1/soaphttpengine
    /su_bus/ProxyService/ProxyServiceInboundPort
    A continuación, los clientes solicitantes indican que están enviando una petición unidireccional utilizando el URL siguiente:
    http://nombre_host:número_puerto/wsgwsoaphttp1/soaphttpengine
    /su_bus/ProxyService/ProxyServiceInboundPort?operationMode=oneway
  • Para la operación JMS, si la dirección JMS del servicio proxy es
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=your_bus/ProxyService/ProxyServiceInboundPort
    A continuación, los clientes solicitantes indican que están enviando una petición unidireccional utilizando el URL siguiente:
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=
    su_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwsg_cli_proxy_new
File name: rwsg_cli_proxy_new.html