Einen benutzerdefinierten Knoten in Java verpacken

Vor dem Start

Sie müssen über einen benutzerdefinierten Knoten verfügen, der in Java geschrieben ist. Dies kann einer der unter Beispielknotendateien beschriebenen bereitgestellten Beispielknoten oder ein Knoten sein, den Sie selbst mit Hilfe der Anweisungen unter Nachrichtenverarbeitungs- oder Sendeknoten in Java erstellen oder Empfangsknoten in Java erstellen erstellt haben.

Es gibt zwei Möglichkeiten, einen benutzerdefinierten Knoten zu verpacken:
  • PAR
    Ein Plug-in-Archiv (PAR) ist die Implementierungseinheit für benutzerdefinierte Java-Knoten. Das PAR enthält die Klassen benutzerdefinierter Knoten und kann, falls als Abhängigkeiten erforderlich, JAR-Dateien enthalten. Eine PAR-Datei ist eine komprimierte Datei mit der Dateierweiterung .par. Die Verzeichnisstruktur in der Datei .par hat folgendes Format:
    • /classes

      An dieser Stelle werden die Klassen des benutzerdefinierten Knotens abgelegt.

    • /lib

      An dieser Stelle werden JAR-Dateien abgelegt, die vom benutzerdefinierten Knoten verlangt werden. Dieses Verzeichnis ist optional, weil es nicht immer nötig ist, JAR-Dateien einzubeziehen.

    Die folgende Prozedur beschreibt, wie ein Beispiel eines benutzerdefinierten Knotens, parexamplenode, verpackt wird. In diesem Beispiel soll das PAR in par.example.parexamplenode.class enthalten sein, und zwar mit einer Abhängigkeit von einer JAR-Datei dependency.jar.
    1. Erstellen der Verzeichnisstruktur; zum Beispiel
      • /classes/par/example/parexamplenode.class
      • /lib/dep.jar
    2. Aufrufen eines ZIP-Dienstprogramms zum Erzeugen des PARs; zum Beispiel

      jar cvf parexample.par classes lib

    Das PAR sollte im unter Benutzerdefinierte Erweiterung in einer Brokerdomäne installieren spezifizierten LIL-Pfad abgelegt werden.

  • JAR

    Benutzerdefinierte Knoten können zu einem einfachen JAR verpackt werden. Wenn zum Beispiel Ihr Knoten in example/jarexamplenode.class definiert ist, dann erstellen Sie das JAR mit dem Befehl jar cvf jarexample.jar example.

    Die bevorzugte Art, einen benutzerdefinierten Knoten in Java zu verpacken, ist die Verwendung einer PAR-Datei. Der Grund ist, dass dabei alle Abhängigkeiten zusammen mit dem Knoten verpackt werden können und dass jeder Knoten in einem separaten Klassenladeprogramm geladen wird. Informationen zum Klassenladen finden Sie in Klassenladen für benutzerdefinierte Knoten.

Abhängigkeiten bei der Implementierung

Wenn ein benutzerdefinierter Knoten ein externes Paket erfordert, kann dieses auf eine der folgenden Arten implementiert werden:
  • Die externen Pakete können ins Verzeichnis /lib im implementierten PAR aufgenommen werden.
  • Im Fall von externen Paketen, die von mehreren Knoten gemeinsam genutzt werden, können die Pakete in eines der folgenden Verzeichnisse aufgenommen werden:
    • Das Verzeichnis <workpath>/shared-classes/.
    • Die Umgebungsvariable CLASSPATH, wo alle benutzerdefinierten Knoten in der Broker-Installation auf die Pakete zugreifen können.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as24997_