Building Simple-JTA

Download source code

Download the source code for SimpleJTA from the SimpleJTA website. Extract the source into a directory. This directory will be referred to as the ${simplejta.home} directory in the rest of this document.

Download required software

Following software is required to build SimpleJTA.

J2SE SDK 1.4.2 or above

SimpleJTA requires JDK 1.4.2 or above. Download and install JDK as per instructions provided with the release. We will refer to the installation directory as ${java.home} in the rest of this document.

Ant 1.6.x

Download a binary distribution of Ant 1.6.x.
Install Ant 1.6.x in any directory. This directory will be referred to as ${ant.home} directory in the rest of this document.

Log4J 1.2.8

Download a binary distribution of Log4J. The distribution may contain binaries, source files and documentation. Extract only the Log4J jar file (example: log4j-1.2.8.jar) to ${simplejta.home}/lib directory.

Java Transaction API (JTA) 1.0.1B

Download JTA 1.0.1B (jta-1_0_1B-classes.zip) from Sun Java website by selecting "Class files". Save jta-1_0_1B-classes.zip file in ${simplejta.home}/lib directory.

Java Message Service API (JMS) 1.1

Download JMS version 1.1 API Documentation, Jar and Source bundle (jms-1_1-fr-apidocs.zip) from Sun Java Website. Open the zip file and extract the file named jms.jar to ${simplejta.home}/lib directory.

Build SimpleJTA

Set environment variables

The following environment variables should be set:

JAVA_HOME Should point to ${java.home}
ANT_HOME Should point to ${ant.home}
PATH Should contain $JAVA_HOME/bin and $ANT_HOME/bin in the PATH.

Example (on Windows):

set JAVA_HOME=c:\j2sdk1.4.2_03
set ANT_HOME=c:\apache-ant-1.6.2
set PATH=%JAVA_HOME%\bin;%ANT_HOME%\bin;%PATH%

Run ant

Change current directory to ${simplejta.home} and run ant. It should compile all the Java classes and build the jar file. The jar file will be placed in the ${simplejta.home}/dist directory.

Other ant targets

Additional targets supported by the ant build script are:

javadoc
Generates the Javadoc documentation which is placed in ${simplejta.home}/javadoc directory.
clean
Cleans the ${simplejta.home}/classes and ${simplejta.home}/javadoc directories.
archive
Builds a source archive in ${simplejta.home}/dist

Build properties

Default build properties are defined in the file build.properties in ${simplejta.home} directory. Preview and edit this file if you want to change the default settings, for example, the Log4J jar name.


SourceForge.net Logo