Nó JavaCompute

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

Finalidade

Utilize o nó JavaCompute para executar uma das seguintes tarefas:

  • Examinar uma mensagem que chega e, dependendo de seu conteúdo, propagá-la inalterada para um dos dois terminais de saída do nó; o nó comporta-se de forma semelhante a um nó Filter, mas utiliza Java em vez de ESQL para decidir qual terminal de saída utilizar.
  • Alterar parte de uma mensagem que chega e propagar a mensagem alterada para um dos terminais de saída.
  • Criar e construir uma nova mensagem de saída que seja totalmente independente da mensagem de entrada.

O código Java utilizado pelo nó está armazenado em um projeto Eclipse Java.

O nó JavaCompute é representado no workbench pelo seguinte ícone:

 Ícone do nó Compute

Utilizando este nó em um fluxo de mensagens

O nó JavaCompute pode ser utilizado de três maneiras:

  • Utilize o nó JavaCompute para consultar uma mensagem e propagá-la para um terminal de saída com base no conteúdo da mensagem. O conteúdo da mensagem não é alterado e você tem acesso de leitura à mensagem.
  • Utilize o nó JavaCompute para modificar uma mensagem e propague a mensagem modificada para um terminal de saída.
  • Utilize o nó JavaCompute para criar uma nova mensagem e propagá-la para um terminal de saída.

Consulte as amostras no Galeria de Exemplos no Message Brokers Toolkit.

Configurando o Nó JavaCompute

É possível configurar cada instância do nó JavaCompute que ocorre em um fluxo de mensagens.

Para isso, clique com o botão direito do mouse no nó na visualização do editor. É exibida a opção Abrir Java. Clique nesta propriedade.

A primeira vez que isso for feito, será ativado um assistente que o orientará na criação de um novo projeto Java e de uma classe Java que contém algum código de estrutura. Este código de estrutura é apresentado em um editor Java.

Consulte Criando Código Java para um Nó JavaCompute para obter exemplos do código de estrutura ou gabarito fornecidos.

Se esta não for a primeira vez que isso é feito, será exibido o código Java em uma perspectiva de cálculo Java.

Para associar uma instância de um nó JavaCompute a uma classe Java, clique com o botão direito do mouse no nó na visualização do editor do fluxo de mensagens e selecione Propriedades e, em seguida, Básicas. As propriedades básicas do nó são exibidas.

O nó JavaCompute tem apenas uma propriedade básica. Esta é uma Classe Java. Digite o nome da classe Java utilizada neste nó. Esse nome deve estar na lista de classes do nó JavaCompute que estão disponíveis nas referências de projeto para o projeto do fluxo de mensagens.

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.

Quando tiver concluído sua configuração, clique em Aplicar. Isto faz as alterações no nó JavaCompute sem fechar o diálogo de propriedades.

Como alternativa, clique em OK. Isto faz as alterações no nó JavaCompute e fecha o diálogo de propriedades.

Você pode clicar em Cancelar para fechar o diálogo e descartar todas as alterações feitas no nó.

Especificando Java

Codifique instruções Java para customizar o comportamento do nó JavaCompute.

Por exemplo, você pode personalizá-lo para criar uma nova mensagem ou mensagens de saída, utilizando a mensagem de entrada ou o conteúdo do banco de dados (inalterado ou modificado) ou novos dados. Por exemplo, talvez você queira modificar um valor na mensagem de entrada, incluindo um valor de um banco de dados e armazenar o resultado em um campo na mensagem de saída.

Codifique as instruções Java que deseja em um arquivo Java associado ao nó JavaCompute.

Se um arquivo Java ainda não existir para nó, clique com o botão direito do mouse no nó JavaCompute e clique em Abrir Java. Isto cria e abre um novo arquivo Java na visualização do editor.

Se o arquivo já existir, clique no botão Procurar ao lado da propriedade Classe Java. Isso exibe o diálogo Seleção de Tipo de Nó JavaCompute, que lista as classes Java acessíveis por esse fluxo de mensagens. Selecione a classe Java apropriada e clique em OK. A lista de tipos de correspondência mostra classes Java adequadas quando pelo menos um caractere for digitado no campo Selecionar.
Nota: Todas as classes Java são mostradas se você digitar '*' no campo Selecionar.

Validando Mensagens

Configure as propriedades de validação para definir como a mensagem produzida pelo nó JavaCompute será validada. Observe que estas propriedades não causam a validação da mensagem de entrada. É esperado que, se tal validação for requerida, ela já tenha sido desempenhada pelo nó input ou por um nó Validação precedente.

Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.

Terminais e Propriedades

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

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem de entrada será roteada se for detectado um defeito durante o cálculo. (Mesmo que a propriedade Validar for definida, as mensagens propagadas para o terminal failure do nó não serão validadas).
Saída O terminal de saída para o qual a mensagem transformada será roteada.
Alternativo Um terminal de saída alternativo para o qual a mensagem transformada pode ser roteada, em vez de ser para o terminal de Saída.

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

O nó JavaCompute tem a propriedade Básica descrita na tabela a seguir.

Propriedade M C Padrão Descrição
Classe Java Sim Não Nenhum(a) O nome da classe Java utilizada neste nó. Este nome deve aparecer na lista de classes Java disponíveis para utilização.

As propriedades de Validação do nó JavaCompute são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Validar Sim Sim Nenhum Se a validação ocorrerá e qual parte da mensagem será validada. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar.
Ação de Defeito Sim Não Exceção O que acontece se ocorrer um defeito de validação. Você poderá configurar esta propriedade apenas se Validar estiver configurado 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ções.
Incluir Todas as Limitações do Valor Sim Não Selecionado Essa propriedade não pode ser editada. A ação padrão, indicada pela caixa de opções que está sendo selecionada, é que todas as restrições de valores estão incluídas na validação.
Corrigir Sim Não Nenhum Essa propriedade não pode ser editada. É fornecida uma correção mínima. Os valores válidos são Nenhum e Total.

As propriedades das Opções de Mensagens Gerais do nó JavaCompute são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Sincronização de Análise Sim 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 Falso 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ó JavaCompute são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS Sim Não selecionada Não Início da mudançaA configuração dessa propriedade faz com que a MQRFH2 de saída especifique XMLNS em vez de o analisador XMLNSC, permitindo que um aplicativo externo permaneça inalterado. Se as mensagens de saída não contiverem cabeçalhos MQRFH2, essa propriedade não tem nenhum efeito.Fim da mudança
Modo de Retenção de Conteúdo Misto Sim 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 Sim 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 Sim 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ó JavaCompute 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.
Conceitos relacionados
Visão Geral de Fluxos de Mensagens
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac20805_