org.datanucleus.api.jpa

Class JPAAdapter

java.lang.Object

org.datanucleus.api.jpa.JPAAdapter

All Implemented Interfaces:

Serializable, org.datanucleus.api.ApiAdapter

public class JPAAdapter
extends Object
implements org.datanucleus.api.ApiAdapter

Adapter for the JPA API, to allow the DataNucleus core runtime to expose multiple APIs to clients.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static Set<String>	defaultPersistentTypeNames

Constructor Summary

Constructors

Constructor and Description
JPAAdapter()

Method Summary

Modifier and Type	Method and Description
boolean	allowDeleteOfNonPersistentObject() Whether the API allows deletion of a non-persistent object.
boolean	allowPersistOfDeletedObject() Whether the API allows (re-)persistence of a deleted object.
boolean	allowReadFieldOfDeletedObject() Whether the API allows reading a field of a deleted object.
boolean	clearLoadedFlagsOnDeleteObject() Whether the API requires clearing of the fields of an object when it is deleted.
void	copyKeyFieldsFromIdToObject(Object pc, org.datanucleus.enhancer.Persistable.ObjectIdFieldConsumer fm, Object id)
RuntimeException	getApiExceptionForNucleusException(org.datanucleus.exceptions.NucleusException ne)
RuntimeException	getDataStoreExceptionForException(String msg, Exception e) Convenience method to return a datastore exception appropriate for this API.
boolean	getDefaultCascadeDeleteForField() Returns the default cascade-delete setting.
boolean	getDefaultCascadePersistForField() Returns the default cascade-persist setting.
boolean	getDefaultCascadeRefreshForField() Returns the default cascade-refresh setting.
boolean	getDefaultCascadeUpdateForField() Returns the default cascade-update setting.
boolean	getDefaultDFGForPersistableField()
Map	getDefaultFactoryProperties() Method to return the default factory properties for this API.
org.datanucleus.ExecutionContext	getExecutionContext(Object obj) Method to return the ExecutionContext (if any) associated with the passed object.
Object	getIdForObject(Object obj) Method to return the object identity for the passed persistable object.
org.datanucleus.state.LifeCycleState	getLifeCycleState(int stateType) Returns the LifeCycleState for the state constant.
String	getName() Accessor for the name of the API.
String	getObjectState(Object pc) Accessor for the object state.
RuntimeException	getUserExceptionForException(String msg, Exception e) Convenience method to return an exception to throw for this API when an unexpected exception occurs.
Object	getVersionForObject(Object obj) Method to return the object version for the passed persistable object.
boolean	isDeleted(Object obj) Accessor for whether the passed object is deleted.
boolean	isDetachable(Object obj) Method to return if the passed object is detachable using this API.
boolean	isDetached(Object obj) Accessor for whether the passed object is detached.
boolean	isDirty(Object obj) Accessor for whether the passed object is dirty.
boolean	isManaged(Object pc) Whether the provided object is currently managed (has an ExecutionContext).
boolean	isMemberDefaultPersistent(Class type)
boolean	isNew(Object obj) Accessor for whether the passed object is new.
boolean	isPersistable(Class cls) Utility method to check if the specified class is of a type that can be persisted for this API.
boolean	isPersistable(Object obj) Method to return if the passed object is persistable using this API.
boolean	isPersistent(Object obj) Accessor for whether the passed object is persistent.
boolean	isTransactional(Object obj) Accessor for whether the passed object is transactional.
boolean	isValidPrimaryKeyClass(Class pkClass, org.datanucleus.metadata.AbstractClassMetaData cmd, org.datanucleus.ClassLoaderResolver clr, int noOfPkFields, org.datanucleus.metadata.MetaDataManager mmgr) Utility to check if a primary-key class is valid.
void	makeDirty(Object obj, String member)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

defaultPersistentTypeNames

protected static final Set<String> defaultPersistentTypeNames

Constructor Detail

JPAAdapter

public JPAAdapter()

Method Detail

getName

public String getName()

Accessor for the name of the API.

Specified by:

getName in interface org.datanucleus.api.ApiAdapter

Returns:

Name of the API

isMemberDefaultPersistent

