Utilización de WSDL para configurar flujos de mensajes

Puede utilizar WSDL para configurar flujos de mensajes.

Los flujos de mensajes que funcionan con servicios web utilizan normalmente los nodos SOAP. Para obtener detalles sobre los nodos SOAP, consulte WebSphere Message Broker y servicios web.

En modalidad WSDL, los nodos SOAP se configuran utilizando WSDL que se ha importado o generado anteriormente en un conjunto de mensajes y se visualiza bajo WSDL desplegable en el entorno de trabajo. Puede arrastrar el WSDL a un nodo SOAP o especificarlo utilizando la propiedad Nombre de archivo WSDL en el nodo.

Puede cambiar la Modalidad de operación de los nodos SOAP para que actúen en modalidad de pasarela. En modalidad de pasarela, no es necesario un WSDL para configurar los nodos ya que estos manejan mensajes SOAP de solicitud/respuesta y unidireccionales genéricos que no están asociados a un WSDL específico. Para obtener más información, consulte Modalidad de operación de pasarela para nodos SOAP.

Cuando importa WSDL arrastrándolo a un nodo SOAP, las propiedades del nodo se configuran a partir de las propiedades en el URI address de WSDL. Las propiedades de transporte del nodo SOAP se rellenan de acuerdo con el primer enlace importado del archivo WSDL. Por consiguiente, si el primer enlace importado describe un transporte JMS, se rellenan las propiedades de transporte JMS; si el primer enlace importado describe un transporte HTTP, se rellenan las propiedades de transporte HTTP. Si selecciona otro enlace importado, las propiedades de transporte se rellenarás en consecuencia. portType aparece de forma distinta en función del transporte seleccionado.

El URI del elemento address de WSDL puede existir en dos formatos diferentes, formato W3C o formato IBM® (en desuso). El formato del URI de WSDL afecta a los nombres de las propiedades WSDL que el analizador busca para llenar las propiedades del nodo SOAP. Por ejemplo, la tabla Parámetros de contexto JNDI no se rellena cuando se importa WSDL de estilo IBM puesto que no da soporte a estas propiedades en el URI de dirección de WSDL. La tabla sólo se rellena si hay parámetros de contexto JNDI presentes en un WSDL de estilo W3C. Para obtener información detallada, consulte Formatos de URI de WSDL de JMS.

Si proporciona una definición de servicio, las propiedades de punto final se establecen automáticamente pero también puede establecer o alterar temporalmente estas propiedades de forma manual.

Opcionalmente, las definiciones WSDL se pueden dividir en varios archivos. El arreglo típico es que un archivo de definición de servicio de nivel superior importe un archivo de enlace, el archivo de enlace importe un archivo de interfaz y este archivo de interfaz importe o incluye archivos de definición de esquema.

Un portType WSDL (la interfaz WSDL lógica) no es suficiente por sí solo para configurar un nodo SOAP; se necesita un enlace específico para que la carga útil de SOAP se defina correctamente en tiempo de ejecución.

Un enlace define un uso, que puede ser document (el valor predeterminado) o rpc. Si el uso es document, la carga útil de SOAP la describe un elemento de esquema XML en el WSDL. Si el uso es rpc, la carga útil de SOAP es el nombre de operación de WSDL en un espacio de nombres especificado.

Si desea crear su propio flujo de mensajes, configure los nodos de la forma indicada. Sin embargo, puede crear un nuevo flujo de mensajes de esqueleto arrastrando una definición de WSDL sobre un lienzo Editor de flujos de mensajes en blanco y seleccionando un enlace WSDL específico. También puede elegir el tipo de flujo (consumidor o proveedor de servicio) y las operaciones que el flujo deberá manejar.

Las propiedades y los nodos clave del flujo de mensajes generado están configurados, pero debe completar la configuración y añadir otros nodos que necesite antes de desplegar el flujo. Para obtener detalles sobre cómo configurar un nuevo servicio web utilizando el asistente, consulte Asistente Configurar nuevo uso del servicio web.

