HTTPReply

Utilize o nó HTTPReply para retornar uma resposta do fluxo de mensagens para o cliente do serviço da Web. Esse nó gera a resposta para o cliente do serviço da Web do qual a mensagem de entrada foi recebida pelo nó HTTPInput e aguarda a confirmação de que ela foi recebida.

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

Propósito

O nó HTTPReply pode ser utilizado em qualquer fluxo de mensagens que precise aceitar mensagens HTTP ou HTTPS. O exemplo mais comum disso é um fluxo de mensagens que implementa um serviço da Web.

Para obter informações adicionais sobre os aplicativos de serviço da Web, consulte Trabalhando com Aplicativos de Serviço da Web.

Se você incluir um nó HTTPReply em um fluxo de mensagem, deverá incluir um nó HTTPInput no mesmo fluxo, ou a mensagem deve ser recebida de outro fluxo que esteja em execução no mesmo intermediário e tenha sido iniciada com um nó HTTPInput. A resposta está associada à resposta de um identificador de pedido que é armazenada em LocalEnvironment pelo nó HTTPInput.

Este nó constrói uma mensagem de resposta para o cliente de serviço da Web a partir de toda a árvore de mensagens de entrada e retorna-a ao solicitante.

O nó HTTPReply está contido na caixa da paleta HTTP e representado no ambiente de trabalho pelo seguinte ícone:

Ícone do nó HTTPReply

Conectando os Terminais de Saída a Outro nó

Conecte o terminal Out ou Failure desse nó a outro nó nesse fluxo de mensagens se você quiser processar a mensagem melhor, processar os 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. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em 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
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem será roteada se for detectado um defeito quando a mensagem for propagada.
Out O terminal de saída para o qual a mensagem será 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 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ó 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ó.
Descrição Breve 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 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 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 Failure, se conectado. Se o terminal Failure 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 é definido com o valor correto calculado, mesmo que este não esteja 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
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.
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.
Inclusão de todos Valores de Tipo Não Não Selecionada Essa propriedade não pode ser editada. A ação padrão, indicada pela caixa de opções selecionada, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor.
Correção Não Não Nenhuma Essa propriedade não pode ser editada.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:40

ac04585_