Requirements

• Maven 3
• Configuration of the JBoss Maven repository in settings.xml

Building

Install the project using the provided settings.xml:

mvn -s build-support/settings.xml install

If you will be building the project often, you'll want to create/modify your own ~/.m2/settings.xml file.

If you're a regular JBoss developer, see:

• http://community.jboss.org/wiki/MavenGettingStarted-Developers

Otherwise, see:

• http://community.jboss.org/wiki/MavenGettingStarted-Users

Once your repositories are configured, simply type:

mvn install

Layout

• build-support/ Contains code related to building TorqueBox, but not involved at runtime.

• components/ Includes all code required at runtime within the AS (Java-centric).

• containers/ Includes outside-of-the-AS container code (Ruby-centric).

• clients/ Includes client API gems (Ruby-centric).

• assemblage/ Contains instructions for building the assembled final deliverables and distributions.

• integration-tests/ Contains a series of Arquillian-based tests against the packaged distribution.

• dist/ Contains the instructions for creating the final binary distributable in .zip format.

Development Tips

If you're actively developing portions of the TorqueBox codebase, it's useful to define $TORQUEBOX_HOME around the directory

./assemblage/assembly/target/stage/torquebox-${VERSION}

And then define JBOSS_HOME and JRUBY_HOME per usual

JBOSS_HOME=$TORQUEBOX_HOME/jboss
JRUBY_HOME=$TORQUEBOX_HOME/jruby

This assembly is created when you execute mvn install from the top-level project.

As you built integration projects using mvn install, they will install themselves into the assembly, if present. Likewise, dependency gems will be installed into the JRuby RubyGems path. Plus, changes to the VFS system will install itself into the JRuby lib directory and gem repository as-needed.

It's like magic.