WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Visión general del árbol SOAP

Este formato de árbol permite acceder a partes clave del mensaje SOAP de una forma práctica.

Esta es una representación en forma de diagrama del árbol de dominio SOAP:

El diagrama muestra el analizador SOAP, que se describe en el texto que lo rodea.
El árbol SOAP contiene los elementos siguientes:
SOAP.Header
Contiene los bloques de la cabecera SOAP (los hijos de Envelope.Header)
SOAP.Body
Contiene la carga de trabajo de SOAP (los hijos de Envelope.Body )

El contenido del subárbol Body depende del estilo WSDL.

SOAP.Attachment
Contiene los adjuntos de un mensaje SwA en su formato no codificado.

Tenga en cuenta que los adjuntos de un mensaje MTOM se representan en línea como parte del contenido SOAP en una representación de base 64.

SOAP.Context
Contiene la siguiente información:
  • Entrada; llenada por el nodo SOAPInput:
    • operation - el nombre de la operación WSDL. En modalidad de pasarela, se presupone que la operación es el nombre del elemento que es el primer hijo del elemento Body de SOAP, si está presente; de lo contrario, es el nombre constante 'ComIbmBrokerGenericGatewayOperation'.
    • portType - el nombre del tipo de puerto WSDL. En modalidad de pasarela, este elemento está vacío.
    • port - el nombre del puerto WSDL (si se conoce). En modalidad de pasarela, este elemento está vacío.
    • service - el nombre del servicio WSDL (si se conoce). En modalidad de pasarela, el servicio tiene el nombre constante 'ComIbmBrokerGenericGatewayService'.
    • fileName - el nombre de archivo WSDL original. En modalidad de pasarela, este elemento está vacío.
    • operationType - uno de los siguientes: 'REQUEST_RESPONSE', 'ONE_WAY', 'SOLICIT_RESPONSE', 'NOTIFICATION'. En modalidad de pasarela, sin WSDL, este campo contiene 'GATEWAY'. Esto indica 'REQUEST_RESPONSE' o 'GATEWAY_ONE_WAY', lo que significa que el nodo ha detectado que el tipo de operación es unidireccional.
    • SOAP_Version - '1.1' o '1.2'.
    • Namespace - Contiene elementos hijo nameValue; name es el prefijo de espacio de nombres y value es el URI de espacio de nombres tal como aparece en la corriente de bits.
    • XmlDeclaration - representa la declaración XML estándar.
  • Salida; los siguientes campos pueden colocarse en SOAP.Context para proporcionar información de alteración temporal cuando los nodos SOAPRequest o SOAPAsyncRequest serializan un mensaje SOAP:
    • SOAP_Version - '1.1' o '1.2'
    • Namespace - Contiene elementos hijo nameValue que definen el prefijo de espacio de nombres (name) que se debe utilizar para un URI de espacio de nombres especificado (value).

      Un mensaje de salida utiliza los prefijos de espacio de nombres definidos aquí para calificar todos los elementos de los correspondientes espacios de nombres.

      Si SOAP.Context se creó originalmente en un nodo de entrada, es posible que ya contenga todas las definiciones de prefijos de espacios de nombres que necesite.

      Si SOAP.Context no existe, o el mensaje de salida utiliza espacios de nombres adicionales, el analizador SOAP genera automáticamente todos los prefijos de nombres de espacio necesarios.

      De forma alternativa puede especificar su propio prefijo de espacio de nombre; el nombre específico de un prefijo de espacio de nombres no afecta normalmente el significado de un mensaje, con una excepción importante. Si el contenido del mensaje contiene un nombre calificado, el mensaje debe contener una definición de prefijo de espacio de nombres coincidente.

      Por ejemplo, si el mensaje de salida es un error SOAP que contiene un elemento <faultcode> con el valor soapenv:Server, un prefijo de espacio de nombres (que es sensible a las mayúsculas y minúsculas) para soapenv debe definirse en el árbol lógico:
      -- Crear mensaje de error SOAP. Tenga en cuenta que además de definir 
      -- el espacio de nombres correcto para el elemento Fault, también es necesario enlazar el 
      -- prefijo de espacio de nombres usado en el elemento faultcode (éste se configura bajo 
      -- SOAP.Context.Namespace)
      
      -- Devolver un nuevo mensaje de error SOAP 1.2 definido por el usuario
      DECLARE soapenv NAMESPACE 'http://www.w3.org/2003/05/soap-envelope';
      DECLARE xml     NAMESPACE 'http://www.w3.org/XML/1998/namespace';
      DECLARE myNS    NAMESPACE 'http://myNS';
      
      SET OutputRoot.SOAP.Context.Namespace.(SOAP.NamespaceDecl)xmlns:soapenv = soapenv;
      SET OutputRoot.SOAP.Context.Namespace.(SOAP.NamespaceDecl)xmlns:myNS = myNS;
      
      SET OutputRoot.SOAP.Body.soapenv:Fault.soapenv:Code.soapenv:Value = 'soapenv:Receiver';
      SET OutputRoot.SOAP.Body.soapenv:Fault.soapenv:Code.soapenv:Subcode.soapenv:Value = 'my:subcode value';
      SET OutputRoot.SOAP.Body.soapenv:Fault.soapenv:Reason.soapenv:Text = 'my Reason string';
      SET OutputRoot.SOAP.Body.soapenv:Fault.soapenv:Reason.soapenv:Text.(SOAP.Attribute)xml:lang = 'en';
      SET OutputRoot.SOAP.Body.soapenv:Fault.soapenv:Node = 'my Node string';
      SET OutputRoot.SOAP.Body.soapenv:Fault.soapenv:Role = 'my Role string';
      SET OutputRoot.SOAP.Body.soapenv:Fault.soapenv:Detail.my:Text = 'my detail string';
      -- Devolver un nuevo mensaje de error SOAP 1.1 definido por el usuario
      DECLARE soapenv NAMESPACE 'http://schemas.xmlsoap.org/soap/envelope/';
      SET OutputRoot.SOAP.Context.Namespace.(SOAP.NamespaceDecl)xmlns:soapenv = soapenv;
      
      SET OutputRoot.SOAP.Body.soapenv:Fault.faultcode = 'soapenv:Receiver';
      SET OutputRoot.SOAP.Body.soapenv:Fault.faultstring = 'my fault string';
      SET OutputRoot.SOAP.Body.soapenv:Fault.faultactor = 'my fault actor';
      SET OutputRoot.SOAP.Body.soapenv:Fault.detail.Text = 'my detail string';
Sólo Namespace, SOAP_Version y XmlDeclaration afectan a la corriente de bits generada para un árbol SOAP; los demás campos sólo son informativos.

Para crear una correlación de datos gráfica para el dominio SOAP, utilice el mensaje de IBM® proporcionado para el árbol de dominio SOAP como entrada para la correlación y/o la salida. Consulte Conjuntos de mensajes: mensajes proporcionados por IBM que puede importar para obtener más información sobre los mensajes proporcionados. Utilice las características Cast o Submap del Correlacionador de datos gráficos para definir el contenido específico del cuerpo SOAP. Consulte Tipos de transformación en el editor de correlaciones de datos gráficas para obtener más información sobre las funciones de correlación.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:53


Tema de conceptoTema de concepto | Versión 8.0.0.5 | ac64020_