Check out the source
Firstly, check the source for Qpid java out of our subversion repository:
https://svn.apache.org/repos/asf/incubator/qpid/trunk/java
Prerequisites
For the broker code you need JDK 1.5 or later. The client code can be run using JDK 1.4.
You'll also need to have ant installed locally.
The ant build scripts
Currently the Qpid java project builds using ant.
The ant build system is set up in a modular way, with a top level build script and template for module builds and then a module level build script which inherits from the template.
So, at the top level there are:
File |
Description |
|---|---|
build.xml |
Top level build file for the project which defines all the build targets |
common.xml |
Common properties used throughout the build system |
module.xml |
Template used by all modules which sets up properties for module builds |
Then, in each module subdirectory there is:
File |
Description |
|---|---|
build-module.xml |
Defines all the module values for template properties |
Build targets
The main build targets you are probably interested in are:
Target |
Description |
|---|---|
build |
Builds all source code for Qpid java |
archive |
Generates all distribution archives for Qpid java |
So, if you just want to compile everything you should run the build target in the top level build.xml file.
If you want to build an installable version of Qpid java, run the archive task from the top level build.xml file.
If you want to compile an individual module, simply run the build target from the appropriate build-module.xml e.g. to compile the broker source, simply run the build target in the java/broker/build-module.xml file.
What next ?
If you want to run your built Qpid package, see our Getting Started Guide for details of how to do that.
If you want to run our tests, you can use the ant test or testreport (produces a useful report) targets.