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

Route

Utilize o nó Route para direcionar mensagens que atendem determinados critérios em diferentes caminhos de um fluxo de mensagens.

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

Propósito

Como um exemplo, você pode redirecionar uma mensagem para diferentes provedores de serviços, com base nos detalhes do pedido. Também é possível utilizar o nó Route para ignorar etapas desnecessárias. Por exemplo, é possível verificar se alguns dados estão em uma mensagem e desempenhar uma operação de consulta ao banco de dados apenas se os dados estiverem ausentes. Se você configurar a propriedade Modo de Distribuição como Tudo, poderá acionar vários eventos, sendo que cada um requer condições diferentes. Por exemplo, você pode registrar pedidos que estão relacionados a um identificador de conta específico e enviar pedidos que estão relacionados a um determinado produto que deve passar por auditoria.

Você utiliza expressões de filtro XPath para controlar o processamento. Um resultado de uma expressão de filtro é convertido em Booleano, assim é garantido que o resultado seja verdadeiro ou falso. Para obter informações adicionais sobre a sintaxe da consulta XPath 1.0, consulte Especificação de W3C XPath 1.0.

O nó Route está contido no repositório do Roteamento da paleta do nó do fluxo de mensagens e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó Route

Utilizando este nó em um fluxo de mensagens

Examine a amostra a seguir para ver como utilizar esse nó:

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ó Route possui um terminal de entrada e um mínimo de três terminais de saída: Correspondência, Padrão e Falha. Os terminais de saída Padrão e de Falha são estáticos, portanto, eles sempre estão presentes no nó. O terminal de Correspondência dinâmico é criado automaticamente sempre que um novo nó Route é selecionado e utilizado no editor do Fluxo de Mensagens. Esse comportamento significa que você não tem sempre de criar o primeiro terminal de saída dinâmico para esse nó, que é o número mínimo de terminais necessários para esse nó operar. Você pode renomear este terminal dinâmico se "Correspondência" não for um nome apropriado.

Uma mensagem será copiada para o terminal Padrão se as expressões de filtro forem true. Se ocorrer uma exceção durante a filtragem, a mensagem será propagada para o terminal de Falha. O nó Route pode definir um ou mais terminais de saída dinâmicos. Para todos os terminais, a expressão de filtro associada é aplicada à mensagem de entrada e, se o resultado for verdadeiro, uma cópia da mensagem é roteada para o terminal específico. O nó Route determina a ordem na qual os terminais são orientados. O nó sempre propaga mensagens para os terminais na ordem na qual aparecem na tabela de filtros.

Cada expressão de filtro é aplicada à mensagem de saída na ordem especificada na tabela de filtro. Se o resultado for true, uma cópia da mensagem será roteada para seu terminal de saída dinâmico associado. Se você configurar a propriedade Modo de Distribuição como First, a aplicação de todas as expressões de filtro pode não ocorrer.

Considere a seguinte mensagem de entrada de exemplo:
<EmployeeRecord>
	<EmployeeNumber>00001</EmployeeNumber>
	<FamilyName>Smith</FamilyName>
	<Wage>20000</Wage>
</EmployeeRecord>
e as seguintes expressões de filtro XPath:
$Root/XMLNSC/EmployeeRecord/EmployeeNumber="00002"|Match
$Root/XMLNSC/EmployeeRecord/EmployeeNumber="00001"|out_exp2

Neste exemplo, a propriedade Modo de Distribuição está configurada como Primeira. O nó Route processa as expressões de filtro XPath, na ordem na qual são exibidos, em relação à mensagem de entrada. Como a propriedade Modo de Distribuição está configurada como Primeiro, a mensagem de entrada não modificada é propagada apenas uma vez para o terminal de saída dinâmico mapeado para a primeira expressão de filtro que é resolvida como true. No exemplo anterior, a primeira expressão de filtro, que está associada com o terminal de Correspondência, é falso, porque o número do funcionário na mensagem de entrada não é "00002". Portanto, nenhuma mensagem é propagada para o terminal de Correspondência. A segunda expressão de filtro é verdadeira, portanto uma cópia da mensagem de entrada é roteada para o terminal dinâmico "out_expr2". Se o número do funcionário na mensagem de entrada for "00003" e, portanto, não corresponder a nenhuma expressão de filtro, a mensagem será propagada para o terminal de saída estático padrão. Se a propriedade Modo de Distribuição for configurada para Todos para esse exemplo, o mesmo resultado será atingido, porque apenas uma expressão de filtro será verdadeira.

Terminais

Os terminais do nó Route são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada estático que aceita uma mensagem para processamento pelo nó.
Correspondência Um terminal de saída dinâmico ao qual a mensagem original pode ser roteada quando o processamento for concluído com êxito. É possível criar terminais dinâmicos adicionais; consulte Terminais Dinâmicos.
Padrão O terminal de saída estático para o qual a mensagem será roteada se nenhuma expressão de filtro for resolvida como true.
Failure O terminal de saída a para o qual a mensagem será roteada se for detectada uma falha durante o processamento.

Terminais Dinâmicos

O nó Route pode ter terminais de saída dinâmicos adicionais. Nem todos os terminais de saída dinâmicos que são criados em um nó Route têm de ser mapeados para uma expressão na tabela de filtro. As mensagens nunca são propagadas para terminais de saída dinâmicos não mapeados. Várias expressões podem ser mapeadas para o mesmo terminal de saída dinâmico único. Não existe nenhum terminal de saída dinâmico para o qual a mensagem é transmitida diretamente. Para obter informações adicionais utilizando os terminais dinâmicos, consulte Utilizando Terminais Dinâmicos.

Properties

Quando tiver colocado uma instância do nó Route em um fluxo de mensagens, você poderá configurá-lo. Para obter informações adicionais, 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 inserir um valor (as propriedades que não têm um valor-padrão definido) são marcadas com um asterisco.

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ó Route são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Nome de nó Não Não O tipo de nó, Route 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ó Route são descritas na tabela a seguir.
Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Tabela de filtros Sim Não   Uma tabela na qual todas as linhas são expressões e nomes de terminais associados que definem a comutação desempenhada por este nó após a avaliação de cada expressão de filtro. A expressão completa está no formato
expressão de filtro XPath, nome do terminal	
Todas as expressões XPath devem ser iniciadas por $Root, $Properties, $LocalEnvironment, $DestinationList, $ExceptionList ou $Environment. Se você estiver criando uma expressão à mão, poderá também iniciar a expressão com $Body. No entanto, o XPath Expression Builder e a validação associada no WebSphere Message Broker Toolkit não suportam o uso da variável $Body. Se estiver usando o XPath Expression Builder, use a variável $Root no lugar.

As expressões são avaliadas na ordem na qual são exibidas na tabela. Para aprimorar o desempenho, especifique as expressões atendidas com mais frequência na parte superior da tabela de filtro. Geralmente, você especifica um nome de terminal exclusivo para cada expressão XPath.

 
Modo de Distribuição Não Sim Todos Esta propriedade determina o comportamento do roteamento do nó quando uma mensagem de saída corresponde a várias expressões de filtro. Se você configurar a propriedade Modo de Distribuição como Primeiro, a mensagem será propagada para o terminal de saída apropriado da primeira expressão na tabela que é resolvida como true. Se você configurar esta propriedade como Todos, a mensagem será propagada para o terminal de saída associado para cada expressão na tabela que é resolvida como true. Se nenhum terminal de saída corresponder, a mensagem será propagada para o terminal Default. distributionMode
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:39


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