Blitz Developers Guide

Building Blitz

The build process for Blitz is automated via Ant build scripts. First, ensure that you've installed all the required packages.

Configuration

Edit the following properties in the build.xml file:

Basic build

For the purposes of this section, I assume you've unpacked the distribution in /home/dan/src/jini/space. First let's compile Blitz:

cd /home/dan/src/jini/space

ant clean compile
You can generate javadoc using:
ant javadoc
Which will place the javadoc in docs/javadocs

Creating a distribution

The final steps in producing a Blitz distribution are to create the blitz.jar, blitz-dl.jar and stats.jar files. By convention, building blitz-dl.jar entails including all classes the Blitz proxy code is dependent upon including various classes of the JINI starter kit.

Fortunately, there is an Ant addon task which makes the work of generating the dependencies and building a .jar trivial. The necessary .jar is included in ant_addon and automatically used by the build.xml file (there's no need to install the addon in the Ant lib directory).

Now we can build the download jar, blitz-dl.jar as follows:

cd /home/dan/src/jini/space/

ant dljar

Next up, we create stats.jar which is required to be on the classpath of any client wishing to make use of the StatsAdmin interface.

cd /home/dan/src/jini/space/

ant statsjar

Next we create the dashboard.jar

cd /home/dan/src/jini/space/

ant dashjar

The final step is to create blitz.jar itself:

cd /home/dan/src/jini/space

ant serverjar
All the generated .jar's will be placed in the lib directory.

Reducing the risk of RSI

You can do all the above with one command:
cd /home/dan/src/jini/space/

ant all

Tools

There are several tools available which may prove useful in debugging 'space applications or Blitz itself - see the Tools Section in the Install Guide

Back to Documentation