org.datanucleus

Interface PersistenceNucleusContext

All Superinterfaces:

NucleusContext, StoreNucleusContext

All Known Implementing Classes:

PersistenceNucleusContextImpl

public interface PersistenceNucleusContext
extends StoreNucleusContext

Context for use in the persistence process. Adds on many extra services to the basic+store contexts, for transactions, executionContext, identity handling, object providers, autostart, L2 cache etc.

Method Summary

Modifier and Type	Method and Description
void	addExecutionContextListener(ExecutionContext.LifecycleListener listener) Register a new Listener for ExecutionContext events.
void	addInternalFetchGroup(FetchGroup grp) Method to add a dynamic FetchGroup for use by this OMF.
FetchGroup	createInternalFetchGroup(Class cls, String name) Method to create a new internal fetch group for the class+name.
AutoStartMechanism	getAutoStartMechanism()
ExecutionContext	getExecutionContext(Object owner, Map<String,Object> options) Method to return an ExecutionContext for use in persistence.
ExecutionContext.LifecycleListener[]	getExecutionContextListeners() Object the array of registered ExecutionContext listeners.
ExecutionContextPool	getExecutionContextPool()
FetchGroupManager	getFetchGroupManager() Convenience accessor for the FetchGroupManager.
Set<FetchGroup>	getFetchGroupsWithName(String name) Accessor for the fetch groups for the specified name.
IdentityManager	getIdentityManager() Accessor for a manager for identities.
ImplementationCreator	getImplementationCreator()
FetchGroup	getInternalFetchGroup(Class cls, String name, boolean createIfNotPresent) Accessor for an internal fetch group for the specified class.
ManagementManager	getJMXManager() Accessor for the JMX manager (if required).
JTASyncRegistry	getJtaSyncRegistry()
TransactionManager	getJtaTransactionManager() Accessor for the JTA transaction manager (if using JTA).
Level2Cache	getLevel2Cache()
String	getMultiTenancyId(ExecutionContext ec, AbstractClassMetaData cmd) Accessor for the tenant id for the supplied class and executionContext.
ObjectProviderFactory	getObjectProviderFactory()
FactoryStatistics	getStatistics()
TransactionManager	getTransactionManager()
CallbackHandler	getValidationHandler(ExecutionContext ec) Method to return a handler for validation (JSR303).
boolean	hasLevel2Cache()
boolean	isClassCacheable(AbstractClassMetaData cmd) Convenience method to return if objects of this type are cached for this NucleusContext.
boolean	isClassMultiTenant(AbstractClassMetaData cmd) Accessor for whether the supplied class is multi-tenant (i.e with a tenancy id column).
boolean	isClassWithIdentityCacheable(Object id) Convenience method to return if the supplied id is of an object that is cacheable in the L2 cache.
boolean	isFederated() Return whether we are managing a federated context (i.e a primary StoreManager, with some secondary StoreManager(s)).
boolean	isJcaMode() Accessor for the JCA mode.
void	removeExecutionContextListener(ExecutionContext.LifecycleListener listener) Unregister a Listener from ExecutionContext events.
void	removeInternalFetchGroup(FetchGroup grp) Method to remove a dynamic FetchGroup from use by this OMF.
void	setJcaMode(boolean jca) Mutator for whether we are in JCA mode.
boolean	statisticsEnabled() Accessor for whether statistics gathering is enabled.

Methods inherited from interface org.datanucleus.StoreNucleusContext

getStoreManager

Methods inherited from interface org.datanucleus.NucleusContext

applyDefaultProperties, close, getApiAdapter, getApiName, getClassLoaderResolver, getConfiguration, getMetaDataManager, getPluginManager, getTypeManager, initialise, supportsORMMetaData

Method Detail

getAutoStartMechanism

AutoStartMechanism getAutoStartMechanism()

getObjectProviderFactory

ObjectProviderFactory getObjectProviderFactory()

getExecutionContextPool

ExecutionContextPool getExecutionContextPool()

getExecutionContext

ExecutionContext getExecutionContext(Object owner,
                                     Map<String,Object> options)

Method to return an ExecutionContext for use in persistence.

Parameters:

owner - The owner object for the context. PersistenceManager/EntityManager typically.

options - Any options affecting startup

Returns:

The ExecutionContext

getIdentityManager

IdentityManager getIdentityManager()

Accessor for a manager for identities.

Returns:

The identity manager to use

statisticsEnabled

boolean statisticsEnabled()

Accessor for whether statistics gathering is enabled.

Returns:

