WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

JavaCompute

Use o nó JavaCompute para trabalhar com mensagens usando a linguagem Java™.

Finalidade

Usando este nó, é possível concluir as seguintes tarefas:

  • Use 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.
  • Use Java para criar um mapa em um cache global e para incluir e recuperar dados desse mapa. Quando dados são armazenados no cache global, esses dados ficam disponíveis para outros nós JavaCompute ou fluxos de mensagens.

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

O código Java que você usa para acessar e manipular os dados da mensagem podem ser codificados usando qualquer um dos estilos de programação a seguir:
  • API de plug-in Java
  • Java Architecture for XML Binding (JAXB)
  • Document Object Model (DOM)

O nó JavaCompute está contido no repositório Transformação da paleta e é representado no WebSphere Message Broker Toolkit 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 o Modelo de Execução de Extensões Definidas pelo Usuário e o Considerações sobre Encadeamento para Extensões Definidas pelo Usuário.

Dê um clique duplo no nó JavaCompute para abrir o assistente Nova Classe de Nó de Cálculo Java. 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.

A classe MbJavaComputeNode contém dois métodos que você pode substituir: onInitialize() e onDelete(). Se desejar que o nó execute operações de limpeza, por exemplo, fechar soquetes, inclua uma implementação do método onDelete:
public void onDelete()
{
  // executar limpeza do nó se necessário
}
O método onInitialize() é chamado durante a implementação ou na inicialização do broker. Durante a implementação, o método é chamado antes da confirmação da implementação. Outros nós podem lançar exceções durante sua inicialização, portanto, a implementação do fluxo falhará, mesmo que o método onInitialize() desse nó funcione. Se o método onInitialize() lançar uma exceção, a implementação ou o início do fluxo falhará. Portanto, execute tarefas que sempre funcionem ou que sempre falhem durante o método onInitialize(). O broker não tentará iniciar o fluxo novamente até que seja reiniciado. Se você precisar inicializar uma conexão externa que possa precisar ser tentada novamente, faça isso na primeira mensagem por meio do fluxo para que ele possa tentar novamente a transação, conforme necessário.
Consulte a amostra a seguir para saber como utilizar este nó.

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker 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 clique em Abrir Java para criar e abrir um novo arquivo Java na visualização do Editor. Se o arquivo já existir, clique em Navegar ao lado da propriedade de Classe Java para exibir a janela Seleção de Tipo de Nó JavaCompute. Quando você digitar pelo menos um caractere no campo Selecionar, classes Java correspondentes serão listadas. É possível usar o asterisco (*) para representar qualquer caractere como parte de uma cadeia de procura; por exemplo, a*b. Selecione a classe Java apropriada e clique em OK.

Restrição: Não tente criar outra instância de um nó do JavaCompute a partir do código Java; isto não é suportado.

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. 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
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 se a propriedade Validar estiver configurada, as mensagens que são propagadas para o terminal de Falha do nó não sã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 (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 A O padrão Descrição
Nome de nó Não Não O tipo de nó: JavaCompute O nome do nó.
Short description 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 para o nó JavaCompute estão descritas na tabela a seguir.

Propriedade M A O padrão Descrição
Classe Java Sim Não Nenhum(a) O nome da classe Java utilizada neste nó. Esse nome deve ser exibido na lista de classes Java que estão disponíveis nas referências de projeto do Projeto do Message Broker.

Para selecionar um arquivo que já existe, clique em Navegar. Quando você digitar pelo menos um caractere no campo Selecionar, classes Java correspondentes serão listadas. É possível usar o asterisco (*) para representar qualquer caractere como parte de uma cadeia de procura; por exemplo, a*b. Selecione a classe Java apropriada e clique em OK.

Serviço carregador de classe Java Não Sim Nenhum(a) O nome do serviço configurável JavaClassLoader que é usado nesse nó. Se não for especificado nenhum nome e se existir um serviço configurável JavaClassLoader com o mesmo nome do grupo de execução, ele será usado nesse nó. Caso contrário, nenhum serviço configurável JavaClassLoader será usado.

Todos os nós de um grupo de execução que especificam o mesmo serviço configurável JavaClassLoader usam a mesma instância do carregador de classe. Consequentemente todos os nós usam a mesma versão da memória das classes, incluindo o acesso às mesmas variáveis estáticas.

Para obter informações adicionais, consulte Carregamento de Classe do Nó JavaCompute.

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

Propriedade M A O padrão Descrição
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.

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

Configure as propriedades de validação para definir como a mensagem produzida pelo nó JavaCompute será validada. Essas propriedades não fazem com que a mensagem de entrada seja validada. É esperado que, se tal validação for requerida, ela já tenha sido executada pelo nó input ou por um nó de validação anterior. Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
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. validateMaster
Ação de falha Não Não Exceção 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.  
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:28


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac20805_