Use o nó JavaCompute para trabalhar com mensagens usando a linguagem Java™.
Usando este nó, é possível 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 WebSphere Message Broker Toolkit 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 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.
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.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.
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.
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. |
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. |