I always dreamed of composing applications from collaborating independent parts. That's what I think object-oriented programming was supposed to be about.

These libraries are my ongoing effort to achieve that dream.

NOTE: This is a work in progress hence no release versions or downloads are available yet and some APIs are likely to change.

NOTE: Documentation is forthcoming.

NOTE: You need Maven 2.0.9+ to build or (conveniently) use these libraries.

Getting the CodeThe sources for these libraries can be checked out like so:

$ svn checkout http://fluid-tools.googlecode.com/svn/trunk fluid-toolsBuilding the LibrariesOne of the essential Maven plugins in this project makes use of a feature in Apache BCEL that is available from version 5.3, namely Java 5 annotation support. Before you can build these libraries, you will need to check out the BCEL trunk and build it yourself:

$ svn checkout http://svn.apache.org/repos/asf/jakarta/bcel/trunk bcel
$ (cd bcel; mvn install)From then on, you use Maven to build these libraries:

$ cd fluid-tools
$ mvn installDoing that for the first time will take a while as Maven downloads and caches in your file system the various libraries needed to run Maven and to compile Fluid Tools.

As Fluid Tools evolves, there may sometimes be a need to do a clean build. In fact, it is safe to do that every time you update your working copy. To get a clean build, you simply do

$ mvn clean installHowever, a pedantic clean build consists of first clearing the cached libraries from your local Maven repository:

$ cd $HOME/.m2/repository
$ rm -rf org/fluidityNOTE: the commands above assume you are working on a Unix system. Windows users will need to figure out how to achieve the same effects in their individual development enviroment.

TODO:

Deployment modules Move all deploy* classes to the deployment modules Deployer application in executable .war inside package Control centre discovery protocol Heartbeat protocol Service announcement protocol Service activation protocol Monitoring extension API (client) Management extension API (server) Find ways to make modules self-documenting both for human readers and for automated dependency resolution See how to make the build fail when not all dependencies can be resolved from the modules packaged into the application ...