public boolean isMemberDefaultPersistent(Class type)

Specified by:

isMemberDefaultPersistent in interface org.datanucleus.api.ApiAdapter

isManaged

public boolean isManaged(Object pc)

Whether the provided object is currently managed (has an ExecutionContext).

Specified by:

isManaged in interface org.datanucleus.api.ApiAdapter

Returns:

Whether it is managed

getExecutionContext

public org.datanucleus.ExecutionContext getExecutionContext(Object obj)

Method to return the ExecutionContext (if any) associated with the passed object. Supports persistable objects, and EntityManager.

Specified by:

getExecutionContext in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

The ExecutionContext

getLifeCycleState

public org.datanucleus.state.LifeCycleState getLifeCycleState(int stateType)

Returns the LifeCycleState for the state constant.

Specified by:

getLifeCycleState in interface org.datanucleus.api.ApiAdapter

Parameters:

stateType - the type as integer

Returns:

the type as LifeCycleState object

isPersistent

public boolean isPersistent(Object obj)

Accessor for whether the passed object is persistent.

Specified by:

isPersistent in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is persistent

isNew

public boolean isNew(Object obj)

Accessor for whether the passed object is new.

Specified by:

isNew in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is new

isDirty

public boolean isDirty(Object obj)

Accessor for whether the passed object is dirty.

Specified by:

isDirty in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is dirty

isDeleted

public boolean isDeleted(Object obj)

Accessor for whether the passed object is deleted.

Specified by:

isDeleted in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is deleted

isDetached

public boolean isDetached(Object obj)

Accessor for whether the passed object is detached.

Specified by:

isDetached in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is detached

isTransactional

public boolean isTransactional(Object obj)

Accessor for whether the passed object is transactional.

Specified by:

isTransactional in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is transactional

isPersistable

public boolean isPersistable(Object obj)

Method to return if the passed object is persistable using this API.

Specified by:

isPersistable in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is persistable

isPersistable

public boolean isPersistable(Class cls)

Utility method to check if the specified class is of a type that can be persisted for this API.

Specified by:

isPersistable in interface org.datanucleus.api.ApiAdapter

Parameters:

cls - The class to check

Returns:

Whether the class is persistable

isDetachable

public boolean isDetachable(Object obj)

Method to return if the passed object is detachable using this API. Returns whether the object is an instance of Detachable.

Specified by:

isDetachable in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

Whether it is detachable

getObjectState

public String getObjectState(Object pc)

Accessor for the object state.

Specified by:

getObjectState in interface org.datanucleus.api.ApiAdapter

Parameters:

pc - Object

Returns:

The state ("persistent-clean", "detached-dirty" etc)

makeDirty

public void makeDirty(Object obj,
                      String member)

Specified by:

makeDirty in interface org.datanucleus.api.ApiAdapter

getIdForObject

public Object getIdForObject(Object obj)

Method to return the object identity for the passed persistable object. Returns null if it is not persistable, or has no identity.

Specified by:

getIdForObject in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

The identity

getVersionForObject

public Object getVersionForObject(Object obj)

Method to return the object version for the passed persistable object. Returns null if it is not persistable, or not versioned.

Specified by:

getVersionForObject in interface org.datanucleus.api.ApiAdapter

Parameters:

obj - The object

Returns:

The version

isValidPrimaryKeyClass

public boolean isValidPrimaryKeyClass(Class pkClass,
                                      org.datanucleus.metadata.AbstractClassMetaData cmd,
                                      org.datanucleus.ClassLoaderResolver clr,
                                      int noOfPkFields,
                                      org.datanucleus.metadata.MetaDataManager mmgr)

Utility to check if a primary-key class is valid. Will throw a InvalidPrimaryKeyException if it is invalid, otherwise returning true.

Specified by:

isValidPrimaryKeyClass in interface org.datanucleus.api.ApiAdapter

Parameters:

pkClass - The Primary Key class

cmd - AbstractClassMetaData for the Persistable class

clr - the ClassLoaderResolver

noOfPkFields - Number of primary key fields

mmgr - MetaData manager

Returns:

Whether it is valid

allowPersistOfDeletedObject

