Include Jar Files For Custom Encoder

The encoder runtime support is currently packaged as part of the OpenESB v2.0 runtime environment. It is installed as a JBI shared library. At present time the File BC, JMS BC and FTP BC has implemented the support of encoders in a protocol-specific manner. Sometimes it becomes a requirement that the encoders need to be used outside the tight coupling with the BC's. For example, the encoders (e.g. custom encoder) needs to invoked in a standalone Java SE Application, in EJB exposed as a web service, and in POJO SE to allow flexible user action to take place once the encoders fail decoding/encoding, etc.

To invoke the custom encoder in these above scenarios, you need to include a set of jars for the custom encoder into the libraries of your project. There are following two ways to achieve this:

1. Add Encoder NetBeans Modules

Encoder NetBeans modules when installed, automatically register encoder Java SE libraries with NetBeans library manager. They can then be referenced in Java SE or Java EE projects.

• Right click on the "Libraries" folder of your project, and select "Add Library..."

• From the list of "Available Libraries:", select "Encoder-Framework", "Encoder-Custom" (for custom encoder), and "JAXB 2.1".

• Once done, you should see a set of jars included in the "Libraries" list of your project.

2. Add Jar Files Directly

• Locate the encoderlib.jar which may be typically found in $GlassFishESB_INSTALL_ROOT$\glassfish\addons\jbi-components\encoderlib.jar if you have GlassFish ESB installed. The latest encoderlib.jar may be downloaded from http://download.java.net/jbi/binaries/open-jbi-components/main/nightly/latest/ojc/encoderlib.jar. This encoderlib.jar file contains following 6 jar files. Unzip it into a temporary directory.

The list of jar files are:

1. custom.jar
2. customencoder-xsdextension.jar
3. encoderfrmwk-xsdextension.jar
4. encoderfwrt.jar
5. jsr173_api.jar
6. xbean.jar

• Right click on the "Libraries" folder of your project, and select "Add JAR/Folder..."

• Browse to the temporary directory where the 6 jar files are located, and add them into the Libraries of your project.

• You should now see these 6 jars are included in the “Libraries” of your project.

• Any questions/feebacks?

Email: soabi-encoders@sun.com

This page (revision-8) was last changed on 07-Dec-08 13:24 PM, -0800 by LixinTang.
This page was created on 19-Nov-08 14:43 PM, -0800 by LixinTang.

More info...