Configuración de los nodos SOAP

WSDL configura explícitamente los nodos siguientes:
WSDL configura implícitamente los nodos siguientes, porque éstos heredan la configuración WSDL del nodo con los que se emparejan:

Un nodo SOAPReply se utiliza siempre con un nodo SOAPInput. Para obtener detalles de escenarios de servicio web, consulte Escenarios de servicios web.

Un nodo SOAPAsyncResponse se utiliza siempre con un nodo SOAPAsyncRequest, asociado a la propiedad Identificador exclusivo. Para conocer los patrones de uso de nodo SOAP, consulte Escenarios de servicios web.

Consulta de WSDL con ?wsdl

Un cliente de servicio web puede enviar una solicitud HTTP GET con una serie de consulta ?wsdl a los flujos de mensajes que implementan servicios web y recibir una representación del WSDL que se ha utilizado para configurar el nodo de entrada que proporciona el punto final para el servicio. Puede llevar a cabo esta tareas solamente para los nodos de entrada que utilizan el transporte HTTP y no JMS. El protocolo de la solicitud HTTP GET debe coincidir con el protocolo del flujo; por lo tanto, si el flujo utiliza SSL, la solicitud HTTP GET debe comenzar por https://.

El cliente se inicia enviando una consulta ?wsdl simple y recupera la definición WSDL completa siguiendo una cadena de importaciones e inclusiones de referencia. Por ejemplo, si el punto final del servicio web es http://hostlocal:7800/test1, la solicitud del cliente inicial será:

GET http://hostlocal:7800/test1?wsdl

Esta solicitud devuelve la definición de servicio WSDL de nivel superior, que puede incluir importaciones para más secciones de la definición WSDL. Por ejemplo, si el WSDL devuelto tiene una línea:

<wsdl:import ... location="http://hostlocal:7800/test1?wsdl=wsdl0"/>

el cliente enviará la solicitud pertinente para recuperar esa sección del WSDL:

GET http://hostlocal:7800/test1?wsdl=wsdl0

Una o más secciones WSDL también puede tener importaciones para datos del esquema XML, por ejemplo:

<xsd:import ... schemaLocation="http://hostlocal:7800/test1?xsd=xsd0"/>

El cliente nuevamente envía la solicitud pertinente para recuperar esos datos:

GET http://hostlocal:7800/test1?xsd=xsd0
Solamente se puede seguir las referencias correctas desde el punto de vista semántico:
  • Los elementos <wsdl:import> que son hijos inmediatos de los elementos wsdl:definition
  • Los elementos <xsd:import> y <xsd:include> que son hijos inmediatos de los elementos xsd:schema
siendo wsdl una abreviación (prefijo de espacio de nombres) para http://schemas.xmlsoap.org/wsdl/ y xsd una abreviación de http://www.w3.org/2001/XMLSchema. Una solicitud realizada a un URI a partir de un elemento que superficialmente tiene aspecto de una <importación> o<inclusión>, por ejemplo, un elemento de un comentario, implica que se devuelva un error de SOAP. Solamente la serie de consulta ?wsdl simple y las posteriores consultas que coinciden exactamente con aquellas consultas especificadas en importaciones e inclusiones válidas semánticamente, provocan la devolución de datos.

La definición WSDL devuelta equivale desde el punto de vista al WSDL desplegable en el kit de herramientas, con los esquemas externalizados incorporados. Puede que físicamente no sea idéntico a la definición de WSDL importada originalmente. Aunque se haya configurado un SOAPInput con un enlace WSDL específico, el WSDL devuelto también incluye otros enlaces que no utilizan el flujo si forman parte de la definición WSDL original que se ha importado.

Avisos | Marcas registradas | Este enlace se abre en una nueva ventana Descargas | Este enlace se abre en una nueva ventana Biblioteca | Este enlace se abre en una nueva ventana Soporte | Comentarios

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última actualización
        
        Última actualización : 2011-11-07 13:53:44


Tema de conceptoTema de concepto | Versión 8.0.0.0 | ac56230_