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

HTTPReply

Utilize o nó HTTPReplypara retornar uma resposta do fluxo de mensagens para um cliente HTTP. Este nó gera a resposta para um cliente HTTP a partir do qual a mensagem de entrada foi recebida pelo nó do HTTPInput e aguarda a confirmação de que ela foi enviada.

Este tópico contém as seguintes seções:

Finalidade

O nó HTTPReply pode ser usado em um fluxo de mensagens que envia uma resposta para mensagens HTTP ou HTTPS de entrada. O exemplo mais comum deste cenário é um fluxo de mensagens que implementa um serviço da Web.

Para obter informações adicionais sobre serviços da Web, consulte Processando mensagens do serviço da Web.

Por padrão, mensagens HTTP são tratadas pelo listener do broker inteiro, que é iniciado quando um fluxo de mensagens que inclui nós HTTP é iniciado. Todas as mensagens HTTP de entrada e de saída são roteadas através deste listener, para todos os nós HTTP implementados em todos os fluxos de mensagens em todos os grupos de execução no broker.

É possível configurar o grupo de execução para usar seu listener integrado para servir os nós HTTP em todos os fluxos de mensagens que são implementados nesse grupo de execução. O listener integrado se comunica diretamente com o cliente e os nós.

Para obter informações adicionais sobre como usar o listener integrado, consulte Listeners HTTP.

Não é possível usar um nó HTTPReply para responder a um pedido de serviço da Web que é recebido por um nó SOAPInput; o broker gera uma exceção quando a resposta é tentada.

Se tiver configurado o grupo de execução para usar seu listener integrado para nós HTTP, você deverá implementar o fluxo que inclui o nó HTTPReply no mesmo grupo de execução que o fluxo de mensagens que inclui o nó HTTPInput. Se seu broker estiver configurado para iniciar o listener do broker para suportar nós HTTP, você deverá implementar o fluxo de resposta no mesmo broker, mas o grupo de execução não será significativo, porque o listener é compartilhado.

O nó HTTPReply constrói uma mensagem de resposta para o cliente de serviço da Web a partir da árvore de mensagem de entrada inteira e a retorna ao solicitante. Se a mensagem foi recebida inicialmente por um nó HTTPInput no outro fluxo de mensagens, a resposta será associada à resposta por um identificador de pedido que é armazenado no ambiente local da mensagem pelo nó HTTPInput.

O nó HTTPReply está contido na caixa da paleta HTTP e representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó HTTPReply

Conectando os Terminais de Saída a Outro nó

Conecte o terminal de Saída ou de Falha deste nó em outro nó neste fluxo de mensagens se desejar processar a mensagem ainda mais, processar erros ou enviar a mensagem para um destino adicional.

Terminais e Propriedades

Quando tiver colocado uma instância do nó HTTPReply 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ó HTTPReply são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem será roteada se for detectado um defeito quando a mensagem for propagada.
Saída O terminal de saída para o qual a mensagem é roteada se tiver sido propagada com êxito e se for necessário processamento adicional neste fluxo de mensagens.

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 se você precisar inserir um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando você incluir o fluxo de mensagens no arquivo BAR para implementação).

As propriedades Descrição do nó HTTPReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não HTTPReply O nome do nó.
Short description Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó HTTPReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Ignorar falhas de transporte Sim Não Selecionada Selecione Ignorar Falhas de Transporte para que as falhas relacionadas ao transporte sejam ignoradas (por exemplo, se o cliente for desconectado). Se você desmarcar a caixa de opções e um erro relacionado a transporte ocorrer, a mensagem de entrada será propagada para o terminal de falha (Failure). Se limpar a caixa de opções, deverá fornecer um valor para o Tempo Limite de Envio de Resposta (s).
Tempo limite de envio de resposta (s) (Reply send timeout (sec)) Sim Não 120 Configure o valor de Tempo Limite de Envio de Resposta (s) se não estiver ignorando as falhas de transporte. Essa propriedade especifica o período de tempo, em segundos, que o nó aguarda uma confirmação de que o cliente recebeu a resposta. Se a confirmação for recebida nesse tempo, a mensagem de entrada será propagada pelo terminal de saída (Out) para o restante do fluxo de mensagens, se conectado. Se uma confirmação não for recebida nesse tempo, a mensagem de entrada será propagada pelo terminal de falha (Failure), se conectado. Se o terminal de falha não estiver conectado, e uma confirmação não for recebida em tempo, uma exceção será gerada.

O intervalo válido é de zero (o que significa uma espera indefinida) a (231)-1. Essa propriedade é válida somente se Ignorar Falhas de Transporte estiver desmarcada.

Gerar cabeçalhos HTTP padrão a partir de responder ou de resposta Sim Não Selecionada Selecione Gerar cabeçalhos HTTP padrão da resposta (Generate default HTTP headers from reply or response) se você quiser que cabeçalhos de serviço da Web padrão sejam criados utilizando valores do HTTPReplyHeader ou do HTTPResponseHeader. Se o cabeçalho apropriado não estiver presente na mensagem de entrada, serão utilizados os valores padrão.

O nó sempre inclui, no HTTPReplyHeader, um cabeçalho Content-Length, que é configurado com o valor calculado correto, mesmo se este cabeçalho não estava incluído no pedido original.

As propriedades Validação do nó HTTPReply são descritas na tabela a seguir.

Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada. Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Herdar Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar. validateMaster
Ação de falha Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.  
As propriedades Monitoramento do nó são descritas na tabela a seguir.
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.

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:16


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04585_