Empaquetado de un nodo Java definido por el usuario

Cómo empaquetar un nodo Java™ definido por el usuario.

Antes de empezar

Debe tener un nodo definido por el usuario escrito en Java. Este nodo puede ser uno de los nodos de ejemplo proporcionados que se describen en Archivos de nodo de ejemplo, o un nodo que haya creado usted mismo utilizando las instrucciones de Creación de un nodo de salida o proceso de mensajes en Java o Creación de un nodo de entrada en Java.

Acerca de esta tarea

Puede empaquetar un nodo definido por el usuario de dos maneras:
  • PAR
    Un archivo PAR (Plug-in Archive) es la unidad de despliegue para nodos Java definidos por el usuario. El PAR contiene las clases del nodo definido por el usuario y, si se necesitan como dependencias, puede contener archivos JAR. Un archivo PAR es un archivo comprimido con una extensión de archivo .par. La estructura de directorios en el archivo .par tiene el formato siguiente:
    • /classes

      Las clases de nodo definido por el usuario se almacenan en esta ubicación.

    • /lib

      Los archivos JAR que necesita el nodo definido por el usuario se almacenan en esta ubicación. Este directorio es opcional porque puede no ser necesario incluir archivos JAR.

    El procedimiento siguiente describe cómo empaquetar un nodo definido por el usuario de ejemplo, parexamplenode. En este ejemplo, el PAR deberá estar dentro de par.example.parexamplenode.class con una dependencia de archivo JAR dependency.jar.
    1. Cree la estructura de directorios; por ejemplo:
      • /classes/par/example/parexamplenode.class
      • /lib/dep.jar
    2. Emita un mandato de compresión de archivos para crear el PAR; por ejemplo:

      jar cvf parexample.par classes lib

    El PAR debe colocarse en la vía de acceso LIL que se especifica en Instalación de archivos de tiempo de ejecución de extensión definidos por el usuario en un nodo de integración.

  • JAR

    Los nodos definidos por el usuario se pueden empaquetar utilizando un simple JAR. Por ejemplo, si su nodo está definido en example/jarexamplenode.class, debe crear el JAR utilizando el mandato jar cvf jarexample.jar example.

    La forma preferida de empaquetar un nodo Java definido por el usuario es utilizar un archivo PAR, porque todas las dependencias se pueden empaquetar con el nodo y cada nodo se carga en un cargador de clases independiente. Para obtener información sobre la carga de clases, consulte Carga de clases de nodo definido por el usuario.

    El JAR debe colocarse en la vía de acceso LIL que se especifica en Instalación de archivos de tiempo de ejecución de extensión definidos por el usuario en un nodo de integración.

Dependencias de despliegue

Acerca de esta tarea

Si un nodo definido por el usuario requiere un paquete externo, el paquete puede desplegarse de una de las siguientes maneras:
  • Pueden añadirse los paquetes externos al directorio /lib en el PAR desplegado.
  • Para paquetes externos que se comparten entre varios tipos de nodo, los paquetes pueden añadirse a una de las siguientes ubicaciones:
    • Uno de los directorios shared-classes. Para obtener más detalles de estos directorios, consulte Cargador de clases compartido Java.
    • La variable de entorno CLASSPATH, donde todos los nodos definidos por el usuario que están en la instalación del nodo de integración pueden acceder a los paquetes