Releases

The current release is Version 0.4. Works for most rails services over XML. Still no JSON support.

Here's some of the old releases:

• Version 0.3 usable for most simple rails services. No json support.
• Version 0.2 not quite usable yet because null fields aren't handled properly (see ticket:17)
• Version 0.1 barely does anything. Mostly don't bother with this one.

Packages in a Release

Each release includes several packages. The binary packages are named something like jactiveresource-0.4-bin.tar.bz2. The binary package includes all of the source needed to compile the jars, but the jars have already been compiled for you. Once you have downloaded and unpacked the package, look in the lib directory and you'll see the jactiveresource jar as well as the jars for all of the dependencies.

The source packages are named something like jactiveresource-0.4-src.tar.bz2, and include all the source code so you can make your own jar.

You can always get the code from the SourceCodeRepository if you want something other than packaged release.

Build

To build from the source, either from a source package or from what you check out of the repository, you will need  Apache Maven. jactiveresource is just a standard maven project, so if you know maven you're good to go. If you don't know maven and want learn, go read  http://www.sonatype.com/products/maven/documentation/book-defguide Maven: The Definitive Guide. Otherwise, here's a few short commands to get you started. Make sure you're connected the first time you do this stuff, because maven will be downloading dependencies and plugins.

To just build a jar and be done, use:

$ mvn package -DskipTests

Now go look in ./target and you'll find a jactiveresource jar file.

See RunningTests to run the unit tests.

To generate the javadocs, type:

$ mvn javadoc:javadoc

The generated files will be located at ./target/site/apidocs.

When you're done, it's easy to clean everything up by running:

$ mvn clean