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.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
- 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')
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
- 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"}]
- Utilizando Jython:
- 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/]
- Utilizando Jython:
- 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"}]
- Utilizando Jython:
- Complete la configuración de los servicios de entrada y salida y de los puertos. Por ejemplo, aplique manejadores JAX-RPC o WS-Security.
- Para la operación HTTP, si la dirección web del servicio proxy es
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
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
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=your_bus/ProxyService/ProxyServiceInboundPort
jms:/queue?destination=jndi_queue&connectionFactory= jndi_factory&targetService= su_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway