Class ReferentialStateManagerImpl

java.lang.Object

org.datanucleus.state.StateManagerImpl

org.datanucleus.state.ReferentialStateManagerImpl

All Implemented Interfaces:

StateManager, DNStateManager<Persistable>

public class ReferentialStateManagerImpl
extends StateManagerImpl

Implementation of a StateManager for use where insertion ordering is important (such as RDBMS). Adds on simple handling to be run after an object is inserted.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	ReferentialStateManagerImpl.FieldContainer	Private class storing the fields to be updated for a StateManager, when it is inserted.

Field Summary

Fields

Modifier and Type	Field	Description
private Map<ReferentialStateManagerImpl, ReferentialStateManagerImpl.FieldContainer>	fieldsToBeUpdatedAfterObjectInsertion	Fields of this object that we must update when notified of the insertion of the related objects.
private List<ReferentialStateManagerImpl>	insertionNotifyList	List of StateManagers that we must notify when we have completed inserting our record.

Fields inherited from class StateManagerImpl

cmd, currFM, dirty, dirtyFields, FLAG_ATTACHING, FLAG_BECOMING_DELETED, FLAG_CHANGING_STATE, FLAG_DELETING, FLAG_DETACHING, FLAG_DISCONNECTING, FLAG_EMBEDDED, FLAG_FLUSHED_NEW, FLAG_FLUSHING, FLAG_INSERTING, FLAG_INSERTING_CALLBACKS, FLAG_LOADINGFPFIELDS, FLAG_MAKING_TRANSIENT, FLAG_NEED_INHERITANCE_VALIDATION, FLAG_POSTINSERT_UPDATE, FLAG_POSTLOAD_PENDING, FLAG_RESETTING_DETACHED_STATE, FLAG_RESTORE_VALUES, FLAG_RETRIEVING_DETACHED_STATE, FLAG_STORING_PC, FLAG_UPDATING_EMBEDDING_FIELDS_WITH_OWNER, FLAG_VALIDATING, flags, HOLLOWFIELDMANAGER, loadedFields, myEC, myFP, myID, myInternalID, myLC, myPC, myVersion, persistenceFlags, preDeleteLoadedFields, savedState, transactionalVersion

Fields inherited from interface DNStateManager

MEMBER_VALUE_STORED_PREFIX, ORIGINAL_FIELD_VALUE_KEY_PREFIX

Constructor Summary

Constructors

Constructor	Description
ReferentialStateManagerImpl(ExecutionContext ec, AbstractClassMetaData cmd)	Constructor for object of specified type managed by the provided ExecutionContext.

Method Summary

Modifier and Type	Method	Description
void	connect(ExecutionContext ec, AbstractClassMetaData cmd)	Method to (re)connect this StateManager to the specified ExecutionContext and object type.
void	disconnect()	Disconnect from the ExecutionContext and persistable object.
(package private) void	insertionCompleted(ReferentialStateManagerImpl op)	Method called by another StateManager when this object has registered that it needs to know when the other object has been inserted.
void	setInsertingCallbacks()	Override the superclass that simply sets the INSERTING_CALLBACKS flag, and call insertion notify list.
void	updateFieldAfterInsert(Object pc, int fieldNumber)	Marks the given field as being required to be updated when the specified object has been inserted.

Methods inherited from class StateManagerImpl

areFieldsLoaded, attach, attach, attachCopy, becomingDeleted, checkInheritance, clearDirtyFlags, clearDirtyFlags, clearFields, clearFieldsByNumbers, clearLoadedFlags, clearNonPrimaryKeyFields, clearSavedFields, containsAssociatedValue, deletePersistent, detach, detachCopy, disconnectClone, enlistInTransaction, evict, evictFromTransaction, flush, getAllFieldsLoaded, getAssociatedValue, getCallbackHandler, getClassMetaData, getDirtyFieldNames, getDirtyFieldNumbers, getDirtyFields, getExecutionContext, getExecutionContextReference, getExternalObjectId, getFetchPlanForClass, getFieldNumbersOfLoadedOrDirtyFields, getInternalObjectId, getLifecycleState, getLoadedFieldNames, getLoadedFieldNumbers, getLoadedFields, getObject, getObjectAsPrintable, getObjectId, getReferencedPC, getStoreManager, getTransactionalObjectId, getTransactionalVersion, getTransactionalVersion, getVersion, getVersion, initialiseForCachedPC, initialiseForDetached, initialiseForEmbedded, initialiseForEmbedded, initialiseForHollow, initialiseForHollowAppId, initialiseForHollowPreConstructed, initialiseForPersistentClean, initialiseForPersistentNew, initialiseForPNewToBeDeleted, initialiseForTransactionalTransient, internalDeletePersistent, isAttaching, isChangingState, isConnected, isDeleted, isDeleted, isDeleting, isDetaching, isDirty, isEmbedded, isFieldLoaded, isFlushedNew, isFlushedToDatastore, isFlushing, isInserting, isLoaded, isLoaded, isNew, isPersistent, isPostLoadPending, isRestoreValues, isStoringPC, isTransactional, isVersionLoaded, isWaitingToBeFlushedToDatastore, loadField, loadFieldFromDatastore, loadFieldsFromDatastore, loadFieldsFromLevel2Cache, loadFieldsInFetchPlan, loadFieldValues, loadSpecifiedFields, loadStoredField, loadUnloadedFields, loadUnloadedFieldsInFetchPlan, loadUnloadedFieldsInFetchPlanAndVersion, loadUnloadedFieldsOfClassInFetchPlan, loadUnloadedRelationFields, locate, log, makeDirty, makeDirty, makeNontransactional, makePersistent, makePersistentTransactionalTransient, makeTransactional, makeTransient, makeTransientForReachability, markAsFlushed, markFieldsAsLoaded, markForInheritanceValidation, markPKFieldsAsLoaded, peekField, postCommit, postStateChange, postWriteField, preBegin, preRollback, preSerialize, preStateChange, preWriteField, providedBooleanField, providedByteField, providedCharField, providedDoubleField, providedFloatField, providedIntField, providedLongField, providedObjectField, providedShortField, providedStringField, provideField, provideField, provideFields, refresh, refreshFieldsInFetchPlan, refreshLoadedFields, registerTransactional, removeAssociatedValue, replaceAllLoadedSCOFieldsWithValues, replaceAllLoadedSCOFieldsWithWrappers, replaceField, replaceField, replaceField, replaceFieldMakeDirty, replaceFields, replaceFields, replaceFieldValue, replaceManagedPC, replaceNonLoadedFields, replaceStateManager, replacingBooleanField, replacingByteField, replacingCharField, replacingDetachedState, replacingDoubleField, replacingFlags, replacingFloatField, replacingIntField, replacingLongField, replacingObjectField, replacingShortField, replacingStateManager, replacingStringField, resetDetachState, restoreFields, retrieve, retrieveDetachState, saveFields, setAssociatedValue, setAttaching, setBooleanField, setByteField, setCharField, setDetaching, setDoubleField, setFloatField, setFlushedNew, setFlushing, setInserting, setIntField, setLongField, setObjectField, setPostLoadPending, setPostStoreNewObjectId, setShortField, setStoringPC, setStringField, setTransactionalVersion, setVersion, storeFieldValue, toString, transitionReadField, transitionWriteField, unloadField, unloadNonFetchPlanFields, unsetStoringPC, updateField, updateLevel2CacheForFields, updateOwnerFieldInEmbeddedField, validate

Methods inherited from class Object

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

Methods inherited from interface StateManager

getBooleanField, getByteField, getCharField, getDoubleField, getFloatField, getIntField, getLongField, getObjectField, getShortField, getStringField

Field Details

insertionNotifyList

private List<ReferentialStateManagerImpl> insertionNotifyList

List of StateManagers that we must notify when we have completed inserting our record.

fieldsToBeUpdatedAfterObjectInsertion

private Map<ReferentialStateManagerImpl, ReferentialStateManagerImpl.FieldContainer> fieldsToBeUpdatedAfterObjectInsertion

Fields of this object that we must update when notified of the insertion of the related objects.

Constructor Details

ReferentialStateManagerImpl

public ReferentialStateManagerImpl(ExecutionContext ec,
 AbstractClassMetaData cmd)

Constructor for object of specified type managed by the provided ExecutionContext.

Parameters:

ec - ExecutionContext

cmd - the metadata for the class.

Method Details

connect

public void connect(ExecutionContext ec,
 AbstractClassMetaData cmd)

Description copied from interface: DNStateManager

Method to (re)connect this StateManager to the specified ExecutionContext and object type.

Specified by:

connect in interface DNStateManager<Persistable>

Overrides:

connect in class StateManagerImpl

Parameters:

ec - ExecutionContext to connect to

cmd - Metadata for the persistable class

disconnect

public void disconnect()

Description copied from class: StateManagerImpl

Disconnect from the ExecutionContext and persistable object.

Specified by:

disconnect in interface DNStateManager<Persistable>

Overrides:

disconnect in class StateManagerImpl

setInsertingCallbacks

public void setInsertingCallbacks()

Override the superclass that simply sets the INSERTING_CALLBACKS flag, and call insertion notify list.

Specified by:

setInsertingCallbacks in interface DNStateManager<Persistable>

Overrides:

setInsertingCallbacks in class StateManagerImpl

updateFieldAfterInsert

public void updateFieldAfterInsert(Object pc,
 int fieldNumber)

Marks the given field as being required to be updated when the specified object has been inserted.

Specified by:

updateFieldAfterInsert in interface DNStateManager<Persistable>

Overrides:

updateFieldAfterInsert in class StateManagerImpl

Parameters:

pc - The Persistable object

fieldNumber - Number of the field.

insertionCompleted

void insertionCompleted(ReferentialStateManagerImpl op)

Method called by another StateManager when this object has registered that it needs to know when the other object has been inserted.

Parameters:

op - StateManager of the other object that has just been inserted