JavaCompute

Utilize o nó JavaCompute para trabalhar com mensagens utilizando a linguagem Java.

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

Propósito

Utilizando este nó, você pode concluir as seguintes tarefas:

  • Utilize Java para examinar uma mensagem recebida e, dependendo de seu conteúdo, propagá-la inalterada para um dos dois terminais de saída do nó; o nó se comporta de maneira semelhante a um nó Filter, mas utiliza Java em vez de ESQL para decidir qual terminal de saída utilizar.
  • Utilize Java para alterar parte de uma mensagem recebida e propagar a mensagem alterada para um dos terminais de saída.
  • Utilize Java para 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 Java do Eclipse.

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

 Ícone do nó Compute

Utilizando este nó em um fluxo de mensagens

O nó JavaCompute utiliza o mesmo modelo de execução que os nós definidos pelo usuário Java e, portanto, as restrições e suposições associadas aos nós definidos pelo usuário Java também se aplicam ao código Java desenvolvido para nós JavaCompute; consulte Criando um Processamento de Mensagem ou Nó de Saída em Java. Somente uma instância do nó JavaCompute é criada, independentemente do número de encadeamentos em execução no fluxo (como resultado de instâncias adicionais ou de diversos nós de entrada). Portanto, todo o código Java do usuário deve ser thread-safe e reentrante. Para obter informações adicionais, consulte Modelo de Execução de Extensões Definidas pelo Usuário e Considerações sobre Encadeamento para Extensões Definidas pelo Usuário.

Dê um clique duplo no nó JavaCompute para abrir o assistente de Nova Classe do Nó JavaCompute. O assistente o orienta pela criação de um novo projeto Java e uma classe Java que contém algum código modelo. Este código modelo é implementado em um editor Java. Para obter informações adicionais sobre a criação de código Java para um nó JavaCompute e exemplos de código-base ou modelo que são fornecidos, consulte Criando Código Java para um Nó JavaCompute. Se não for a primeira vez que deu um clique duplo no nó, o código Java é exibido.

Consulte a amostra a seguir para saber como utilizar este nó. Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers Toolkit.

Especificando Java

Codifique instruções Java para customizar o comportamento do nó JavaCompute. Por exemplo, você pode customizar o nó 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 que está associado ao nó JavaCompute.

Se um arquivo Java ainda não existir para este nó, clique com o botão direito do mouse no nó JavaCompute e, em seguida, clique em Abrir Java para criar e abrir um novo arquivo Java na visualização do Editor. Se o arquivo já existir, clique em Procurar ao lado da propriedade Classe Java para exibir a janela Seleção do Tipo de Nó JavaCompute, que lista as classes Java que podem ser acessadas por esse fluxo de mensagens. Selecione a classe Java apropriada e clique em OK. A lista de tipos correspondentes mostra classes Java apropriadas quando pelo menos um caractere for digitado no campo Selecionar. Todas as classes Java serão mostradas se você digitar '*' no campo Selecionar.

Restrição: Início da mudançaNão tente criar outra instância de um nó do JavaCompute a partir do código Java; isto não é suportado.Fim da mudança

Terminais e Propriedades

Quando tiver colocado uma instância do nó JavaCompute em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. Para associar uma instância de um nó JavaCompute a uma classe Java, configure as propriedades do nó. As propriedades do nó são exibidas na visualização Propriedades. Para exibir as propriedades do nó no diálogo Propriedades, clique com o botão direito do mouse 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.

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

Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem de entrada será roteada se for detectado um defeito durante o cálculo. (Mesmo se a propriedade Validar estiver configurada, as mensagens que são propagadas para o terminal Failure do nó não são validadas.)
Out O terminal de saída para o qual a mensagem transformada será roteada.
Alternate Um terminal de saída alternativo para o qual a mensagem transformada pode ser roteada, em vez de ser para o terminal Out.

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ó JavaCompute 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ó: JavaCompute 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.

O nó JavaCompute possui 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 ser exibido na lista de classes Java que estão disponíveis nas referências do projeto para o projeto do fluxo de mensagens.

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

Propriedade M C Padrão Descrição
Cronometragem de análise (Parse timing) Sim Não Sob Demanda Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores válidos são On Demand, Imediato e Completo.Por padrão, esta propriedade é configurada como On Demand, o que faz com que a validação seja atrasada até que ela seja analisada pela análise parcial. Se você alterar esse valor para Imediato, a análise parcial será substituída e tudo o que estiver na mensagem será analisado e validado, exceto aqueles tipos complexos com uma composição de Opção ou Mensagem que não possam ser resolvidos no momento, causando uma falha de validação. Se você alterar esse valor para Completo, a análise parcial será substituída e tudo o que estiver na mensagem será analisado e validado.

Para obter uma descrição completa desta propriedade, consulte Analisando On Demand.

Utilizar analisador compacto MQRFH2C para domínio MQRFH2 Não Não Não Selecionada Esta propriedade controla se o analisador compacto MQRFH2C, em vez do analisador MQRFH2, será utilizado para cabeçalhos MQRFH2.
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS Não Não Não Selecionada A configuração dessa propriedade faz com que o MQRFH2 de saída especifique XMLNS em vez do 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 terá efeito.
Reter conteúdo misto (Retain mixed content) Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado.
Reter comentários (Retain comments) Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado.
Reter instruções de processamento (Retain processing instructions) Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado.

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

Configure as propriedades de validação para o analisador validar o corpo das mensagens em relação ao Conjunto de Mensagens. Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada. Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

Propriedade M C Padrão Descrição
Validar Não Sim Nenhum Essa propriedade controla 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 falha Não Não Exception Essa propriedade controla o que acontecerá se uma falha de validação ocorrer. 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 Não Não Selecionado Não é possível editar essa propriedade. Se a caixa de opções for selecionada (o padrão), todas as limitações de valor serão incluídas na validação.
Correção Não Não Nenhum Não é possível editar essa propriedade. É fornecida uma correção mínima. Os valores válidos são Nenhum e Total.
Conceitos relacionados
Visão Geral de Fluxos de Mensagens
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac20805_