Development
Documentation
Testing
Building DataNucleus with Maven2

DataNucleus can be easily developed using Maven2. You also require JDK1.6 and an SVN client (to download DataNucleus) and an editor. DataNucleus is split into several Maven2 projects and you need these building in a particular order due to dependencies.

local.repository

If building DataNucleus up to and including 2.2 you require the "local.repository" project. The "local.repository" project (in SVN under "platform/local.repository/trunk") provides all jars required by DataNucleus in a Maven1 style repository layout. It is referenced by all DataNucleus projects and so you need this to be present. You don't need to build anything here. Note that if using Maven2 you can refer to this repository specifying the repository layout as legacy . In DataNucleus 3+ this project is not needed and the DataNucleus Maven2 repository contains all necessary jars to build the project.

core

The DataNucleus "core" (in SVN under "platform/core/trunk") project is the root of all DataNucleus projects and is the primary requirement for development. You then simply type (from this project)

mvn clean install

This builds the jar under "target" and installs it into your Maven2 repository.

api.{xxx}

The "api.{xxx}" project (in SVN under "platform/api.{xxx}/trunk") provides persistence using {xxx} API, and builds on top of "core".

To build the "api.{xxx}" using Maven2, you simply type (from this project)

mvn clean install

This builds the jar under "target" and installs it into your Maven2 repository.

store.{xxx}

The "store.{xxx}" project (in SVN under "platform/store.{xxx}/trunk") provides persistence to {xxx} datastores, and builds on top of "core".

To build the "store.{xxx}" using Maven2, you simply type (from this project)

mvn clean install

This builds the jar under "target" and installs it into your Maven2 repository.

enhancer

When building "enhancer" (in SVN under "platform/enhancer/trunk") using Maven2, you need "core" to be built. You then simply type (from this project)

mvn clean install

This builds the jar under "target" and installs it into your Maven2 repository.

Other projects

When building other DataNucleus projects (in SVN under "platform") you follow the same instructions as shown above. That is, download the project, and type (from that project)

mvn clean install

This builds the plugin jar under "target" and installs it into your Maven2 repository.