Use o nó Throw para emitir uma exceção em um fluxo de mensagens.
Este tópico contém as seguintes seções:
Uma exceção pode ser capturada e processada por:
Inclua um nó Throw para forçar um caminho de erro pelo fluxo de mensagens se o conteúdo da mensagem contiver dados inesperados. Por exemplo, para retornar uma mensagem que não contenha um campo particular, é possível verificar (usando um nóFilter) se o campo existe; se o campo não existir , a mensagem pode ser passada para um nó Throw que registre detalhes sobre a exceção na subárvore da lista de exceções da mensagem.
O nó Throw está contido no repositório Construção da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
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.
Inclua um nó Throw com um nó TryCatch em seu fluxo de mensagens para alertar o administrador de sistemas sobre uma possível situação de erro; por exemplo, se você tiver um nó Compute que calcula um número, teste o resultado deste cálculo e emita uma exceção se o resultado exceder uma determinada quantidade. O nó TryCatch captura esta exceção e propaga a mensagem para uma seqüência de nós que processam o erro.
Quando tiver colocado uma instância do nó Throw 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.
O terminal do nó Throw é descrito na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | O terminal de entrada que aceita a mensagem para processamento pelo 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ó Throw são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome de nó | Não | Não | O tipo de nó: Throw | 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ó Throw são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Catálogo de Mensagens | Não | Não | O nome do catálogo de mensagens a partir do qual o texto do erro para o número do erro da exceção é extraído. Digite o caminho completo e o nome do arquivo do catálogo de mensagens que contém a origem da mensagem. Esse arquivo pode ser seu próprio catálogo de mensagens ou o catálogo de mensagens padrão fornecido com o WebSphere Message Broker. Para utilizar o catálogo padrão fornecido, deixe essa propriedade em branco. | |
Número da Mensagem | Não | Não | 3001 | O número do erro da exceção que está sendo lançada.
|
Texto da mensagem | Não | Não | Texto adicional que explica a causa do erro. Digite qualquer texto de formato livre adicional que contenha informações que você deseja
incluir com a mensagem quando ela for gravada no log de erros local; por
exemplo, se você tiver verificado a existência de um campo específico em uma
mensagem e lançado uma exceção quando esse campo não foi localizado, poderá incluir
o texto:
Se você estiver utilizando o catálogo de mensagens padrão, esse
texto será inserido como &1 no texto da mensagem. |
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. |