IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

User-defined node class loading

Details the Java™ classes packaging options and loading order precedence for user-defined nodes.

Java user-defined node classes can be packaged and loaded in two ways:

For both packaging mechanisms, if the classloader cannot find a required class within the package it defers to the shared class loader to find the required class. The shared classloader looks in a set of directories on the broker machine and loads any JAR files found. It can be used to install any required JAR files that do not need to be repeatedly deployed, such as client libraries that the Java compute nodes need to use. For more details, see Java shared classloader.

If the required class cannot be found in any of the deployed JAR files, or in the JAR files installed in the shared classes directories, a classloader containing all of the broker supplied classes is checked (for example: this classloader contains the jplugin2.jar), followed by the classpath, and then finally the Java virtual machine (JVM) system classloader.

Two key points must be considered when deciding which of the above mechanisms are used to load a class:

User-defined nodes class loading search paths

User-defined nodes package in a PAR file

The broker uses the following search path to find user-defined node classes:
  1. /classes to locate classes in the deployed PAR file.
  2. /lib to locate any JAR files in the deployed PAR file.
  3. workpath/config/<my_broker_name>/<my_eg_label>/shared-classes to locate any JAR files in the integration server shared-classes directory.
  4. workpath/config/<my_broker_name>/shared-classes to locate any JAR files in the broker shared-classes directory.
  5. workpath/shared-classes/ to locate any JAR files in the top level shared-classes directory.
  6. CLASSPATH environment variable.

User-defined nodes package in a JAR file

The broker uses the following search path to find user-defined node classes:
  1. The deployed JAR file.
  2. workpath/config/<my_broker_name>/<my_eg_label>/shared-classes to locate any JAR files in the integration server shared-classes directory.
  3. workpath/config/<my_broker_name>/shared-classes to locate any JAR files in the broker shared-classes directory.
  4. workpath/shared-classes/ to locate any JAR files in the top level shared-classes directory.

as24996_.htm | Last updated Friday, 21 July 2017