Este tópico contém as seguintes seções:
Utilize o nó JavaCompute para executar uma das seguintes tarefas:
O código Java utilizado pelo nó está armazenado em um projeto Eclipse Java.
O nó JavaCompute é representado no workbench pelo seguinte ícone:
O nó JavaCompute pode ser utilizado de três maneiras:
Consulte as amostras no Galeria de Exemplos no Message Brokers Toolkit.
É 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ó.
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.
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.
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 | ![]() ![]() |
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. |