Utilize 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 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:
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. 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.
|
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 desvioSe você estiver utilizando o catálogo de mensagens padrão, esse texto será inserido como &1 no texto da mensagem. |