Chapter 3. Building

3.1. Prerequisites

3.1.1. Java Development Kit (JDK)

You must have one of the following JDKs installed in order to build the project:

  • Sun JDK 1.6.x

  • Sun JDK 1.7.x

Remember to ensure that "javac" and "java" are in your path (or symlinked).

JAVA_HOME=/location/to/javahome
export JAVA_HOME

PATH=$JAVA_HOME/bin:$PATH
export PATH
      

3.1.2. Apache Ant

You must have Apache Ant 1.8.1+ installed on your system.

Remember to ensure that "ant" are in your path (or symlinked).

ANT_HOME=/location/to/anthome
export ANT_HOME

PATH=$ANT_HOME/bin:$PATH
export PATH
      

3.1.3. Apache Ivy

The JBoss JCA project uses Apache Ivy for dependency management.

Apache Ivy is automatically downloaded and included in the development environment, so no additional setup is required.

3.1.4. Subversion

You must have Subversion 1.5+ installed on your system.

Remember to ensure that "svn" are in your path (or symlinked).

3.2. Obtaining the source code

3.2.1. Anonymous SVN access

The anonymous SVN repository is located under:

svn co http://anonsvn.jboss.org/repos/jbossas/projects/jboss-jca/trunk/ jbossjca-trunk
      

3.2.2. Developer SVN access

The developer SVN repository is located under:

svn co https://svn.jboss.org/repos/jbossas/projects/jboss-jca/trunk/ jbossjca-trunk
      

3.2.3. SVN modules

We have the following modules for the project:

  • trunk

    The head of development targeting the next upcoming release.

3.3. Compiling the source code

In order to build the JBoss JCA project you execute:

ant <target>
    

where target is one of

  • jars

    Builds the JAR archives in the distribution.

  • test

    Builds the JAR archives in the distribution and runs all the test cases.

  • docs

    Builds the API documentation for the project.

  • standalone

    Builds the standalone environment using JBoss Microcontainer.

  • sjc

    Builds the standalone environment using JBoss JCA/SJC.

  • release

    Builds a release of the project.

  • clean

    Cleans the project of temporary files.

  • clean-cache

    Cleans the Apache Ivy repository.

See the full list of targets in the main build.xml file.

An example to get the JBoss JCA/SJC built and running:

ant clean sjc
cd target/sjc/bin
./run.sh