Whether the user has enabled statistics or JMX management is enabled

getJMXManager

ManagementManager getJMXManager()

Accessor for the JMX manager (if required). Does nothing if the property "datanucleus.jmxType" is unset.

Returns:

The JMX manager

getStatistics

FactoryStatistics getStatistics()

getImplementationCreator

ImplementationCreator getImplementationCreator()

getTransactionManager

TransactionManager getTransactionManager()

getJtaTransactionManager

TransactionManager getJtaTransactionManager()

Accessor for the JTA transaction manager (if using JTA).

Returns:

the JTA Transaction Manager

getJtaSyncRegistry

JTASyncRegistry getJtaSyncRegistry()

getValidationHandler

CallbackHandler getValidationHandler(ExecutionContext ec)

Method to return a handler for validation (JSR303).

Parameters:

ec - The ExecutionContext that the handler is for.

Returns:

The handler (or null if not supported on this PMF/EMF, or no validator present)

hasLevel2Cache

boolean hasLevel2Cache()

getLevel2Cache

Level2Cache getLevel2Cache()

getExecutionContextListeners

ExecutionContext.LifecycleListener[] getExecutionContextListeners()

Object the array of registered ExecutionContext listeners.

Returns:

array of ExecutionContext.LifecycleListener

addExecutionContextListener

void addExecutionContextListener(ExecutionContext.LifecycleListener listener)

Register a new Listener for ExecutionContext events.

Parameters:

listener - the listener to register

removeExecutionContextListener

void removeExecutionContextListener(ExecutionContext.LifecycleListener listener)

Unregister a Listener from ExecutionContext events.

Parameters:

listener - the listener to unregister

setJcaMode

void setJcaMode(boolean jca)

Mutator for whether we are in JCA mode.

Parameters:

jca - true if using JCA connector

isJcaMode

boolean isJcaMode()

Accessor for the JCA mode.

Returns:

true if using JCA connector.

getFetchGroupManager

FetchGroupManager getFetchGroupManager()

Convenience accessor for the FetchGroupManager. Creates it if not yet existing.

Returns:

The FetchGroupManager

addInternalFetchGroup

void addInternalFetchGroup(FetchGroup grp)

Method to add a dynamic FetchGroup for use by this OMF.

Parameters:

grp - The group

removeInternalFetchGroup

void removeInternalFetchGroup(FetchGroup grp)

Method to remove a dynamic FetchGroup from use by this OMF.

Parameters:

grp - The group

createInternalFetchGroup

FetchGroup createInternalFetchGroup(Class cls,
                                    String name)

Method to create a new internal fetch group for the class+name.

Parameters:

cls - Class that it applies to

name - Name of group

Returns:

The group

getInternalFetchGroup

FetchGroup getInternalFetchGroup(Class cls,
                                 String name,
                                 boolean createIfNotPresent)

Accessor for an internal fetch group for the specified class.

Parameters:

cls - The class

name - Name of the group

createIfNotPresent - Whether to create the fetch group if not present

Returns:

The FetchGroup

Throws:

NucleusUserException - if the class is not persistable

getFetchGroupsWithName

Set<FetchGroup> getFetchGroupsWithName(String name)

Accessor for the fetch groups for the specified name.

Parameters:

name - Name of the group

Returns:

The FetchGroup

isClassWithIdentityCacheable

boolean isClassWithIdentityCacheable(Object id)

Convenience method to return if the supplied id is of an object that is cacheable in the L2 cache.

Parameters:

id - The identity

Returns:

Whether the object it refers to is considered cacheable

isClassCacheable

boolean isClassCacheable(AbstractClassMetaData cmd)

Convenience method to return if objects of this type are cached for this NucleusContext. Uses the "cacheable" flag of the class, and the cache-mode to determine whether to cache

Parameters:

cmd - MetaData for the class

Returns:

Whether it is cacheable

isFederated

boolean isFederated()

Return whether we are managing a federated context (i.e a primary StoreManager, with some secondary StoreManager(s)).

Returns:

Whether this is federated

isClassMultiTenant

boolean isClassMultiTenant(AbstractClassMetaData cmd)

Accessor for whether the supplied class is multi-tenant (i.e with a tenancy id column).

Parameters:

cmd - The class

Returns:

Whether it is multi-tenant

getMultiTenancyId

String getMultiTenancyId(ExecutionContext ec,
                         AbstractClassMetaData cmd)

Accessor for the tenant id for the supplied class and executionContext.

Parameters:

ec - ExecutionContext

cmd - The class

Returns:

The tenant id for this class and context.