Este tópico contém as seguintes seções:
Utilize o nó HTTPInput para receber pedidos de serviços da Web para processamento por um fluxo de mensagens. Utilizando o nó HTTPInput com os nós HTTPReply e HTTPRequest, o intermediário pode agir como um intermediário para serviços da Web e os pedidos de serviços da Web podem ser transformados e roteados da mesma forma que outros formatos de mensagens suportados pelo WebSphere Message Broker. Os pedidos de Serviço da Web podem ser recebidos em formato HTTP padrão (1.0 ou 1.1) e também no formato HTTPS (HTTP sobre SSL). É possível configurar a propriedade Utilizar HTTPS para escolher se deseja manipular pedidos HTTP ou HTTPS.
Se você incluir um nó HTTPInput em um fluxo de mensagens, também deverá incluir um nó HTTPReply no mesmo fluxo ou transmitir a mensagem para outro fluxo que inclua um nó HTTPReply (por exemplo, por meio de um nó MQOutput para um segundo fluxo que se inicie com um nó MQInput). No último caso, o pedido do cliente e a resposta para o cliente são coordenados pelo identificador de pedidos armazenado no Ambiente Local (descrito a seguir).
O nó HTTPInput identifica mensagens nos seguintes domínios de mensagens:
Quando o nó HTTPInput recebe uma mensagem de um cliente de serviço da Web, ele chama os analisadores apropriados para interpretar os cabeçalhos e o corpo da mensagem e para criar a árvore de mensagens que é utilizada internamente pelo fluxo de mensagens. O nó cria um identificador único para a mensagem de entrada e o armazena como uma matriz binária de 24 bytes na árvore Ambiente Local no LocalEnvironment.Destination.HTTP.RequestIdentifer. Esse valor é utilizado pelo nó HTTPReply e não deve ser modificado de forma alguma.
As mensagens HTTP são sempre não persistentes e não possuem ordem associada.
As mensagens HTTP são não transacionais. No entanto, se o fluxo de mensagens interagir com um banco de dados ou outro recurso externo, tal como, uma fila do WebSphere MQ, estas interações serão executadas de forma transacional.O nó HTTPInput fornece consolidação ou reversão, dependendo de como o fluxo de mensagens foi finalizado e como ele está configurado para tratamento de erros (como os terminais failure são conectados, por exemplo). Se for efetuado rollback do fluxo de mensagens por este nó, uma mensagem de falha será gerada e retornada ao cliente. O formato da falha é definido pela propriedade de Formato de Falha
Se ocorrer uma exceção no recebimento de dados neste fluxo de mensagens e não for capturada mas retornada a este nó, o nó construirá uma resposta de erro para o cliente. Este erro é derivado da exceção e o formato do erro é definido pela propriedade de Formato de Falha.
Se você incluir um nó output em um fluxo de mensagens que começa com um nó HTTPInput, ele poderá ser qualquer um dos nós de saída suportados (incluindo os nós de saída definidos pelo usuário). Você pode criar um fluxo de mensagens que receba mensagens de clientes de serviços da Web e gere mensagens para clientes que utilizam todos os transportes suportados para conexão com o intermediário, porque é possível configurar o fluxo de mensagens para solicitar que o intermediário forneça qualquer conversão necessária.
Se você criar um fluxo de mensagens para usar como um subfluxo, não será possível utilizar um nó input padrão; será necessário utilizar uma instância do nó Input como o primeiro nó para criar um terminal de entrada para o subfluxo.
Se seu fluxo de mensagens não receber pedidos de serviço da Web, é possível escolher um dos nós de entrada suportados.
O nó HTTPInput é representado no workbench pelo seguinte ícone:
O nó HTTPInput 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 sobre aplicativos de serviço da Web, consulte Aplicativos de Serviço da Web.
Quando tiver colocado uma instância do nó HTTPInput em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito do mouse na visualização do editor clique em Propriedades. As propriedades básicas do nó serão exibidas no diálogo de propriedades.
Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.
Configure o nó HTTPInput da seguinte forma:
Deixe o campo Conjunto de Mensagens vazio para analisadores XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Deixe Tipo de Mensagem em branco para os analisadores XML, XMLNS, XMLNSC, JMS, IDOC, MIME e BLOB.
Deixe o campo Formato da Mensagem vazio para analisadores XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
O HTTPInput encaminha cada mensagem recebida com êxito para o terminal de saída. Se a validação da mensagem falhar, a mensagem será roteada para o terminal failure; você poderá conectar nós nesse terminal para identificar essa condição. Se você não conectou o terminal failure, a mensagem será descartada, o Tempo de Espera Máximo do Cliente expirará e o listener TCP/IP retornará um erro ao cliente. Não há outras situações em que a mensagem será roteada para o terminal failure.
Se a mensagem for capturada por este nó após o lançamento de uma exceção no fluxo de mensagens, a mensagem será roteada para o terminal da captura. Se você não conectou o terminal catch, a mensagem será descartada, o Tempo de Espera Máximo do Cliente expirará e o listener TCP/IP retornará um erro ao cliente.
Os terminais do nó HTTPInput são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Defeito | O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. |
Saída | O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito. |
Capturar | 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 (marcado com um asterisco no diálogo de propriedades 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 no arquivo bar para implementá-lo).
As propriedades Básicas do nó HTTPInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Seletor URL | Sim | Sim | Identifica o local a partir do qual os pedidos de serviços da Web são recuperados. Se o URL desejado for http://<nome do host>[:<porta>]/[<caminho>], especifique /<caminho> ou /<fragmento de caminho>/*, em que * é um caractere curinga que pode ser utilizado para indicar qualquer correspondência. | |
Tempo de Espera Máximo do Cliente | Sim | Não | 180 | O tempo no qual o listener aguarda, em segundos, antes de retornar uma mensagem de erro ao cliente. O intervalo válido é de zero (que significa uma espera indefinida) a (231)-1. |
Formato de Falha | Não | Sim | SOAP 1.1 | O valor da propriedade pode ser SOAP 1.1, SOAP 1.2 ou HTML. Esta propriedade define o formato de qualquer um dos erros HTTP retornados ao cliente. |
Utilizar HTTPS | Não | Sim | não | Identifica se o nó aceitará HTTP seguro. |
As propriedades Padrão do nó HTTPInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Domínio de Mensagens | Não | Não | O domínio que será utilizado para analisar a mensagem que chega. | |
Conjunto de Mensagens | Não | Não | O nome ou identificador do conjunto de mensagens no qual a mensagem que chega está definida. | |
Tipo de Mensagem | Não | Não | O nome da mensagem que chega. | |
Formato de Mensagem | Não | Não | O nome do formato físico da mensagem que chega. |
As propriedades de Validação do nó HTTPInput são descritas na tabela a seguir.
Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa destas propriedades.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validar | Não | Sim | Nenhum | Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo. |
Ação de Defeito | Não | Não | Exceção | O que acontece se a validação falha. 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ção. |
Incluir Todas as Limitações do Valor | Não | Não | Selecionada | Essa propriedade não pode ser editada. A ação padrão, indicada pela seleção da caixa de opções, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor. |
Corrigir | Não | Não | Nenhum | Essa propriedade não pode ser editada. |
As propriedades das Opções de Mensagens Gerais do nó HTTPInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Sincronização de Análise | Não | Não | On Demand | Esta propriedade controla quando uma mensagem de entrada é analisada.
Os valores
válidos são On
Demand,
Imediato e
Completo. Consulte Analisando On Demand para obter uma descrição completa dessa propriedade. |
Utilizar o Analisador Compacto MQRFH2C para o Domínio MQRFH2 | Não | Não | Não selecionada | Esta propriedade controla se o MQRFH2C Compact Parser, no lugar do analisador MQRFH2, é utilizado para cabeçalhos MQRFH2. |
As propriedades das Opções do Analisador XMLNSC para o nó HTTPInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS | Não | Não | Não selecionada | ![]() ![]() |
Modo de Retenção de Conteúdo Misto | Não | Não | Nenhum | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Os valores válidos são Nenhum e Todos. A seleção de Todos significa que os elementos são criados para o texto misto. A seleção de Nenhum significa que o texto misto é ignorado e nenhum elemento é criado. |
Modo de Retenção de Comentários | Não | Não | Nenhum | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Os valores válidos são Nenhum e Todos. Selecionar Tudo significa que são criados elementos para comentários. A seleção de Nenhum significa que os comentários são ignorados e nenhum elemento é criado. |
Modo de Retenção de Instruções de Processamento | Não | Não | Nenhum | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Os valores válidos são Nenhum e Todos. Selecionar Tudo significa que são criados elementos para instruções de processamento. A seleção de Nenhum significa que as instruções de processamento são ignoradas e nenhum elemento é criado. |
As propriedades de Descrição do nó HTTPInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
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. |