JDO : Usage of DataNucleus within an OSGi environment

DataNucleus jars are OSGi bundles, and as such, can be deployed in an OSGi environment. Being an OSGi environment care must be taken with respect to class-loading. In particular the persistence property datanucleus.primaryClassLoader will need setting. Please refer to the following guide(s) for assistance until a definitive guide can be provided

• Guide to use of DataNucleus with OSGi and Spring dmServer
• Guide to JPOX inside Eclipse RCP
• Guide to JPOX with Spring and Eclipse RCP
• Guide to using Log4J with DataNucleus under OSGi

Some key points around integration with OSGi are as follows :-

• Any dependent jar that is required by DataNucleus needs to be OSGi enabled. By this we mean the jar needs to have the MANIFEST.MF file including ExportPackage for the packages required by DataNucleus. Failure to have this will result in ClassNotFoundException when trying to load its classes.
• Use jdo-api.jar v3.0.1 or later since those are OSGi-enabled
• The Geronimo "jpa" jar that is included in the DataNucleus distribution is OSGi enabled.
• When using DataNucleus in an Eclipse Equinox OSGi environment set the persistence property datanucleus.plugin.pluginRegistryClassName as org.datanucleus.plugin.EclipsePluginRegistry
• When using DataNucleus in other OSGi environments set the persistence property datanucleus.plugin.pluginRegistryClassName to org.datanucleus.plugin.OSGiPluginRegistry