Criando um Nó de Entrada em Java

Antes de começar

O WebSphere Message Broker fornece a origem para dois nós de amostra definidos pelo usuário chamados SwitchNode e TransformNode. Você pode utilizar esses nós em seus estados atuais ou poderá modificá-los.

Um nó definido pelo usuário em Java é distribuído como um arquivo .jar. Este tópico descreve as etapas que devem ser executadas para criar um nó utilizando Java. Ele esboça as seguintes etapas:
  1. Criando um Novo Projeto Java
  2. Declarando a Classe do Nó de Entrada
  3. Definindo o Construtor de Nó
  4. Declarando o Nome do Nó
  5. Declarando Atributos
  6. Implementando a Funcionalidade do Nó
  7. Excluindo uma Instância do Nó

Não desenvolva nós Java no z/OS que você pretenda implementar em um intermediário em uma plataforma distribuída. Isso porque o nível de Java no z/OS pode não produzir código compatível com o nível de Java na plataforma distribuída.

Criando um Novo Projeto Java

É possível criar nós Java de dentro do workbench utilizando o PDE (Plug-in Development Environment) fornecido. Para fazer isso, você deve criar um novo projeto Java, da seguinte forma:
  1. Alterne para o Perspectiva de Desenvolvimento de Plug-in.
  2. Clique em Arquivo > Novo > Projeto. Selecione Java no menu esquerdo e, em seguida, selecione Projeto Java no menu direito.
  3. Dê um nome ao projeto.

    O painel Definições Java é exibido.

  4. Selecione a guia Bibliotecas e clique em Incluir JARs Externos.
  5. Selecione install_dir\classes\jplugin2.jar.
  6. Siga os prompts nas outras guias para definir quaisquer outras definições de construção.
  7. Clique em Concluir.
Em seguida você pode desenvolver a origem para o nó Java dentro deste projeto.

Declarando a Classe do Nó de Entrada

Qualquer classe que implemente a MbInputNodeInterface e esteja contida no classpath do intermediário (ou no caminho da LIL) é registrada com o intermediário como um nó de entrada. Quando se implementa a MbInputNodeInterface, é preciso implementar também um método run para essa classe. O método run representa o início do fluxo de mensagens, contém os dados que formulam a mensagem e a propaga pelo fluxo. O intermediário chama o método run quando encadeamentos se tornam disponíveis de acordo com o modelo de encadeamento especificado.

Por exemplo, para declarar a classe de nó de entrada:

package com.ibm.jplugins;

import com.ibm.broker.plugin.*;

