Throw

Utilize o nó Throw para emitir uma exceção em um fluxo de mensagens.

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

Propósito

Uma exceção pode ser capturada e processada por:

  • Um nó TryCatch precedente
  • O nó de entrada do fluxo de mensagens (os nós integrados, por exemplo, HTTPInput e MQInput, têm terminais Catch)
  • Um nó AggregateReply precedente

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 restaurar uma mensagem que não contém um campo específico, você pode verificar (utilizando um nó Filter) se o campo existe; se o campo não existir, a mensagem poderá ser transmitida para um nó Throw que registra detalhes sobre a exceção na subárvore ExceptionList na mensagem.

O nó Throw está contido no repositório Construção da paleta e é representado no ambiente de trabalho pelo seguinte ícone:

 Ícone do nó Throw

Utilizando este nó em um fluxo de mensagens

Veja as amostras a seguir para consultar sobre como utilizar este nó: Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers 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.

Terminais e Propriedades

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. 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.

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 do 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.
  • Se você tiver criado seu próprio catálogo de mensagens, insira o número para a mensagem no catálogo que deseja utilizar quando essa exceção for emitida.
  • Se você estiver utilizando o catálogo de mensagens padrão, especifique um número entre 3001 (o padrão) e 3049. Estes números são reservados no catálogo padrão para utilização. O texto de cada uma dessas mensagens no catálogo de mensagens padrão é idêntico, mas você pode utilizar um número diferente nesse intervalo para cada situação que você lançar uma exceção; utilize o número para identificar a causa exata do erro.
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:
A mensagem não continha o campo requerido: Número do desvio
Se você estiver utilizando o catálogo de mensagens padrão, esse texto será inserido como &1 no texto da mensagem.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac04830_