Build instructions

Prerequisites

In order to build the Sping ORM module for Castor JDO, you will have the following requirements met on your system:

  • Download and install Maven 2
  • Download and install a Subversion client
  • Download and install Spring

As this project uses Maven 2 for build and deployment, all required compile-time dependencies will automatically be resolved by Maven 2 and deployed into your local Maven 2 repository.

Downloads

July 5th, 2006: I have decided to make available a first release candidate of the Spring ORM implementation for Castor. Please note that in order to be able to test this module, you'll have to download the ? following release candidate of Castor 1.0.2 as well

Spring ORM implementation for Castor JDO - RC1
Castor 1.0.2 RC1

Deployment and use

If you are not using Maven 2 to build the deployment unit of your application (within which you want to use the Spring ORM module for Castor JDO and Castor JDO itself), below is a list of run-time dependencies you will have to meet.

cglib-full-2.0.2.jarCGLIB
commons-logging-1.1.jarJakarta Commons Loggin
jta1.0.1.jarThe JTA API (transactions)
xerces-J_1.4.0.jarXerces XML library

and optionally

log4j-1.2.13.jarLog4J

Building the Spring ORM module

This section describes how to build the Spring module from a command line using Maven 2. Whilst there is support for Maven 2 in various IDEs (including e.g. Eclipse, IDEA, etc.), using the Maven command line seems to be the most adequate least common denominator.

Note: Please note that you will have to download several JARs for SUN APIs like JTA and the Connector API yourself and manually inject these JARs into your Maven 2 repository. For a more complete explanation of the problem, please check here.

This section assumes that you have ckecked out the latest sources from the SVN repsitory for the Spring ORM module for Castor JDO. Instructions for doing so are provided here.

Open a command line on your system, and issue the following commands:

 > mvn jar            
        

Above command will compile the sources and create the distribution JAR in the target directory of the project root.

To create the complete project documentation - in addition to the distribution assembly, please issue ...

 > mvn site            
        

To install the newly created distribution JAR into your local Maven 2 repository, please issue the following command:

 > mvn install            
        

Examples

For examples how to use the Spring ORM module for Castor JDO, please check the following document