public class BasicInputNode extends MbInputNode implements MbInputNodeInterface
{
...
Você pode fazer isso no workbench da seguinte forma:
  1. Clique em Arquivo > Novo > Classe.
  2. Defina o pacote e os campos de nome de classe para valores adequados.
  3. Exclua o texto no campo de texto Superclasse e clique no botão Procurar.
  4. Selecione MbInputNode.
  5. Clique no botão Incluir próximo ao campo de texto Interface e selecione MbInputNodeInterface.
  6. Clique em Concluir.

Definindo o Construtor de Nó

Quando o nó é instanciado, o construtor da classe de nó do usuário é chamado. É aqui que são criados os terminais do nó e inicializados quaisquer valores padrão para os atributos.

Um nó de entrada tem um número de terminais de saída associados a ele, mas em geral não tem nenhum terminal de entrada. Utilize o método createOutputTerminal para incluir terminais de saída a um nó quando o nó é instanciado. Por exemplo, para criar um nó com três terminais de saída:

public BasicInputNode() throws MbException
{
	createOutputTerminal ("out");
	createOutputTerminal ("failure");
	createOutputTerminal ("catch");
   setAttribute ("firstParserClassName","myParser");
   attributeVariable  = new String ("none");
}

Declarando o Nome do Nó

É necessário declarar o nome do nó como ele será identificado pelo workbench. Todos os nomes de nós devem terminar com "Node". O nome é declarado utilizando o seguinte método:

public static String getNodeName()
{
   return "BasicInputNode";
}
Se esse método não é declarado, a estrutura de API Java cria um nome de nó padrão utilizando as seguintes regras:
  • O nome da classe é anexado ao nome do pacote.
  • Os pontos são removidos e a primeira letra de cada parte do pacote e do nome da classe é transformada em maiúsculas.
Por exemplo, por padrão o nome de nó "ComIbmPluginsamplesBasicInputNode" é atribuído à seguinte classe:
package com.ibm.pluginsamples;
public class BasicInputNode extends MbInputNode implements MbInputNodeInterface
{
   ...

Declarando Atributos

Os atributos do nó são declarados da mesma forma que propriedades de Java Bean. Você é responsável por escrever métodos getter e setter para os atributos e a estrutura da API infere os nomes dos atributos utilizando as regras de introspecção do Java Bean. Por exemplo, se você declarar os dois métodos seguintes:

private String attributeVariable;

public String getFirstAttribute()
{
  return attributeVariable;
}

publc void setFirstAttribute(String value)
{
  attributeVariable = value;
}

O intermediário inferirá que esse nó tem um atributo chamado firstAttribute. Esse nome é derivado dos nomes dos métodos get ou set, não de nenhum nome de variável de membro de classe interna. Os atributos somente podem ser expostos como cadeias, portanto é preciso converter qualquer tipo numérico para e de cadeias nos métodos get ou set. Por exemplo, o método a seguir define um atributo chamado timeInSeconds:

int seconds;

public String getTimeInSeconds()
{
  return Integer.toString(seconds);
}

public void setTimeInSeconds(String value)
{
  seconds = Integer.parseInt(value);
}

Implementando a Funcionalidade do Nó

Como já foi descrito, o método run é chamado pelo intermediário para criar a mensagem de entrada. Esse método deve fornecer toda a função de processamento para o nó de entrada.

Substituindo os Atributos Padrão do Analisador de Mensagem (Opcional)

Uma implementação de nó de entrada em geral determina que analisador de mensagem analisa inicialmente uma mensagem de entrada. Por exemplo, o nó MQInput primitivo dita que um analisador de MQMD é necessário para analisar o cabeçalho MQMD. Um nó de entrada definido pelo usuário pode selecionar um analisador de cabeçalho ou de mensagem apropriado, e o modo no qual a análise é controlada, pela utilização dos seguintes atributos que são incluídos como padrão e que podem ser substituídos:

rootParserClassName
Define o nome do analisador raiz que analisa os formatos de mensagem suportados pelo nó de entrada definido pelo usuário. Seu padrão é GenericRoot, um analisador raiz fornecido que faz com que o intermediário aloque e encadeie analisadores juntos. É improvável que um nó precise modificar esse valor de atributo.
firstParserClassName
Define o nome do primeiro analisador, naquilo que pode ser uma cadeia de analisadores responsáveis pela análise do fluxo de bits. Seu padrão é XML.
messageDomainProperty
Um atributo opcional que define o nome do analisador de mensagem necessário para analisar a mensagem de entrada. Os valores suportados são os mesmos suportados pelo nó MQInput. (Consulte Nó MQInput para obter informações adicionais sobre o nó MQInput.)
messageSetProperty
Um atributo opcional que define o identificador do conjunto de mensagem, ou o nome do conjunto de mensagem, no campo Message Set, somente se o analisador MRM tiver sido especificado pelo atributo messageDomainProperty.
messageTypeProperty
Um atributo opcional que define o identificador da mensagem no campo MessageType, somente se o analisador MRM tiver sido especificado pelo atributo messageDomainProperty.
messageFormatProperty
Um atributo opcional que define o formato da mensagem no campo Message Format, somente se o analisador MRM tiver sido especificado pelo atributo messageDomainProperty.

Excluindo uma Instância do Nó

Uma instância do nó é excluída quando:
  • Você encerra o intermediário.
  • Você remove o nó ou o fluxo de mensagens contendo o nó e reimplementa a configuração.
Durante a exclusão do nó, o nó pode querer ser informado para que ele possa executar operações de limpeza, como fechar soquetes. Se o nó implementar o método opcional onDelete, este será chamado pelo intermediário imediatamente antes da exclusão do nó.

O método onDelete é implementado da seguinte maneira:

public void onDelete()
{
  // executar limpeza do nó se necessário
}
Informações relacionadas
API de Nó Java Definido Pelo Usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2005 Última Atualização: 04/11/2005
as09950_