DataNucleus Access Platform
Access Platform
Persistence
DataNucleus : Migration between versions of DataNucleus

DataNucleus 1.0 is developed from the JPOX 1.2 codebase. It provides support for all JPOX features as well as adding on more. All releases are checked regularly against the JDO2 and JPA TCKs, meaning that DataNucleus has reached a level of stability in terms of functionality. Occasionally, due to unknown bugs, or due to new functionality being introduced we need to change some aspects of DataNucleus. As a result sometimes users will have to make some changes to move between versions of DataNucleus. We aim to keep this to a minimum.

Migration from 1.0.0 Milestone3 to 1.0.0 Milestone4

Migrating from DataNucleus 1.0.0 M3 to 1.0.0 M4 will require the following changes.

  • Changes have been made to the internal API for generic JDOQL/JPQL queries so anybody implementing their own datastore plugin should update their query implementation to use this new API.

Anyone using the Level 2 cache is strongly advised to upgrade to this version



Migration from 1.0.0 Milestone2 to 1.0.0 Milestone3

Migrating from DataNucleus 1.0.0 M2 to 1.0.0 M3 will not require any changes.

Anyone using the Level 2 cache is strongly advised to upgrade to this version



Migration from 1.0.0 Milestone1 to 1.0.0 Milestone2

Migrating from DataNucleus 1.0.0 M1 to 1.0.0 M2 will currently the following changes

  • Mappings for java types have been split off into a new extension-point org.datanucleus.java_type . Any existing mappings specify the SCO wrapper or default-persistent, default-fetch-group, default-embedded will need updates
  • Several packages relating to "mapped" datastores are now moved across into the RDBMS plugin from "core"
  • Persistence property renames
    • datanucleus.store.connectionProvider.Name is renamed to datanucleus.rdbms.connectionProviderName
    • datanucleus.connectionProvider.FailOnError is renamed to datanucleus.rdbms.connectionProviderFailOnError
    • datanucleus.datastoreAdapterClassName is renamed to datanucleus.rdbms.datastoreAdapterClassName

Anyone using the JDO JCA Adapter is strongly advised to upgrade to this version



Migration from JPOX 1.2 to DataNucleus Access Platform 1.0

Moving from JPOX 1.2.* to DataNucleus 1.0 will involve the following changes

  • Rename all persistent properties that started with "org.jpox". These should now be prefixed datanucleus
  • Any use of MetaData vendor extensions should now use the vendor name of datanucleus instead of jpox . DataNucleus does actually provide support for jpox vendor extensions but this will be dropped at some point in the future.
  • Rename any use of JPOX classes. These should now be prefixed org.datanucleus In addition, JPOXLogger is now NucleusLogger . JPOXJDOHelper is now NucleusJDOHelper , JPOXJPAHelper is now NucleusJPAHelper