DataNucleus Access Platform
Access Platform
Persistence
Getting Started

DataNucleus Access Platform implements the JDO and JPA specifications. These specifications define how Java classes can be persisted to a datastore and how they can be queried. Implementations of JDO can persist data to whichever datastores they choose.

What is required?
  1. DataNucleus Access Platform requires a JDK of 1.3 or above. After July 2008 it will require a JDK of 1.5 or above.
  2. The first thing to do is Download DataNucleus Access Platform. Download the bundle that is most appropriate to your needs so, for example, if you are going to be developing for access of RDBMS data download the accessplatform-rdbms zip. If you want instead to just download the individual DataNucleus plugins that make up Access Platform then please refer to the list of dependencies for details of what other packages are required.
  3. You also need a datastore. DataNucleus Access Platform 1.0 supports RDBMS, DB4O, LDAP, Excel documents, NeoDatis ODB, XML and JSON. Please refer to the linked pages for full details of the datastore required.
  4. Depending on what development environment you use, you could also download a DataNucleus plugin for Eclipse or Maven.

That should be enough to get you going. You have the necessary components to start investigating use of DataNucleus.



Starting up

The next thing to do is to learn about JDO and JPA. You need to understand the basic concepts involved. The JDO Overview is one place to start but there is plenty of reading on the internet, starting with the JDO2 or JPA1 specifications of course.

The best thing to do after some reading is to try the JDO Tutorial or the JPA Tutorial. This explains the basic steps of applying JDO/JPA (and DataNucleus) to your own application. The source code from the Tutorial is available for download. Please download it and start up your development environment with the Tutorial classes and files.

Once you have completed the Tutorial you should be ready to start applying DataNucleus to your own application and benefiting from what it offers.