public boolean allowPersistOfDeletedObject()

Whether the API allows (re-)persistence of a deleted object.

Specified by:

allowPersistOfDeletedObject in interface org.datanucleus.api.ApiAdapter

Returns:

Whether you can call persist on a deleted object

allowDeleteOfNonPersistentObject

public boolean allowDeleteOfNonPersistentObject()

Whether the API allows deletion of a non-persistent object.

Specified by:

allowDeleteOfNonPersistentObject in interface org.datanucleus.api.ApiAdapter

Returns:

Whether you can call delete on an object not yet persisted

allowReadFieldOfDeletedObject

public boolean allowReadFieldOfDeletedObject()

Whether the API allows reading a field of a deleted object.

Specified by:

allowReadFieldOfDeletedObject in interface org.datanucleus.api.ApiAdapter

Returns:

Whether you can read after deleting

clearLoadedFlagsOnDeleteObject

public boolean clearLoadedFlagsOnDeleteObject()

Whether the API requires clearing of the fields of an object when it is deleted.

Specified by:

clearLoadedFlagsOnDeleteObject in interface org.datanucleus.api.ApiAdapter

Returns:

Whether to clear loaded fields at delete

getDefaultCascadePersistForField

public boolean getDefaultCascadePersistForField()

Returns the default cascade-persist setting. JPA defaults to not persisting by reachability.

Specified by:

getDefaultCascadePersistForField in interface org.datanucleus.api.ApiAdapter

Returns:

The default cascade-persist (false)

getDefaultCascadeUpdateForField

public boolean getDefaultCascadeUpdateForField()

Returns the default cascade-update setting. JPA defaults to not updating by reachability.

Specified by:

getDefaultCascadeUpdateForField in interface org.datanucleus.api.ApiAdapter

Returns:

The default cascade-update (false)

getDefaultCascadeDeleteForField

public boolean getDefaultCascadeDeleteForField()

Returns the default cascade-delete setting. JPA defaults to not deleting by reachability.

Specified by:

getDefaultCascadeDeleteForField in interface org.datanucleus.api.ApiAdapter

Returns:

The default cascade-delete (false)

getDefaultCascadeRefreshForField

public boolean getDefaultCascadeRefreshForField()

Returns the default cascade-refresh setting.

Specified by:

getDefaultCascadeRefreshForField in interface org.datanucleus.api.ApiAdapter

Returns:

The default cascade-refresh (false)

getDefaultDFGForPersistableField

public boolean getDefaultDFGForPersistableField()

Specified by:

getDefaultDFGForPersistableField in interface org.datanucleus.api.ApiAdapter

getDefaultFactoryProperties

public Map getDefaultFactoryProperties()

Method to return the default factory properties for this API.

Specified by:

getDefaultFactoryProperties in interface org.datanucleus.api.ApiAdapter

Returns:

The default props

getUserExceptionForException

public RuntimeException getUserExceptionForException(String msg,
                                                     Exception e)

Convenience method to return an exception to throw for this API when an unexpected exception occurs. This is considered a user exception.

Specified by:

getUserExceptionForException in interface org.datanucleus.api.ApiAdapter

Parameters:

msg - The message

e - The cause

Returns:

The JPA exception

getDataStoreExceptionForException

public RuntimeException getDataStoreExceptionForException(String msg,
                                                          Exception e)

Convenience method to return a datastore exception appropriate for this API.

Specified by:

getDataStoreExceptionForException in interface org.datanucleus.api.ApiAdapter

Parameters:

msg - The message

e - Any root cause exception

Returns:

The exception

getApiExceptionForNucleusException

public RuntimeException getApiExceptionForNucleusException(org.datanucleus.exceptions.NucleusException ne)

Specified by:

getApiExceptionForNucleusException in interface org.datanucleus.api.ApiAdapter

copyKeyFieldsFromIdToObject

public void copyKeyFieldsFromIdToObject(Object pc,
                                        org.datanucleus.enhancer.Persistable.ObjectIdFieldConsumer fm,
                                        Object id)

Specified by:

copyKeyFieldsFromIdToObject in interface org.datanucleus.api.ApiAdapter