Install JOnAS XDoclet Tasks

The JOnAS WTP Adapter supports the creation and deployment of XDoclet EJB's to a JOnAS server. For this to work correctly the user must download and install XDoclet on their system.


Download and Install XDoclet package.

A set of download and installation instructions for XDoclet can be found at: "XDoclet Download Instructions" The version we tested with was "xdoclet-bin-1.2.3.zip". The download can be installed by extracting the archive contents to a local directory (refered to as XDOCLET_HOME in this help page).



Replace JOnAS XDoclet Tasks in XDoclet package.

The XDoclet distribution contains an "xdoclet-objectweb-module-1.2.3.jar" file which contains the JOnAS specific tasks for the WebDoclet and EjbDoclet builders. Normally this Jar file would be obtained from a JOnAS distribution at "JONAS_ROOT/lib/examples/xdoclet-objectweb-module-1.2.2.jar". We were unable to find a version of this JAR file in either an XDoclet download or a JOnAS distribution that worked correctly. Some were better than others but all had short commings. For this reason we have included a corrected version of this JAR file in this JOnAS WTP Adapter distribution. The user should copy the "xdoclet-objectweb-module-1.2.3.jar" file delivered with the JOnAS WTP Adapter into "XDOCLET_HOME/lib". If you are using a different version of XDoclet then it will be necessary to rename the JAR file delivered with this distribution to match the name of the JAR file being replaced in your XDoclet installation.



Configure XDoclet to Eclipse WTP.

When the user first starts Eclipse with a new workspace, it is necessary to configure to Eclipse where XDoclet was installed on your system.

User Interface:

  Menu:			Window > Preferences
  Select:		XDoclet
  Check:		Enable XDoclet Builder:
  Enter:		XDoclet Home: (or Browse to)
  Enter:		Version: (or Select from pull down box)
  Click:		OK

Description:

This dialog informs WTP about the XDoclet installation on your system.

Description of fields:

Enable XDoclet Builder:
This field causes XDoclet builders to be associated with projects created within the Eclipse workspace.

XDoclet Home:
This field tells WTP where XDoclet is installed on your system. The value entered into this field should match the XDOCLET_HOME mentioned above.

Version:
This field tells WTP what version of XDoclet is installed on your system.