WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Visão Geral da Árvore SOAP

Esse formato de árvore permite acessar as partes principais da mensagem SOAP de maneira conveniente.

Esta é uma representação diagramática da árvore do domínio SOAP:

O Diagrama Mostra o Analisador SOAP, que É Descrito no Texto Circundante.
A árvore SOAP contém os seguintes elementos:
SOAP.Header
Contém os blocos de cabeçalhos SOAP (filhos de Envelope.Header)
SOAP.Body
Contém a carga útil SOAP (filhos de Envelope.Body )

O conteúdo da subárvore Body depende do estilo WSDL.

SOAP.Attachment
Contém anexos para uma mensagem SwA em seu formato não codificado.

Observe que os anexos para uma mensagem MTOM são representados de forma seqüencial como parte do conteúdo SOAP em uma representação base 64.

SOAP.Context
Contém as seguintes informações:
  • Entrada; preenchida pelo nó SOAPInput:
    • operation - o nome da operação WSDL. No modo de gateway, presume-se que a operação seja o nome do elemento que é o primeiro filho do elemento de Corpo SOAP, se presente, caso contrário, ele será o nome de constante 'ComIbmBrokerGenericGatewayOperation'.
    • portType - o nome do tipo de porta WSDL. No modo de gateway, este item fica vazio.
    • port - o nome da porta WSDL (se conhecido). No modo de gateway, este item fica vazio.
    • service - o nome do serviço WSDL (se conhecido). No modo de gateway, o serviço tem o nome de constante 'ComIbmBrokerGenericGatewayService'.
    • fileName - o nome do arquivo WSDL original. No modo de gateway, este item fica vazio.
    • operationType - um de 'REQUEST_RESPONSE', 'ONE_WAY', 'SOLICIT_RESPONSE', 'NOTIFICATION'. No modo de gateway, sem WSDL, este campo contém 'GATEWAY'. Isso significa 'REQUEST_RESPONSE' ou 'GATEWAY_ONE_WAY', o que significa que o nó detectou o tipo de operação como sendo unidirecional.
    • SOAP_Version - um de '1.1' ou '1.2'.
    • Namespace - Contém elementos filhos nameValue; o name é o prefixo de Namespace e o value é a URI do Namespace conforme aparece no fluxo de bits.
    • XmlDeclaration - representa a declaração XML padrão.
  • Saída; os seguintes campos podem ser colocados em SOAP.Context para fornecer informações de anulação quando o nó SOAPRequest ou SOAPAsyncRequest serializa uma mensagem SOAP:
    • SOAP_Version - um de '1.1' ou '1.2'
    • Namespace - Contém os elementos filhos nameValue que definem o prefixo de namespace (o name) a ser usado para uma URI de namespace especificada (o value).

      Uma mensagem de saída utiliza os prefixos de esaço de nomes definidos aqui para preparar elementos nos espaços de nomes correspondentes.

      Se o SOAP.Context foi originalmente criado em um nó de entrada, pode já conter todas as definições de prefixos de espaço de nomes necessárias.

      Se SOAP.Context não existir, ou as mensagens de saída utilizarem espaços de nomes adicionais, o analisador SOAP gera os prefixos de espaço de nomes automaticamente.

      Como alternativa, você pode especificar seu próprio prefixo de espaço de nomes; o nome específico de um espaço de nomes normalmente não afeta o significado de uma mensagem com uma exceção importante. Se o conteúdo da mensagem engloba um nome qualificado, a mensagem deve conter uma definição de prefixo de espaço de nomes compatível.

      Por exemplo, sr a mensagem de saída é uma Falha SOAP contendo um elemento <faultcode> com o valor soapenv:Server, um prefixo de espaço de nomes (o qual diferencia letras maiúsculas e minúsculas) para soapenv deve ser definido na árvore lógica:
      -- Construir mensagem de erro SOAP. Observe que bem como definir o correto 
      -- espaço de nomes para o elemento Fault, também é necessário ligar o 
      -- prefixo de espaço de nomes utilizado no elemento faultcode (isto é definido em 
      -- SOAP.Context.Namespace)
      
      -- Enviar de volta uma nova mensagem de falha SOAP 1.2 definida pelo usuário
      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';
      -- Enviar de volta uma nova mensagem de falha SOAP 1.1 definida pelo usuário
      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';
Somente Namespace, SOAP_Version e XmlDeclaration influenciam o fluxo de bits gerado para uma árvore SOAP; os outros campos são apenas informativos.

Para construir um mapa de dados gráficos para o domínio SOAP, use a mensagem da IBM® fornecida para a árvore de domínio do SOAP como a entrada para o mapa, a saída ou ambos. Consulte Conjuntos de Mensagens: Mensagens Fornecidas pela IBM que Podem Ser Importadas para obter mais informações sobre as mensagens fornecidas. Use os recursos Cast ou Submapa do Mapeador de Dados Gráficos para definir o conteúdo específico do corpo de SOAP. Consulte Tipos de Transformação no Editor de Mapeamento de Dados Gráficos para obter mais informações sobre funções de mapeamento.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:51


Tópico de ConceitoTópico de Conceito | Versão 8.0.0.5 | ac64020_