Utilize o nó SOAPAsyncResponse em conjunto com o nó SOAPAsyncRequest para construir um par de fluxos de mensagens que chama um serviço da Web de modo assíncrono.
O nó SOAPAsyncRequest envia um pedido de serviço da Web, mas o nó não aguardo o recebimento de uma resposta do serviço da Web associado. No entanto, o nó SOAPAsyncRequest aguarda pela confirmação de HTTP 202 antes de continuar com o fluxo de mensagens, e o nó SOAPAsyncRequest será bloqueado se a confirmação não for recebida. A resposta do serviço da Web é recebida pelo nó SOAPAsyncResponse, que pode estar em um fluxo de mensagens separado. Os nós são utilizados como um par e correlacionam respostas em relação aos pedidos originais.
O analisador SOAP chama o analisador XMLNSC para analisar o conteúdo XML do serviço da Web SOAP e para validar o corpo XML do serviço da Web SOAP. As opções do analisador SOAP são transmitidas para o analisador XMLNSC. Para obter informações adicionais, consulte Manipulando Mensagens no Domínio XMLNSC.
O nó SOAPAsyncResponse está contido no repositório da paleta do Serviços da Web e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
A configuração do nó SOAPAsyncResponse não é orientada por WSDL, apesar de a lista 'cabeçalhos que devem ser entendidos' configurada no nó SOAPAsyncRequest correspondente ser aplicável ao nó SOAPAsyncResponse.
A maioria das opções de configuração para esse nó é configurada no seu nó SOAPAsyncRequest do par, incluindo as propriedades Destino de Restauração e Limite de Restauração. Nenhuma falha de SOAP é enviada quando o limite de restauração é atingido.
LocalEnvironment.SOAP.Response.UserContext
Se as propriedades do ambiente local LocalEnvironment.Destination.SOAP.Response.ReplyIdentifier ou LocalEnvironment.Destination.HTTP.RequestIdentifier forem fornecidas para o nó SOAPAsyncRequest com par, elas serão passadas para o ambiente local para o nó SOAPAsyncResponse.
Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.
O nó SOAPAsyncResponse pode receber uma resposta que tem uma Codificação de Conteúdo gzip ou deflate. Quando tal resposta é recebida, o conteúdo é decodificado e o cabeçalho de Codificação de Conteúdo é removido.
Quando tiver colocado uma instância do nó SOAPAsyncResponse em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.
Os terminais do nó SOAPAsyncResponse são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Failure | O terminal de saída para o qual uma mensagem de resposta SOAP assíncrona é roteada se uma falha for detectada quando a é propagada para o fluxo de Saída (como uma mensagem de falha de validação). |
Saída | O terminal de saída para o qual a mensagem de resposta SOAP assíncrona é roteada se tiver sido recebida com êxito e se for necessário processamento adicional nesse fluxo de mensagens. Se não ocorrer nenhum erro no nó, uma mensagem de resposta SOAP sem falhas válida, recebida de um recurso externo, sempre é enviada para o terminal de Saída primeiramente. |
Falha | O terminal de saída para o qual uma resposta de falha do SOAP assíncrona é roteada se tiver sido recebida com êxito e se for necessário processamento adicional da falha nesse fluxo de mensagens. |
Catch | O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó. |
As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).
As propriedades Descrição do nó SOAPAsyncResponse são descritas na tabela a seguir.
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Nome de nó | Não | Não | O tipo de nó: SOAPAsyncResponse | O nome do nó. |
Short description | Não | Não | Nenhuma | Uma breve descrição do nó. |
Descrição Longa | Não | Não | Nenhuma | Texto que descreve a finalidade do nó no fluxo de mensagens. |
As propriedades Básicas do nó SOAPAsyncResponse são descritas na tabela a seguir.
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Identificador exclusivo | Sim | Não | Especifique o fragmento de URL exclusivo que seja comum a seu par de nós SOAPAsyncRequest e SOAPAsyncResponse. | asyncRequestCorrelator |
A propriedade Transações do nó SOAPAsyncResponse é descrita na tabela a seguir. A configuração não se aplica quando o nó usa transporte HTTP.
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Modo de Transação | Sim | Não | Não | Essa propriedade controla se a mensagem é recebida em uma transação JMS. Os valores válidos são Sim e Não. Selecione Não para receber a mensagem usando uma sessão JMS não transacional. Selecione Sim para receber a mensagem usando uma sessão JMS transacional. A transação JMS pode ser local ou coordenada por XA. Para usar uma transação coordenada por XA usando uma sessão JMS XA, você também deve selecionar a propriedade de fluxo de mensagens Transação Coordenada nas propriedades do arquivo BAR. Consulte o Configurando para Transações JMS Coordenadas. |
A propriedade Avançada do nó SOAPAsyncResponse está descrita na tabela a seguir.
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Configurar lista de destino | Não | Não | Selecionado | Esta propriedade indica se deve incluir a operação SOAP de entrada na rota para a lista de destino do rótulo. |
Prefixo do rótulo | Não | Não | Utilize esta propriedade para incluir um prefixo no nome da Operação SOAP na lista de destino. Você deve incluir um Prefixo de Etiqueta se quiser utilizar vários nós SOAPAsyncResponse no mesmo fluxo de mensagens sem causar um conflito entre os nós Label correspondentes. Por padrão, o prefixo é uma cadeia vazia para que o nome da operação e o nome do rótulo sejam idênticos. Essa propriedade não está disponível se a propriedade Definir Lista de Destino estiver desmarcada. | |
Colocar Cabeçalhos WS-Addressing no LocalEnvironment | Não | Não | Desmarcada | Esta propriedade especifica se o nó coloca cabeçalhos WS-Addressing da mensagem de resposta na árvore de ambiente local. Os cabeçalhos WS-Addressing não estão acessíveis para o fluxo se esta caixa de opção estiver limpa porque, por padrão, todos os cabeçalhos são processados e removidos. |
As propriedades Instâncias do nó SOAPAsyncResponse são descritas na tabela a seguir.
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Conjunto de instâncias adicionais | Não | Sim | Utilizar Conjunto Associado ao Fluxo de Mensagens | O conjunto do qual as instâncias adicionais são obtidas.
|
componentLevel |
Instâncias Adicionais | Não | Sim | 0 | O número de instâncias adicionais que o nó pode iniciar se a propriedade do Conjunto de Instâncias Adicionais estiver configurada como Utilizar Conjunto Associado ao Nó. Por padrão, não são concedidas instâncias adicionais ao nó. | additionalInstances |
As propriedades Análise de Mensagem de Resposta do nó SOAPAsyncResponse são descritas na tabela a seguir. O nó SOAPAsyncResponse configura estas propriedades automaticamente; você não pode configurá-las sozinho.
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Domínio de mensagem | Não | Não | SOAP | O domínio que é utilizado para analisar a mensagem de resposta. Por padrão, a mensagem propagada do nó SOAPAsyncResponse
está no domínio SOAP. Você não pode especificar um domínio diferente. Para
obter mais informações, consulte Analisador e Domínio SOAP. As propriedades de Análise de Mensagem de Resposta são ignoradas quando o nó SOAPAsyncRequest do par é configurado para agir no modo de gateway. |
Conjunto de Mensagens | Sim | Não | configure automaticamente a partir da propriedade nome do arquivo WSDL que é fornecida pelo nó SOAPAsyncRequest. | O nome do conjunto de mensagens no qual a mensagem de resposta está definida. Conjunto de Mensagens é configurado automaticamente
para o conjunto de mensagens que contém o arquivo WSDL que é configurado no nó SOAPAsyncRequest correspondente. Se você configurar esta propriedade e, em seguida, subsequencialmente, atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, um aviso será emitido. Atualize a propriedade Conjunto de Mensagens ou restaure a referência para este projeto de conjunto de mensagens. As propriedades de Análise de Mensagem de Resposta são ignoradas quando o nó SOAPAsyncRequest do par é configurado para agir no modo de gateway. |
Tipo de Mensagem | Não | Não | O nome da mensagem de resposta. O nó detecta o tipo de mensagem automaticamente. Você não pode configurar esta propriedade. | |
Formato de Mensagem | Não | Não | O nome do formato físico da mensagem de resposta. Você não pode configurar esta propriedade. |
As propriedades Opções do Analisador do nó SOAPAsyncResponse são descritas na tabela a seguir. As propriedades são transmitidas para o analisador XMLNSC.
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Cronometragem de análise (Parse timing) | Não | Não | On Demand | Essa propriedade controla quando uma mensagem de resposta é analisada. Os valores
válidos são On
Demand,
Imediato e
Completo. Por padrão, o tempo de análise é configurado como On demand, o que faz com que a análise da mensagem de entrada seja atrasada. Para obter uma descrição completa desta propriedade, consulte Analisando On Demand. |
Construir árvore utilizando tipos de dados de esquema XML | Não | Não | Selecionado | Esta propriedade controla se o analisador XMLNSC cria elementos de sintaxe na árvore de mensagens com tipos de dados retirados do Esquema XML. Essa propriedade é ignorada quando o nó SOAPAsyncRequest do par é configurado para agir no modo de gateway. |
Reter conteúdo misto (Retain mixed content) | Não | Não | Desmarcada | Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado. |
Reter comentários (Retain comments) | Não | Não | Desmarcada | Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens quando ele encontra comentários em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado. |
Reter instruções de processamento (Retain processing instructions) | Não | Não | Desmarcada | Essa propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento em uma mensagem de resposta. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado. |
Elementos opacos | Não | Não | Em branco | Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de resposta que devem ser analisados em segundo plano pelo analisador XMLNSC. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada. |
As propriedades Validação do nó SOAPAsyncResponse são descritas na tabela a seguir. Por padrão, a validação está ativada.
Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada. Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.
Propriedade | M | P | Default | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | Não | Sim | Conteúdo e Valor | Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo. As propriedades de validação são ignoradas quando o nó SOAPAsyncRequest do par é configurado para agir no modo de gateway. |
validateMaster |
Ação de falha | Não | Não | Exceção | Essa propriedade controla o que acontecerá se a validação falhar. Você pode definir essa propriedade somente se definir Validar para Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do
Usuário, Lista de Exceções, Log de Erros Local e Exceção. As propriedades de validação são ignoradas quando o nó SOAPAsyncRequest do par é configurado para agir no modo de gateway. |
Propriedade | M | P | Default | Descrição |
---|---|---|---|---|
Eventos | Não | Não | Nenhum | Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar,
e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes. É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado. |
Configuração | Descrição |
---|---|
UserContext | É possível recuperar dados de contexto que foram armazenados pelo nó
SOAPAsyncRequest do seguinte local no ambiente local:
|