Empacotando um Nó Definido pelo Usuário Java

Antes de começar

Você deve ter um nó definido pelo usuário escrito em Java. Pode ser um dos nós de amostra fornecidos descritos em Arquivos de Nós de Amostra ou um nó que você mesmo criou utilizando as instruções de Criando um Nó de Processamento de Mensagem ou de Saída em Java ou de Criando um Nó Input em Java.

Há duas maneiras de empacotar um nó definido pelo usuário:
  • PAR
    Um PAR (Plug-in Archive) é uma unidade de implementação para nós definidos pelos usuários Java. O PAR contém as classes de nós definidos pelos usuários e, se necessário como dependências, pode conter arquivos JAR. Um arquivo PAR é um arquivo zip com uma extensão do arquivo .par. A estrutura de diretórios no arquivo .par possui o seguinte formato:
    • /classes

      As classes de nós definidos pelos usuários são armazenadas neste local.

    • /lib

      Os arquivos JAR necessários pelo nó definido pelo usuário são armazenados neste local. Esse diretório é opcional porque ele nem sempre será necessário para incluir arquivos JAR.

    O procedimento a seguir descreve como empacotar um nó definido pelo usuário, parexamplenode. Nesse exemplo, o PAR deve ser contido em par.example.parexamplenode.class com uma dependência de arquivo JAR dependency.jar.
    1. Crie a estrutura de diretórios; por exemplo,
      • /classes/par/example/parexamplenode.class
      • /lib/dep.jar
    2. Emita um comando de utilitário ZIP para criar o PAR; por exemplo,

      jar cvf parexample.par classes lib

    O PAR deve ser colocado no caminho LIL especificado em Instalando uma Extensão Definida pelo Usuário em um Domínio de Intermediário.

  • JAR

    Os nós definidos pelo usuário podem ser empacotados utilizando um JAR simples. Por exemplo, se o nó for definido em example/jarexamplenode.class, crie o JAR utilizando o comando jar cvf jarexample.jar example.

    A forma preferida de empacotar um nó definido pelo usuário Java é utilizar um arquivo PAR. Isso acontece porque todas as dependências podem ser empacotadas com o nó e cada nó é carregado em um carregador de classe separado. Consulte Carregamento de Classe do Nó Definido pelo Usuário para obter informações sobre carregamento de classe.

Dependências de Implementação

Se um nó definido pelo usuário requer um pacote externo, isso poderá ser implementado de uma das seguintes maneiras:
  • Os pacotes externos podem ser incluídos no diretório /lib no PAR implementado.
  • Para os pacotes externos compartilhados entre vários tipos de nós, os pacotes podem ser incluídos em um dos seguinte locais:
    • O diretório <workpath>/shared-classes/.
    • A variável de ambiente CLASSPATH, na qual todos os nós definidos pelos usuários que estão na instalação do intermediário podem acessar os pacotes.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as24997_