Utilize o nó JavaCompute para trabalhar com mensagens utilizando a linguagem Java.
Este tópico contém as seguintes seções:
Utilizando este nó, você pode concluir as seguintes tarefas:
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:
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.
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.
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. |