StateManagerImpl (DataNucleus Core 5.1.13-SNAPSHOT API)

java.lang.Object
- org.datanucleus.state.StateManagerImpl

All Implemented Interfaces:

StateManager, ObjectProvider<Persistable>

Direct Known Subclasses:

ReferentialStateManagerImpl
```
public class StateManagerImpl
extends Object
implements ObjectProvider<Persistable>
```
Implementation of a StateManager, supporting the bytecode enhancement contract of DataNucleus. Implemented here as one StateManager per Object so adds on functionality particular to each object. All Persistable objects will have a StateManager when they have had communication with the ExecutionContext. They will typically always have an identity also. The exception to that is for embedded/serialised objects.
Embedded/Serialised Objects
An object that is being embedded/serialised in an owning object will NOT have an identity unless the object is subject to a makePersistent() call also. When an object is embedded/serialised and a field is changed, the field will NOT be marked as dirty (unless it is also an object in its own right with an identity). When a field is changed any owning objects are updated so that they can update their tables accordingly.
Performance and Memory
StateManagers are very performance-critical, because for each Persistable object made persistent, there will be one StateManager instance, adding up to the total memory footprint of that object. In heap profiling analysis (cerca 2008), StateManagerImpl showed to consume bytes 169 per StateManager by itself and about 500 bytes per StateManager when taking PC-individual child-object (like the OID) referred by the StateManager into account. With small Java objects this can mean a substantial memory overhead and for applications using such small objects can be critical. For this reason the StateManager should always be minimal in memory consumption.

Field Summary

Fields
Modifier and Type	Field and Description
`protected ActivityState`	`activity` state for transitions of activities.
`protected AbstractClassMetaData`	`cmd` the metadata for the class.
`protected FieldManager`	`currFM` Current FieldManager.
`protected boolean`	`dirty` Indicator for whether the persistable instance is dirty.
`protected boolean[]`	`dirtyFields` indicators for which fields are currently dirty in the persistable instance.
`protected static int`	`FLAG_ATTACHING` Flag for `flags` whether we are in the process of attaching the object.
`protected static int`	`FLAG_BECOMING_DELETED`
`protected static int`	`FLAG_CHANGING_STATE`
`protected static int`	`FLAG_DETACHING` Flag for `flags` whether we are in the process of detaching the object.
`protected static int`	`FLAG_DISCONNECTING` Flag for `flags` whether we are in the process of disconnecting the object.
`protected static int`	`FLAG_FLUSHED_NEW` if the persistable object is new and was flushed to the datastore.
`protected static int`	`FLAG_FLUSHING` Flag for `flags` whether we are in the process of flushing changes to the object.
`protected static int`	`FLAG_LOADINGFPFIELDS`
`protected static int`	`FLAG_MAKING_TRANSIENT` Flag for `flags` whether we are in the process of making transient the object.
`protected static int`	`FLAG_NEED_INHERITANCE_VALIDATION` Whether the managed object needs the inheritance level validating before loading fields.
`protected static int`	`FLAG_POSTINSERT_UPDATE`
`protected static int`	`FLAG_POSTLOAD_PENDING`
`protected static int`	`FLAG_RESETTING_DETACHED_STATE` Flag for `flags` whether we are resetting the detached state.
`protected static int`	`FLAG_RESTORE_VALUES` Whether to restore values at StateManager.
`protected static int`	`FLAG_RETRIEVING_DETACHED_STATE` Flag for `flags` whether we are retrieving detached state from the detached object.
`protected static int`	`FLAG_STORING_PC` Flag to signify that we are currently storing the persistable object, so we don't detach it on serialisation.
`protected static int`	`FLAG_UPDATING_EMBEDDING_FIELDS_WITH_OWNER` Flag whether this SM is updating the ownership of its embedded/serialised field(s).
`protected static int`	`FLAG_VALIDATING` Whether we are currently validating the object in the datastore.
`protected int`	`flags` Bit-packed flags for operational settings (packed into "int" for memory benefit).
`protected static SingleTypeFieldManager`	`HOLLOWFIELDMANAGER`
`protected boolean[]`	`loadedFields` indicators for which fields are currently loaded in the persistable instance.
`protected Lock`	`lock` Lock object to synchronise execution when reading/writing fields.
`protected ExecutionContext`	`myEC` The ExecutionContext for this StateManager
`protected FetchPlanForClass`	`myFP` Fetch plan for the class of the managed object.
`protected Object`	`myID` The object identity in the datastore
`protected Object`	`myInternalID` The object identity in the JVM.
`protected LifeCycleState`	`myLC` The actual LifeCycleState for the persistable instance
`protected Persistable`	`myPC` The persistable instance managed by this ObjectProvider.
`protected Object`	`myVersion` Optimistic version, when starting any transaction.
`protected short`	`objectType` The type of the managed object (0 = PC, 1 = embedded PC, 2 = embedded element, 3 = embedded key, 4 = embedded value.
`protected byte`	`persistenceFlags` Flags for state stored with the object.
`protected Persistable`	`savedImage` Image of the Persistable instance when the instance is enlisted in the transaction.
`protected boolean[]`	`savedLoadedFields` Loaded fields of the persistable instance when the instance is enlisted in the transaction.
`protected byte`	`savedPersistenceFlags` Flags of the persistable instance when the instance is enlisted in the transaction.
`protected Object`	`transactionalVersion` Optimistic version, after insert/update but not yet committed (i.e incremented).

Fields inherited from interface org.datanucleus.state.ObjectProvider
EMBEDDED_COLLECTION_ELEMENT_PC, EMBEDDED_MAP_KEY_PC, EMBEDDED_MAP_VALUE_PC, EMBEDDED_PC, ORIGINAL_FIELD_VALUE_KEY_PREFIX, PC

Constructor Summary

Constructors
Constructor and Description
`StateManagerImpl(ExecutionContext ec, AbstractClassMetaData cmd)` Constructor for object of specified type managed by the provided ExecutionContext.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected boolean`	`areFieldsLoaded(int[] fieldNumbers)` Accessor for whether all of the specified field numbers are loaded.
`void`	`attach(boolean embedded)` Method to attach the object managed by this StateManager.
`void`	`attach(Persistable detachedPC)` Method to attach the provided detached object into the managed instance.
`Persistable`	`attachCopy(Persistable detachedPC, boolean embedded)` Method to attach a copy of the detached persistable instance and return the (attached) copy.
`boolean`	`becomingDeleted()` Whether this object is moving to a deleted state.
`void`	`changeActivityState(ActivityState state)` Update the acitvity state.
`void`	`checkInheritance(FieldValues fv)` Deprecated. Dont use this, to be removed
`protected void`	`clearDirtyFlags()` Method to clear all dirty flags on the object.
`protected void`	`clearDirtyFlags(int[] fieldNumbers)` Method to clear all dirty flags on the object.
`void`	`clearFields()` Method to clear all fields of the object.
`protected void`	`clearFieldsByNumbers(int[] fieldNumbers)`
`void`	`clearLoadedFlags()` Method to clear all loaded flags on the object.
`void`	`clearNonPrimaryKeyFields()` Method to clear all fields that are not part of the primary key of the object.
`void`	`clearSavedFields()` Method to clear all saved fields on the object.
`void`	`connect(ExecutionContext ec, AbstractClassMetaData cmd)` Method to (re)connect this provider to the specified ExecutionContext and object type.
`boolean`	`containsAssociatedValue(Object key)`
`void`	`deletePersistent()` Method to delete the object from persistence.
`void`	`detach(FetchPlanState state)` Method to detach this object.
`Persistable`	`detachCopy(FetchPlanState state)` Method to make detached copy of this instance If the object is detachable then the copy will be migrated to DETACHED state, otherwise will migrate the copy to TRANSIENT.
`void`	`disconnect()` Disconnect from the ExecutionContext and persistable object.
`protected boolean`	`disconnectClone(Persistable pc)` Method to disconnect any cloned persistence capable objects from their StateManager.
`void`	`dump(PrintWriter out)` Utility to dump the contents of the StateManager.
`void`	`enlistInTransaction()` Method to enlist the managed object in the current transaction.
`void`	`evict()` Method to change the object state to evicted.
`void`	`evictFromTransaction()` Method to evict the managed object from the current transaction.
`void`	`flush()` Flushes any outstanding changes to the object to the datastore.
`boolean`	`getAllFieldsLoaded()` Returns whether all fields are loaded.
`Object`	`getAssociatedValue(Object key)` Accessor for an associated value stored with this object.
`protected CallbackHandler`	`getCallbackHandler()`
`AbstractClassMetaData`	`getClassMetaData()` Accessor for the ClassMetaData for this object.
`String[]`	`getDirtyFieldNames()` Convenience accessor for the names of the fields that are dirty.
`int[]`	`getDirtyFieldNumbers()` Accessor for the field numbers of all dirty fields.
`boolean[]`	`getDirtyFields()` Creates a copy of the `dirtyFields` bitmap.
`ExecutionContext`	`getExecutionContext()`
`ExecutionContextReference`	`getExecutionContext(Persistable pc)` Accessor for the ExecutionContext that owns this instance.
`Object`	`getExternalObjectId()` Return an object identity that can be used by the user for the managed object.
`protected Object`	`getExternalObjectId(Object obj)` Return an object id that the user can use.
`protected int[]`	`getFieldNumbersOfLoadedOrDirtyFields(boolean[] loadedFields, boolean[] dirtyFields)` Convenience accessor to return the field numbers for the input loaded and dirty field arrays.
`Object`	`getInternalObjectId()` Accessor for the internal object id of the object we are managing.
`LifeCycleState`	`getLifecycleState()` Accessor for the LifeCycleState
`String[]`	`getLoadedFieldNames()` Convenience accessor for the names of the fields that are loaded.
`int[]`	`getLoadedFieldNumbers()` Accessor for the field numbers of all loaded fields in this managed instance.
`boolean[]`	`getLoadedFields()` Accessor for the fields
`Persistable`	`getObject()` The object being persisted, or a virtual object containing properties to be persisted For persistence of (depends on the API/language): - Java objects, the object returned is the actual Java object being persisted - JSON objects, the object returned is an instance of org.json.JSONObject - XML objects, the object returned is an instance of org.w3c.dom.Node Warning: to obtain the type being persisted use getClassMetaData(), otherwise the store will not be able objects from any language
`String`	`getObjectAsPrintable()` Returns a printable form of the managed object.
`Object`	`getObjectId(Persistable pc)` Return the object representing the JDO identity of the calling instance.
`Persistable`	`getReferencedPC()` Accessor for the referenced PC object when we are attaching or detaching.
`StoreManager`	`getStoreManager()`
`Object`	`getTransactionalObjectId(Persistable pc)` Return the object representing the JDO identity of the calling instance.
`Object`	`getTransactionalVersion()` Return the transactional version of the managed object.
`Object`	`getTransactionalVersion(Object pc)` Return the object representing the transactional version of the calling instance.
`Object`	`getVersion()` Method to return the current version of the managed object.
`Object`	`getVersion(Persistable pc)` Return the object representing the version of the calling instance.
`void`	`initialiseForCachedPC(CachedPC<Persistable> cachedPC, Object id)` Initialise the ObjectProvider, assigning the specified id to the object.
`void`	`initialiseForDetached(Persistable pc, Object id, Object version)` Initialises the StateManager to manage a Persistable object in detached state.
`void`	`initialiseForEmbedded(Persistable pc, boolean copyPc)` Initialises a state manager to manage a Persistable instance that will be EMBEDDED/SERIALISED into another Persistable object.
`void`	`initialiseForHollow(Object id, FieldValues fv, Class pcClass)` Initialises a state manager to manage a hollow instance having the given object ID and the given (optional) field values.
`void`	`initialiseForHollowAppId(FieldValues fv, Class pcClass)` Deprecated. Remove use of this and use initialiseForHollow
`void`	`initialiseForHollowPreConstructed(Object id, Persistable pc)` Initialises a state manager to manage the given hollow instance having the given object ID.
`void`	`initialiseForPersistentClean(Object id, Persistable pc)` Initialises a state manager to manage the passed persistent instance having the given object ID.
`void`	`initialiseForPersistentNew(Persistable pc, FieldValues preInsertChanges)` Initialises a state manager to manage a transient instance that is becoming newly persistent.
`void`	`initialiseForPNewToBeDeleted(Persistable pc)` Initialises the StateManager to manage a Persistable object that is not persistent but is about to be deleted.
`void`	`initialiseForTransactionalTransient(Persistable pc)` Initialises a state manager to manage a Transactional Transient instance.
`protected void`	`internalDeletePersistent()` Method to delete the object from the datastore.
`boolean`	`isAttaching()`
`protected boolean`	`isChangingState()`
`boolean`	`isDeleted()` Tests whether this object has been deleted.
`boolean`	`isDeleted(Persistable pc)` Tests whether this object has been deleted.
`boolean`	`isDeleting()` Tests whether this object is in the process of being deleted.
`boolean`	`isDetaching()` Tests whether this object is in the process of being detached.
`boolean`	`isDirty(Persistable pc)` Tests whether this object is dirty.
`boolean`	`isEmbedded()` Convenience accessor for whether this StateManager manages an embedded/serialised object.
`boolean`	`isFieldLoaded(int fieldNumber)` Accessor for whether a field is currently loaded.
`boolean`	`isFlushedNew()` Whether this record has been flushed to the datastore in this transaction (i.e called persist() and is in the datastore now).
`boolean`	`isFlushedToDatastore()` Accessor for whether all changes have been written to the datastore.
`protected boolean`	`isFlushing()`
`boolean`	`isInserting()` Tests whether this object is being inserted.
`boolean`	`isLoaded(int fieldNumber)` Returns the loaded setting for the field of the managed object.
`boolean`	`isLoaded(Persistable pc, int fieldNumber)` Return true if the field is cached in the calling instance; in this implementation we always return true.
`boolean`	`isNew(Persistable pc)` Tests whether this object has been newly made persistent.
`boolean`	`isPersistent(Persistable pc)` Tests whether this object is persistent.
`protected boolean`	`isPostLoadPending()`
`boolean`	`isRestoreValues()` Accessor for whether we are in the process of restoring the values.
`protected boolean`	`isStoringPC()`
`boolean`	`isTransactional(Persistable pc)` Tests whether this object is transactional.
`boolean`	`isVersionLoaded()` Method to return if the version is loaded.
`boolean`	`isWaitingToBeFlushedToDatastore()` Accessor for whether the instance is newly persistent yet hasnt yet been flushed to the datastore.
`void`	`loadField(int fieldNumber)` Convenience method to load the specified field if not loaded.
`void`	`loadFieldFromDatastore(int fieldNumber)` Convenience method to load a field from the datastore.
`protected void`	`loadFieldsFromDatastore(int[] fieldNumbers)` Convenience method to load fields from the datastore.
`protected int[]`	`loadFieldsFromLevel2Cache(int[] fieldNumbers)` Convenience method to retrieve field values from an L2 cached object if they are loaded in that object.
`void`	`loadFieldsInFetchPlan(FetchPlanState state)` Method to load all unloaded fields in the FetchPlan.
`void`	`loadFieldValues(FieldValues fv)` Convenience method to load the passed field values.
`protected void`	`loadSpecifiedFields(int[] fieldNumbers)` Fetch the specified fields from the database.
`void`	`loadUnloadedFields()` Fetch from the database all fields that are not currently loaded regardless of whether they are in the current fetch group or not.
`void`	`loadUnloadedFieldsInFetchPlan()` Fetchs from the database all fields that are not currently loaded and that are in the current fetch group.
`protected void`	`loadUnloadedFieldsInFetchPlanAndVersion()` Fetchs from the database all fields in current fetch plan that are not currently loaded as well as the version.
`void`	`loadUnloadedFieldsOfClassInFetchPlan(FetchPlan fetchPlan)` Fetchs from the database all currently unloaded fields in the actual fetch plan.
`void`	`loadUnloadedRelationFields()` Loads (from the database) all unloaded fields that store relations.
`void`	`locate()` Locate the object in the datastore.
`void`	`makeDirty(int fieldNumber)` Marks the given field dirty.
`void`	`makeDirty(Persistable pc, String fieldName)` Mark the associated persistable field dirty.
`void`	`makeNontransactional()` Method to change the object state to nontransactional.
`void`	`makePersistent()` Method to make the object persistent.
`void`	`makePersistentTransactionalTransient()` Makes Transactional Transient instances persistent.
`void`	`makeTransactional()` Method to change the object state to transactional.
`void`	`makeTransient(FetchPlanState state)` Method to change the object state to transient.
`void`	`markAsFlushed()` Method to notify the object provider that the object has now been flushed to the datastore.
`void`	`markFieldsAsLoaded(int[] fieldNumbers)` Convenience method to mark all fields as "loaded".
`void`	`markForInheritanceValidation()` Mark the state manager as needing to validate the inheritance of the managed object existence before loading fields.
`protected void`	`markPKFieldsAsLoaded()` Convenience method to mark PK fields as loaded (if using app id).
`protected static Object`	`peekField(Object obj, String fieldName)` Utility to take a peek at a field in the persistable object.
`void`	`postCommit(Transaction tx)` This method is invoked just after a commit is performed in a Transaction involving the persistable object managed by this StateManager
`protected void`	`postStateChange()` Method called after a change in state.
`protected void`	`postWriteField(boolean wasDirty)` Method called after the write of a field.
`void`	`preBegin(Transaction tx)` Method invoked just before a transaction starts for the ExecutionContext managing us.
`void`	`preRollback(Transaction tx)` This method is invoked just before a rollback is performed in a Transaction involving the persistable object managed by this StateManager.
`void`	`preSerialize(Persistable pc)` Guarantee that the serializable transactional and persistent fields are loaded into the instance.
`protected void`	`preStateChange()` Method called before a change in state.
`protected boolean`	`preWriteField(int fieldNumber)` Method called before a write of the specified field.
`void`	`providedBooleanField(Persistable ignored, int fieldNumber, boolean currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedByteField(Persistable ignored, int fieldNumber, byte currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedCharField(Persistable ignored, int fieldNumber, char currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedDoubleField(Persistable ignored, int fieldNumber, double currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedFloatField(Persistable ignored, int fieldNumber, float currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedIntField(Persistable ignored, int fieldNumber, int currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedLongField(Persistable ignored, int fieldNumber, long currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedObjectField(Persistable ignored, int fieldNumber, Object currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedShortField(Persistable ignored, int fieldNumber, short currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`void`	`providedStringField(Persistable ignored, int fieldNumber, String currentValue)` This method is called from the associated persistable when its dnProvideFields() method is invoked.
`Object`	`provideField(int fieldNumber)` Method to return the current value of a particular field.
`protected Object`	`provideField(Persistable pc, int fieldNumber)` Method to retrieve the value of a field from the PC object.
`void`	`provideFields(int[] fieldNumbers, FieldManager fm)` Called from the StoreManager after StoreManager.update() is called to obtain updated values from the Persistable associated with this StateManager.
`void`	`refresh()` Method to refresh the object.
`void`	`refreshFieldsInFetchPlan()` Refreshes from the database all fields in fetch plan.
`void`	`refreshLoadedFields()` Refreshes from the database all fields currently loaded.
`void`	`registerTransactional()` Registers the pc class in the cache
`void`	`removeAssociatedValue(Object key)` Method to remove the associated value with the specified key (if it exists).
`void`	`replaceAllLoadedSCOFieldsWithValues()` Method to replace all loaded SCO fields that have wrappers with their value.
`void`	`replaceAllLoadedSCOFieldsWithWrappers()` Method to replace all loaded SCO fields with wrappers.
`void`	`replaceField(int fieldNumber, Object value)` Method to change the value of a particular field and not mark it dirty.
`protected void`	`replaceField(Persistable pc, int fieldNumber, Object value)` Method to change the value of a field in the PC object.
`protected void`	`replaceField(Persistable pc, int fieldNumber, Object value, boolean makeDirty)` Method to change the value of a field in the PC object.
`void`	`replaceFieldMakeDirty(int fieldNumber, Object value)` Method to change the value of a particular field and mark it dirty.
`void`	`replaceFields(int[] fieldNumbers, FieldManager fm)` Called from the StoreManager to refresh data in the Persistable object associated with this StateManager.
`void`	`replaceFields(int[] fieldNumbers, FieldManager fm, boolean replaceWhenDirty)` Called from the StoreManager to refresh data in the Persistable object associated with this StateManager.
`void`	`replaceFieldValue(int fieldNumber, Object newValue)` Convenience method to change the value of a field that is assumed loaded.
`void`	`replaceManagedPC(Persistable pc)` Method that replaces the PC managed by this StateManager to be the supplied object.
`void`	`replaceNonLoadedFields(int[] fieldNumbers, FieldManager fm)` Called from the StoreManager to refresh data in the Persistable object associated with this StateManager.
`protected void`	`replaceStateManager(Persistable pc, StateManager sm)` Utility to update the passed object with the passed StateManager (can be null).
`boolean`	`replacingBooleanField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a boolean field.
`byte`	`replacingByteField(Persistable obj, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a byte field.
`char`	`replacingCharField(Persistable obj, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a char field.
`Object[]`	`replacingDetachedState(Detachable pc, Object[] currentState)` Method to update the "detached state" in the detached object to obtain the "detached state" from the detached object, or to reset it (to null).
`double`	`replacingDoubleField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a double field.
`byte`	`replacingFlags(Persistable pc)` The StateManager uses this method to supply the value of dnFlags to the associated persistable instance.
`float`	`replacingFloatField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a float field.
`int`	`replacingIntField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a int field.
`long`	`replacingLongField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a long field.
`Object`	`replacingObjectField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of an Object field.
`short`	`replacingShortField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a short field.
`StateManager`	`replacingStateManager(Persistable pc, StateManager sm)` Replace the current value of StateManager in the Persistable object.
`String`	`replacingStringField(Persistable ignored, int fieldNumber)` This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a String field.
`void`	`resetDetachState()` Convenience method to reset the detached state in the current object.
`void`	`restoreFields()` Method to restore all fields of the object.
`void`	`retrieve(boolean fgOnly)` Method to retrieve the object.
`void`	`retrieveDetachState(ObjectProvider op)` Convenience method to retrieve the detach state from the passed ObjectProvider's object.
`void`	`saveFields()` Method to save all fields of the object, for use in any rollback.
`void`	`setAssociatedValue(Object key, Object value)` Method to set an associated value stored with this object.
`void`	`setBooleanField(Persistable pc, int fieldNumber, boolean currentValue, boolean newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setByteField(Persistable pc, int fieldNumber, byte currentValue, byte newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setCharField(Persistable pc, int fieldNumber, char currentValue, char newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setDoubleField(Persistable pc, int fieldNumber, double currentValue, double newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setFloatField(Persistable pc, int fieldNumber, float currentValue, float newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setFlushedNew(boolean flag)`
`void`	`setFlushing(boolean flushing)`
`void`	`setIntField(Persistable pc, int fieldNumber, int currentValue, int newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setLongField(Persistable pc, int fieldNumber, long currentValue, long newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setObjectField(Persistable pc, int fieldNumber, Object currentValue, Object newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setPcObjectType(short objType)` Method to set this StateManager as managing an embedded/serialised object.
`void`	`setPostStoreNewObjectId(Object id)` If the id is obtained after inserting the object into the database, set new a new id for persistent classes (for example, increment).
`void`	`setShortField(Persistable pc, int fieldNumber, short currentValue, short newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setStoringPC()` Method to set the storing PC flag.
`void`	`setStringField(Persistable pc, int fieldNumber, String currentValue, String newValue)` This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
`void`	`setTransactionalVersion(Object version)` Sets the value for the version column in a transaction not yet committed
`void`	`setVersion(Object version)` Sets the value for the version column in the datastore
`String`	`toString()`
`protected void`	`transitionReadField(boolean isLoaded)` Method to change the object state to read-field.
`protected void`	`transitionWriteField()` Method to change the object state to write-field.
`void`	`unloadField(String fieldName)` Convenience method to unload a field/property.
`void`	`unloadNonFetchPlanFields()` Method that will unload all fields that are not in the FetchPlan.
`void`	`unsetStoringPC()` Method to unset the storing PC flag.
`protected void`	`updateField(Persistable pc, int fieldNumber, Object value)` Convenience method to perform the update of a field value when a setter is invoked.
`void`	`updateFieldAfterInsert(Object pc, int fieldNumber)` Marks the given field dirty for issuing an update after the insert.
`protected void`	`updateLevel2CacheForFields(int[] fieldNumbers)` Convenience method to update a Level2 cached version of this object if cacheable and has not been modified during this transaction.
`void`	`updateOwnerFieldInEmbeddedField(int fieldNumber, Object value)` Method to update the "owner-field" in an embedded object with the owner object.
`void`	`validate()` Validates whether the persistable instance exists in the datastore.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.datanucleus.enhancement.StateManager
getBooleanField, getByteField, getCharField, getDoubleField, getFloatField, getIntField, getLongField, getObjectField, getShortField, getStringField

- Field Detail
  - HOLLOWFIELDMANAGER
```
protected static final SingleTypeFieldManager HOLLOWFIELDMANAGER
```
  - FLAG_VALIDATING
```
protected static final int FLAG_VALIDATING
```
    Whether we are currently validating the object in the datastore.
    
    See Also:
    
    Constant Field Values
  - FLAG_RESTORE_VALUES
```
protected static final int FLAG_RESTORE_VALUES
```
    Whether to restore values at StateManager. If true, overwrites the restore values at tx level.
    
    See Also:
    
    Constant Field Values
  - FLAG_STORING_PC
```
protected static final int FLAG_STORING_PC
```
    Flag to signify that we are currently storing the persistable object, so we don't detach it on serialisation.
    
    See Also:
    
    Constant Field Values
  - FLAG_NEED_INHERITANCE_VALIDATION
```
protected static final int FLAG_NEED_INHERITANCE_VALIDATION
```
    Whether the managed object needs the inheritance level validating before loading fields.
    
    See Also:
    
    Constant Field Values
  - FLAG_POSTINSERT_UPDATE
```
protected static final int FLAG_POSTINSERT_UPDATE
```
    See Also:
    
    Constant Field Values
  - FLAG_LOADINGFPFIELDS
```
protected static final int FLAG_LOADINGFPFIELDS
```
    See Also:
    
    Constant Field Values
  - FLAG_POSTLOAD_PENDING
```
protected static final int FLAG_POSTLOAD_PENDING
```
    See Also:
    
    Constant Field Values
  - FLAG_CHANGING_STATE
```
protected static final int FLAG_CHANGING_STATE
```
    See Also:
    
    Constant Field Values
  - FLAG_FLUSHED_NEW
```
protected static final int FLAG_FLUSHED_NEW
```
    if the persistable object is new and was flushed to the datastore.
    
    See Also:
    
    Constant Field Values
  - FLAG_BECOMING_DELETED
```
protected static final int FLAG_BECOMING_DELETED
```
    See Also:
    
    Constant Field Values
  - FLAG_UPDATING_EMBEDDING_FIELDS_WITH_OWNER
```
protected static final int FLAG_UPDATING_EMBEDDING_FIELDS_WITH_OWNER
```
    Flag whether this SM is updating the ownership of its embedded/serialised field(s).
    
    See Also:
    
    Constant Field Values
  - FLAG_RETRIEVING_DETACHED_STATE
```
protected static final int FLAG_RETRIEVING_DETACHED_STATE
```
    Flag for flags whether we are retrieving detached state from the detached object.
    
    See Also:
    
    Constant Field Values
  - FLAG_RESETTING_DETACHED_STATE
```
protected static final int FLAG_RESETTING_DETACHED_STATE
```
    Flag for flags whether we are resetting the detached state.
    
    See Also:
    
    Constant Field Values
  - FLAG_ATTACHING
```
protected static final int FLAG_ATTACHING
```
    Flag for flags whether we are in the process of attaching the object.
    
    See Also:
    
    Constant Field Values
  - FLAG_DETACHING
```
protected static final int FLAG_DETACHING
```
    Flag for flags whether we are in the process of detaching the object.
    
    See Also:
    
    Constant Field Values
  - FLAG_MAKING_TRANSIENT
```
protected static final int FLAG_MAKING_TRANSIENT
```
    Flag for flags whether we are in the process of making transient the object.
    
    See Also:
    
    Constant Field Values
  - FLAG_FLUSHING
```
protected static final int FLAG_FLUSHING
```
    Flag for flags whether we are in the process of flushing changes to the object.
    
    See Also:
    
    Constant Field Values
  - FLAG_DISCONNECTING
```
protected static final int FLAG_DISCONNECTING
```
    Flag for flags whether we are in the process of disconnecting the object.
    
    See Also:
    
    Constant Field Values
  - myPC
```
protected Persistable myPC
```
    The persistable instance managed by this ObjectProvider.
  - flags
```
protected int flags
```
    Bit-packed flags for operational settings (packed into "int" for memory benefit).
  - myEC
```
protected ExecutionContext myEC
```
    The ExecutionContext for this StateManager
  - cmd
```
protected AbstractClassMetaData cmd
```
    the metadata for the class.
  - myInternalID
```
protected Object myInternalID
```
    The object identity in the JVM. Will be "myID" (if set) or otherwise a temporary id based on this StateManager.
  - myID
```
protected Object myID
```
    The object identity in the datastore
  - myLC
```
protected LifeCycleState myLC
```
    The actual LifeCycleState for the persistable instance
  - myVersion
```
protected Object myVersion
```
    Optimistic version, when starting any transaction.
  - transactionalVersion
```
protected Object transactionalVersion
```
    Optimistic version, after insert/update but not yet committed (i.e incremented).
  - persistenceFlags
```
protected byte persistenceFlags
```
    Flags for state stored with the object. Maps onto org.datanucleus.enhancement.Persistable "dnFlags".
  - myFP
```
protected FetchPlanForClass myFP
```
    Fetch plan for the class of the managed object.
  - dirty
```
protected boolean dirty
```
    Indicator for whether the persistable instance is dirty. Note that "dirty" in this case is not equated to being in the P_DIRTY state. The P_DIRTY state means that at least one field in the object has been written by the user during the current transaction, whereas for this parameter, a field is "dirty" if it's been written by the user but not yet updated in the data store. The difference is, it's possible for an object's state to be P_DIRTY, yet have no "dirty" fields because flush() has been called at least once during the transaction.
  - dirtyFields
```
protected boolean[] dirtyFields
```
    indicators for which fields are currently dirty in the persistable instance.
  - loadedFields
```
protected boolean[] loadedFields
```
    indicators for which fields are currently loaded in the persistable instance.
  - lock
```
protected Lock lock
```
    Lock object to synchronise execution when reading/writing fields.
  - activity
```
protected ActivityState activity
```
    state for transitions of activities.
  - currFM
```
protected FieldManager currFM
```
    Current FieldManager.
  - objectType
```
protected short objectType
```
    The type of the managed object (0 = PC, 1 = embedded PC, 2 = embedded element, 3 = embedded key, 4 = embedded value.
  - savedPersistenceFlags
```
protected byte savedPersistenceFlags
```
    Flags of the persistable instance when the instance is enlisted in the transaction.
  - savedLoadedFields
```
protected boolean[] savedLoadedFields
```
    Loaded fields of the persistable instance when the instance is enlisted in the transaction.
  - savedImage
```
protected Persistable savedImage
```
    Image of the Persistable instance when the instance is enlisted in the transaction.
- Constructor Detail
  - StateManagerImpl
```
public StateManagerImpl(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 Detail
  - connect
```
public void connect(ExecutionContext ec,
                    AbstractClassMetaData cmd)
```
    Description copied from interface: ObjectProvider
    
    Method to (re)connect this provider to the specified ExecutionContext and object type.
    
    Specified by:
    
    connect in interface ObjectProvider<Persistable>
    
    Parameters:
    
    ec - ExecutionContext to connect to
    
    cmd - Metadata for this class
  - disconnect
```
public void disconnect()
```
    Disconnect from the ExecutionContext and persistable object.
    
    Specified by:
    
    disconnect in interface ObjectProvider<Persistable>
  - initialiseForHollow
```
public void initialiseForHollow(Object id,
                                FieldValues fv,
                                Class pcClass)
```
    Initialises a state manager to manage a hollow instance having the given object ID and the given (optional) field values. This constructor is used for creating new instances of existing persistent objects, and consequently shouldn't be used when the StoreManager controls the creation of such objects (such as in an ODBMS).
    
    Specified by:
    
    initialiseForHollow in interface ObjectProvider<Persistable>
    
    Parameters:
    
    id - the JDO identity of the object.
    
    fv - the initial field values of the object (optional)
    
    pcClass - Class of the object that this will manage the state for
  - initialiseForHollowPreConstructed
```
public void initialiseForHollowPreConstructed(Object id,
                                              Persistable pc)
```
    Initialises a state manager to manage the given hollow instance having the given object ID. Unlike the initialiseForHollow(java.lang.Object, org.datanucleus.store.FieldValues, java.lang.Class) method, this method does not create a new instance and instead takes a pre-constructed instance (such as from an ODBMS).
    
    Specified by:
    
    initialiseForHollowPreConstructed in interface ObjectProvider<Persistable>
    
    Parameters:
    
    id - the identity of the object.
    
    pc - the object to be managed.
  - initialiseForPersistentClean
```
public void initialiseForPersistentClean(Object id,
                                         Persistable pc)
```
    Initialises a state manager to manage the passed persistent instance having the given object ID. Used where we have retrieved a PC object from a datastore directly (not field-by-field), for example on an object datastore. This initialiser will not add StateManagers to all related PCs. This must be done by any calling process. This simply adds the StateManager to the specified object and records the id, setting all fields of the object as loaded.
    
    Specified by:
    
    initialiseForPersistentClean in interface ObjectProvider<Persistable>
    
    Parameters:
    
    id - the identity of the object.
    
    pc - The object to be managed
  - initialiseForEmbedded
```
public void initialiseForEmbedded(Persistable pc,
                                  boolean copyPc)
```
    Initialises a state manager to manage a Persistable instance that will be EMBEDDED/SERIALISED into another Persistable object. The instance will not be assigned an identity in the process since it is a SCO.
    
    Specified by:
    
    initialiseForEmbedded in interface ObjectProvider<Persistable>
    
    Parameters:
    
    pc - The Persistable to manage (see copyPc also)
    
    copyPc - Whether the SM should manage a copy of the passed PC or that one
  - initialiseForPersistentNew
```
public void initialiseForPersistentNew(Persistable pc,
                                       FieldValues preInsertChanges)
```
    Initialises a state manager to manage a transient instance that is becoming newly persistent. A new object ID for the instance is obtained from the store manager and the object is inserted in the data store.
    This constructor is used for assigning state managers to existing instances that are transitioning to a persistent state.
    
    Specified by:
    
    initialiseForPersistentNew in interface ObjectProvider<Persistable>
    
    Parameters:
    
    pc - the instance being make persistent.
    
    preInsertChanges - Any changes to make before inserting
  - initialiseForTransactionalTransient
```
public void initialiseForTransactionalTransient(Persistable pc)
```
    Initialises a state manager to manage a Transactional Transient instance. A new object ID for the instance is obtained from the store manager and the object is inserted in the data store.
    This constructor is used for assigning state managers to Transient instances that are transitioning to a transient clean state.
    
    Specified by:
    
    initialiseForTransactionalTransient in interface ObjectProvider<Persistable>
    
    Parameters:
    
    pc - the instance being make persistent.
  - initialiseForDetached
```
public void initialiseForDetached(Persistable pc,
                                  Object id,
                                  Object version)
```
    Initialises the StateManager to manage a Persistable object in detached state.
    
    Specified by:
    
    initialiseForDetached in interface ObjectProvider<Persistable>
    
    Parameters:
    
    pc - the detach object.
    
    id - the identity of the object.
    
    version - the detached version
  - initialiseForPNewToBeDeleted
```
public void initialiseForPNewToBeDeleted(Persistable pc)
```
    Initialises the StateManager to manage a Persistable object that is not persistent but is about to be deleted.
    
    Specified by:
    
    initialiseForPNewToBeDeleted in interface ObjectProvider<Persistable>
    
    Parameters:
    
    pc - the object to delete
  - initialiseForCachedPC
```
public void initialiseForCachedPC(CachedPC<Persistable> cachedPC,
                                  Object id)
```
    Initialise the ObjectProvider, assigning the specified id to the object. This is used when getting objects out of the L2 Cache, where they have no ObjectProvider assigned, and returning them as associated with a particular ExecutionContext.
    
    Specified by:
    
    initialiseForCachedPC in interface ObjectProvider<Persistable>
    
    Parameters:
    
    cachedPC - The cached PC object
    
    id - Id to assign to the Persistable object
  - getClassMetaData
```
public AbstractClassMetaData getClassMetaData()
```
    Description copied from interface: ObjectProvider
    
    Accessor for the ClassMetaData for this object.
    
    Specified by:
    
    getClassMetaData in interface ObjectProvider<Persistable>
    
    Returns:
    
    The ClassMetaData.
  - getExecutionContext
```
public ExecutionContext getExecutionContext()
```
    Specified by:
    
    getExecutionContext in interface ObjectProvider<Persistable>
  - getStoreManager
```
public StoreManager getStoreManager()
```
    Specified by:
    
    getStoreManager in interface ObjectProvider<Persistable>
  - getLifecycleState
```
public LifeCycleState getLifecycleState()
```
    Description copied from interface: ObjectProvider
    
    Accessor for the LifeCycleState
    
    Specified by:
    
    getLifecycleState in interface ObjectProvider<Persistable>
    
    Returns:
    
    the LifeCycleState
  - getCallbackHandler
```
protected CallbackHandler getCallbackHandler()
```
  - getObject
```
public Persistable getObject()
```
    Description copied from interface: ObjectProvider
    
    The object being persisted, or a virtual object containing properties to be persisted For persistence of (depends on the API/language): - Java objects, the object returned is the actual Java object being persisted - JSON objects, the object returned is an instance of org.json.JSONObject - XML objects, the object returned is an instance of org.w3c.dom.Node Warning: to obtain the type being persisted use getClassMetaData(), otherwise the store will not be able objects from any language
    
    Specified by:
    
    getObject in interface ObjectProvider<Persistable>
    
    Returns:
    
    the object being persisted, or a virtual object containing properties to be persisted
  - getObjectAsPrintable
```
public String getObjectAsPrintable()
```
    Description copied from interface: ObjectProvider
    
    Returns a printable form of the managed object. Typically returns Object.toString() form of the managed object.
    
    Specified by:
    
    getObjectAsPrintable in interface ObjectProvider<Persistable>
    
    Returns:
    
    The printable form of the object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - isWaitingToBeFlushedToDatastore
```
public boolean isWaitingToBeFlushedToDatastore()
```
    Accessor for whether the instance is newly persistent yet hasnt yet been flushed to the datastore.
    
    Specified by:
    
    isWaitingToBeFlushedToDatastore in interface ObjectProvider<Persistable>
    
    Returns:
    
    Whether not yet flushed to the datastore
  - isRestoreValues
```
public boolean isRestoreValues()
```
    Accessor for whether we are in the process of restoring the values.
    
    Specified by:
    
    isRestoreValues in interface ObjectProvider<Persistable>
    
    Returns:
    
    Whether we are restoring values
  - isChangingState
```
protected boolean isChangingState()
```
  - isInserting
```
public boolean isInserting()
```
    Description copied from interface: ObjectProvider
    
    Tests whether this object is being inserted.
    
    Specified by:
    
    isInserting in interface ObjectProvider<Persistable>
    
    Returns:
    
    true if this instance is inserting.
  - isDeleting
```
public boolean isDeleting()
```
    Description copied from interface: ObjectProvider
    
    Tests whether this object is in the process of being deleted.
    
    Specified by:
    
    isDeleting in interface ObjectProvider<Persistable>
    
    Returns:
    
    true if this instance is being deleted.
  - markForInheritanceValidation
```
public void markForInheritanceValidation()
```
    Description copied from interface: ObjectProvider
    
    Mark the state manager as needing to validate the inheritance of the managed object existence before loading fields.
    
    Specified by:
    
    markForInheritanceValidation in interface ObjectProvider<Persistable>
  - setTransactionalVersion
```
public void setTransactionalVersion(Object version)
```
    Sets the value for the version column in a transaction not yet committed
    
    Specified by:
    
    setTransactionalVersion in interface ObjectProvider<Persistable>
    
    Parameters:
    
    version - The version
  - getTransactionalVersion
```
public Object getTransactionalVersion(Object pc)
```
    Return the object representing the transactional version of the calling instance.
    
    Parameters:
    
    pc - the calling persistable instance
    
    Returns:
    
    the object representing the version of the calling instance
  - setVersion
```
public void setVersion(Object version)
```
    Sets the value for the version column in the datastore
    
    Specified by:
    
    setVersion in interface ObjectProvider<Persistable>
    
    Parameters:
    
    version - The version
  - setFlushedNew
```
public void setFlushedNew(boolean flag)
```
    Specified by:
    
    setFlushedNew in interface ObjectProvider<Persistable>
  - isFlushedNew
```
public boolean isFlushedNew()
```
    Description copied from interface: ObjectProvider
    
    Whether this record has been flushed to the datastore in this transaction (i.e called persist() and is in the datastore now). If user has called persist() on it yet not yet persisted then returns false.
    
    Specified by:
    
    isFlushedNew in interface ObjectProvider<Persistable>
    
    Returns:
    
    Whether this is flushed new.
  - isFlushedToDatastore
```
public boolean isFlushedToDatastore()
```
    Description copied from interface: ObjectProvider
    
    Accessor for whether all changes have been written to the datastore.
    
    Specified by:
    
    isFlushedToDatastore in interface ObjectProvider<Persistable>
    
    Returns:
    
    Whether the datastore has all changes
  - setFlushing
```
public void setFlushing(boolean flushing)
```
    Specified by:
    
    setFlushing in interface ObjectProvider<Persistable>
  - isFlushing
```
protected boolean isFlushing()
```
  - markAsFlushed
```
public void markAsFlushed()
```
    Description copied from interface: ObjectProvider
    
    Method to notify the object provider that the object has now been flushed to the datastore. This is performed when handling inserts or deletes in a batch external to the ObjectProvider.
    
    Specified by:
    
    markAsFlushed in interface ObjectProvider<Persistable>
  - preStateChange
```
protected void preStateChange()
```
    Method called before a change in state.
  - refresh
```
public void refresh()
```
    Method to refresh the object.
    
    Specified by:
    
    refresh in interface ObjectProvider<Persistable>
  - retrieve
```
public void retrieve(boolean fgOnly)
```
    Method to retrieve the object.
    
    Specified by:
    
    retrieve in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fgOnly - Only load the current fetch group fields
  - makePersistentTransactionalTransient
```
public void makePersistentTransactionalTransient()
```
    Makes Transactional Transient instances persistent.
    
    Specified by:
    
    makePersistentTransactionalTransient in interface ObjectProvider<Persistable>
  - makeNontransactional
```
public void makeNontransactional()
```
    Method to change the object state to nontransactional.
    
    Specified by:
    
    makeNontransactional in interface ObjectProvider<Persistable>
  - transitionReadField
```
protected void transitionReadField(boolean isLoaded)
```
    Method to change the object state to read-field.
    
    Parameters:
    
    isLoaded - if the field was previously loaded
  - transitionWriteField
```
protected void transitionWriteField()
```
    Method to change the object state to write-field.
  - evict
```
public void evict()
```
    Method to change the object state to evicted.
    
    Specified by:
    
    evict in interface ObjectProvider<Persistable>
  - preBegin
```
public void preBegin(Transaction tx)
```
    Method invoked just before a transaction starts for the ExecutionContext managing us.
    
    Specified by:
    
    preBegin in interface ObjectProvider<Persistable>
    
    Parameters:
    
    tx - The transaction
  - postCommit
```
public void postCommit(Transaction tx)
```
    This method is invoked just after a commit is performed in a Transaction involving the persistable object managed by this StateManager
    
    Specified by:
    
    postCommit in interface ObjectProvider<Persistable>
    
    Parameters:
    
    tx - The transaction
  - preRollback
```
public void preRollback(Transaction tx)
```
    This method is invoked just before a rollback is performed in a Transaction involving the persistable object managed by this StateManager.
    
    Specified by:
    
    preRollback in interface ObjectProvider<Persistable>
    
    Parameters:
    
    tx - The transaction
  - internalDeletePersistent
```
protected void internalDeletePersistent()
```
    Method to delete the object from the datastore.
  - locate
```
public void locate()
```
    Locate the object in the datastore.
    
    Specified by:
    
    locate in interface ObjectProvider<Persistable>
    
    Throws:
    
    NucleusObjectNotFoundException - if the object doesnt exist.
  - getReferencedPC
```
public Persistable getReferencedPC()
```
    Accessor for the referenced PC object when we are attaching or detaching. When attaching and this is the detached object this returns the newly attached object. When attaching and this is the newly attached object this returns the detached object. When detaching and this is the newly detached object this returns the attached object. When detaching and this is the attached object this returns the newly detached object.
    
    Specified by:
    
    getReferencedPC in interface ObjectProvider<Persistable>
    
    Returns:
    
    The referenced object (or null).
  - areFieldsLoaded
```
protected boolean areFieldsLoaded(int[] fieldNumbers)
```
    Accessor for whether all of the specified field numbers are loaded.
    
    Parameters:
    
    fieldNumbers - The field numbers to check
    
    Returns:
    
    Whether the specified fields are all loaded.
  - unloadNonFetchPlanFields
```
public void unloadNonFetchPlanFields()
```
    Method that will unload all fields that are not in the FetchPlan. This is typically for use when the instance is being refreshed.
    
    Specified by:
    
    unloadNonFetchPlanFields in interface ObjectProvider<Persistable>
  - markFieldsAsLoaded
```
public void markFieldsAsLoaded(int[] fieldNumbers)
```
    Description copied from interface: ObjectProvider
    
    Convenience method to mark all fields as "loaded". NOTE: This is a convenience mutator only to be used when you know what you are doing. Currently only used by the XML plugin.
    
    Specified by:
    
    markFieldsAsLoaded in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumbers - The field numbers to mark as loaded
  - markPKFieldsAsLoaded
```
protected void markPKFieldsAsLoaded()
```
    Convenience method to mark PK fields as loaded (if using app id).
  - updateLevel2CacheForFields
```
protected void updateLevel2CacheForFields(int[] fieldNumbers)
```
    Convenience method to update a Level2 cached version of this object if cacheable and has not been modified during this transaction.
    
    Parameters:
    
    fieldNumbers - Numbers of fields to update in L2 cached object
  - loadFieldsFromLevel2Cache
```
protected int[] loadFieldsFromLevel2Cache(int[] fieldNumbers)
```
    Convenience method to retrieve field values from an L2 cached object if they are loaded in that object. If the object is not in the L2 cache then just returns, and similarly if the required fields aren't available.
    
    Parameters:
    
    fieldNumbers - Numbers of fields to load from the L2 cache
    
    Returns:
    
    The fields that couldn't be loaded
  - loadFieldsInFetchPlan
```
public void loadFieldsInFetchPlan(FetchPlanState state)
```
    Method to load all unloaded fields in the FetchPlan. Recurses through the FetchPlan objects and loads fields of sub-objects where needed. Used as a precursor to detaching objects at commit since fields can't be loaded during the postCommit phase when the detach actually happens.
    
    Specified by:
    
    loadFieldsInFetchPlan in interface ObjectProvider<Persistable>
    
    Parameters:
    
    state - The FetchPlan state
  - loadFieldFromDatastore
```
public void loadFieldFromDatastore(int fieldNumber)
```
    Convenience method to load a field from the datastore. Used in attaching fields and checking their old values (so we don't want any postLoad method being called). TODO Merge this with one of the loadXXXFields methods.
    
    Specified by:
    
    loadFieldFromDatastore in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - The field number. If fieldNumber is -1 then this means call loadFieldsFromDatastore(null);
  - loadFieldsFromDatastore
```
protected void loadFieldsFromDatastore(int[] fieldNumbers)
```
    Convenience method to load fields from the datastore. Note that if the fieldNumbers is null/empty we still should call the persistence handler since it may mean that the version field needs loading.
    
    Parameters:
    
    fieldNumbers - The field numbers.
  - getFieldNumbersOfLoadedOrDirtyFields
```
protected int[] getFieldNumbersOfLoadedOrDirtyFields(boolean[] loadedFields,
                                                     boolean[] dirtyFields)
```
    Convenience accessor to return the field numbers for the input loaded and dirty field arrays.
    
    Parameters:
    
    loadedFields - Fields that were detached with the object
    
    dirtyFields - Fields that have been modified while detached
    
    Returns:
    
    The field numbers of loaded or dirty fields
  - getDirtyFields
```
public boolean[] getDirtyFields()
```
    Creates a copy of the dirtyFields bitmap.
    
    Specified by:
    
    getDirtyFields in interface ObjectProvider<Persistable>
    
    Returns:
    
    a copy of the dirtyFields bitmap.
  - getDirtyFieldNumbers
```
public int[] getDirtyFieldNumbers()
```
    Accessor for the field numbers of all dirty fields.
    
    Specified by:
    
    getDirtyFieldNumbers in interface ObjectProvider<Persistable>
    
    Returns:
    
    Absolute field numbers of the dirty fields in this instance.
  - getLoadedFields
```
public boolean[] getLoadedFields()
```
    Accessor for the fields
    
    Specified by:
    
    getLoadedFields in interface ObjectProvider<Persistable>
    
    Returns:
    
    boolean array of loaded state in order of absolute field numbers
  - getLoadedFieldNumbers
```
public int[] getLoadedFieldNumbers()
```
    Accessor for the field numbers of all loaded fields in this managed instance.
    
    Specified by:
    
    getLoadedFieldNumbers in interface ObjectProvider<Persistable>
    
    Returns:
    
    Field numbers of all (currently) loaded fields
  - getAllFieldsLoaded
```
public boolean getAllFieldsLoaded()
```
    Returns whether all fields are loaded.
    
    Specified by:
    
    getAllFieldsLoaded in interface ObjectProvider<Persistable>
    
    Returns:
    
    Returns true if all fields are loaded.
  - getDirtyFieldNames
```
public String[] getDirtyFieldNames()
```
    Convenience accessor for the names of the fields that are dirty.
    
    Specified by:
    
    getDirtyFieldNames in interface ObjectProvider<Persistable>
    
    Returns:
    
    Names of the dirty fields
  - getLoadedFieldNames
```
public String[] getLoadedFieldNames()
```
    Convenience accessor for the names of the fields that are loaded.
    
    Specified by:
    
    getLoadedFieldNames in interface ObjectProvider<Persistable>
    
    Returns:
    
    Names of the loaded fields
  - isFieldLoaded
```
public boolean isFieldLoaded(int fieldNumber)
```
    Accessor for whether a field is currently loaded. Just returns the status, unlike "isLoaded" which also loads it if not.
    
    Specified by:
    
    isFieldLoaded in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - The (absolute) field number
    
    Returns:
    
    Whether it is loaded
  - clearFieldsByNumbers
```
protected void clearFieldsByNumbers(int[] fieldNumbers)
```
  - clearDirtyFlags
```
protected void clearDirtyFlags()
```
    Method to clear all dirty flags on the object.
  - clearDirtyFlags
```
protected void clearDirtyFlags(int[] fieldNumbers)
```
    Method to clear all dirty flags on the object.
    
    Parameters:
    
    fieldNumbers - the fields to clear
  - unloadField
```
public void unloadField(String fieldName)
```
    Convenience method to unload a field/property.
    
    Specified by:
    
    unloadField in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldName - Name of the field/property
    
    Throws:
    
    NucleusUserException - if the object managed by this StateManager is embedded
  - isEmbedded
```
public boolean isEmbedded()
```
    Convenience accessor for whether this StateManager manages an embedded/serialised object.
    
    Specified by:
    
    isEmbedded in interface ObjectProvider<Persistable>
    
    Returns:
    
    Whether the managed object is embedded/serialised.
  - setPcObjectType
```
public void setPcObjectType(short objType)
```
    Method to set this StateManager as managing an embedded/serialised object.
    
    Specified by:
    
    setPcObjectType in interface ObjectProvider<Persistable>
    
    Parameters:
    
    objType - The type of object being managed
  - providedBooleanField
```
public void providedBooleanField(Persistable ignored,
                                 int fieldNumber,
                                 boolean currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedBooleanField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedByteField
```
public void providedByteField(Persistable ignored,
                              int fieldNumber,
                              byte currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedByteField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedCharField
```
public void providedCharField(Persistable ignored,
                              int fieldNumber,
                              char currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedCharField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedDoubleField
```
public void providedDoubleField(Persistable ignored,
                                int fieldNumber,
                                double currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedDoubleField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedFloatField
```
public void providedFloatField(Persistable ignored,
                               int fieldNumber,
                               float currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedFloatField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedIntField
```
public void providedIntField(Persistable ignored,
                             int fieldNumber,
                             int currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedIntField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedLongField
```
public void providedLongField(Persistable ignored,
                              int fieldNumber,
                              long currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedLongField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedShortField
```
public void providedShortField(Persistable ignored,
                               int fieldNumber,
                               short currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedShortField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedStringField
```
public void providedStringField(Persistable ignored,
                                int fieldNumber,
                                String currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedStringField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - providedObjectField
```
public void providedObjectField(Persistable ignored,
                                int fieldNumber,
                                Object currentValue)
```
    This method is called from the associated persistable when its dnProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedObjectField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
  - replacingBooleanField
```
public boolean replacingBooleanField(Persistable ignored,
                                     int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a boolean field.
    
    Specified by:
    
    replacingBooleanField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingByteField
```
public byte replacingByteField(Persistable obj,
                               int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a byte field.
    
    Specified by:
    
    replacingByteField in interface StateManager
    
    Parameters:
    
    obj - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingCharField
```
public char replacingCharField(Persistable obj,
                               int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a char field.
    
    Specified by:
    
    replacingCharField in interface StateManager
    
    Parameters:
    
    obj - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingDoubleField
```
public double replacingDoubleField(Persistable ignored,
                                   int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a double field.
    
    Specified by:
    
    replacingDoubleField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingFloatField
```
public float replacingFloatField(Persistable ignored,
                                 int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a float field.
    
    Specified by:
    
    replacingFloatField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingIntField
```
public int replacingIntField(Persistable ignored,
                             int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a int field.
    
    Specified by:
    
    replacingIntField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingLongField
```
public long replacingLongField(Persistable ignored,
                               int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a long field.
    
    Specified by:
    
    replacingLongField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingShortField
```
public short replacingShortField(Persistable ignored,
                                 int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a short field.
    
    Specified by:
    
    replacingShortField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingStringField
```
public String replacingStringField(Persistable ignored,
                                   int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of a String field.
    
    Specified by:
    
    replacingStringField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - replacingObjectField
```
public Object replacingObjectField(Persistable ignored,
                                   int fieldNumber)
```
    This method is invoked by the persistable object's dnReplaceField() method to refresh the value of an Object field.
    
    Specified by:
    
    replacingObjectField in interface StateManager
    
    Parameters:
    
    ignored - the calling persistable instance
    
    fieldNumber - the field number
    
    Returns:
    
    the new value for the field
  - registerTransactional
```
public void registerTransactional()
```
    Registers the pc class in the cache
    
    Specified by:
    
    registerTransactional in interface ObjectProvider<Persistable>
  - setAssociatedValue
```
public void setAssociatedValue(Object key,
                               Object value)
```
    Method to set an associated value stored with this object. This is for a situation such as in ORM where this object can have an "external" foreign-key provided by an owning object (e.g 1-N uni relation and this is the element with no knowledge of the owner, so the associated value is the FK value).
    
    Specified by:
    
    setAssociatedValue in interface ObjectProvider<Persistable>
    
    Parameters:
    
    key - Key for the value
    
    value - The associated value
  - getAssociatedValue
```
public Object getAssociatedValue(Object key)
```
    Accessor for an associated value stored with this object. This is for a situation such as in ORM where this object can have an "external" foreign-key provided by an owning object (e.g 1-N uni relation and this is the element with no knowledge of the owner, so the associated value is the FK value).
    
    Specified by:
    
    getAssociatedValue in interface ObjectProvider<Persistable>
    
    Parameters:
    
    key - Key for the value
    
    Returns:
    
    The associated value
  - removeAssociatedValue
```
public void removeAssociatedValue(Object key)
```
    Description copied from interface: ObjectProvider
    
    Method to remove the associated value with the specified key (if it exists).
    
    Specified by:
    
    removeAssociatedValue in interface ObjectProvider<Persistable>
    
    Parameters:
    
    key - The key
  - containsAssociatedValue
```
public boolean containsAssociatedValue(Object key)
```
  - enlistInTransaction
```
public void enlistInTransaction()
```
    Method to enlist the managed object in the current transaction.
    
    Specified by:
    
    enlistInTransaction in interface ObjectProvider<Persistable>
  - evictFromTransaction
```
public void evictFromTransaction()
```
    Method to evict the managed object from the current transaction.
    
    Specified by:
    
    evictFromTransaction in interface ObjectProvider<Persistable>
  - replaceStateManager
```
protected void replaceStateManager(Persistable pc,
                                   StateManager sm)
```
    Utility to update the passed object with the passed StateManager (can be null).
    
    Parameters:
    
    pc - The object to update
    
    sm - The new state manager
  - replacingStateManager
```
public StateManager replacingStateManager(Persistable pc,
                                          StateManager sm)
```
    Replace the current value of StateManager in the Persistable object.
    This method is called by the Persistable whenever dnReplaceStateManager is called and there is already an owning StateManager. This is a security precaution to ensure that the owning StateManager is the only source of any change to its reference in the Persistable.
    
    Specified by:
    
    replacingStateManager in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    sm - the proposed new value for the StateManager
    
    Returns:
    
    the new value for the StateManager
  - replaceManagedPC
```
public void replaceManagedPC(Persistable pc)
```
    Method that replaces the PC managed by this StateManager to be the supplied object. This is used when we want to get an object for an id and create a Hollow object, and then validate against the datastore. This validation can pull in a new object graph from the datastore (e.g for an ODBMS).
    
    Specified by:
    
    replaceManagedPC in interface ObjectProvider<Persistable>
    
    Parameters:
    
    pc - The persistable to use
  - getExecutionContext
```
public ExecutionContextReference getExecutionContext(Persistable pc)
```
    Accessor for the ExecutionContext that owns this instance.
    
    Specified by:
    
    getExecutionContext in interface StateManager
    
    Parameters:
    
    pc - The Persistable instance
    
    Returns:
    
    The ExecutionContext that owns this instance
  - isDirty
```
public boolean isDirty(Persistable pc)
```
    Tests whether this object is dirty. Instances that have been modified, deleted, or newly made persistent in the current transaction return true. Transient nontransactional instances return false (JDO spec).
    
    Specified by:
    
    isDirty in interface StateManager
    
    Parameters:
    
    pc - the calling persistable instance
    
    Returns:
    
    true if this instance has been modified in current transaction.
    
    See Also:
    
    Persistable.dnMakeDirty(String fieldName)
  - isTransactional
```
public boolean isTransactional(Persistable pc)
```
    Tests whether this object is transactional. Instances that respect transaction boundaries return true. These instances include transient instances made transactional as a result of being the target of a makeTransactional method call; newly made persistent or deleted persistent instances; persistent instances read in data store transactions; and persistent instances modified in optimistic transactions.
    Transient nontransactional instances return false.
    
    Specified by:
    
    isTransactional in interface StateManager
    
    Parameters:
    
    pc - the calling persistable instance
    
    Returns:
    
    true if this instance is transactional.
  - isPersistent
```
public boolean isPersistent(Persistable pc)
```
    Tests whether this object is persistent. Instances whose state is stored in the data store return true. Transient instances return false.
    
    Specified by:
    
    isPersistent in interface StateManager
    
    Parameters:
    
    pc - the calling persistable instance
    
    Returns:
    
    true if this instance is persistent.
  - isNew
```
public boolean isNew(Persistable pc)
```
    Tests whether this object has been newly made persistent. Instances that have been made persistent in the current transaction return true.
    Transient instances return false.
    
    Specified by:
    
    isNew in interface StateManager
    
    Parameters:
    
    pc - the calling persistable instance
    
    Returns:
    
    true if this instance was made persistent in the current transaction.
  - isDeleted
```
public boolean isDeleted()
```
    Description copied from interface: ObjectProvider
    
    Tests whether this object has been deleted. Instances that have been deleted in the current transaction return true. Transient instances return false.
    
    Specified by:
    
    isDeleted in interface ObjectProvider<Persistable>
    
    Returns:
    
    true if this instance was deleted in the current transaction.
  - isDeleted
```
public boolean isDeleted(Persistable pc)
```
    Tests whether this object has been deleted. Instances that have been deleted in the current transaction return true.
    Transient instances return false.
    
    Specified by:
    
    isDeleted in interface StateManager
    
    Parameters:
    
    pc - the calling persistable instance
    
    Returns:
    
    true if this instance was deleted in the current transaction.
  - getVersion
```
public Object getVersion(Persistable pc)
```
    Return the object representing the version of the calling instance.
    
    Specified by:
    
    getVersion in interface StateManager
    
    Parameters:
    
    pc - the calling persistable instance
    
    Returns:
    
    the object representing the version of the calling instance
  - isVersionLoaded
```
public boolean isVersionLoaded()
```
    Method to return if the version is loaded. If the class represented is not versioned then returns true
    
    Specified by:
    
    isVersionLoaded in interface ObjectProvider<Persistable>
    
    Returns:
    
    Whether it is loaded.
  - getVersion
```
public Object getVersion()
```
    Method to return the current version of the managed object.
    
    Specified by:
    
    getVersion in interface ObjectProvider<Persistable>
    
    Returns:
    
    The version
  - getTransactionalVersion
```
public Object getTransactionalVersion()
```
    Return the transactional version of the managed object.
    
    Specified by:
    
    getTransactionalVersion in interface ObjectProvider<Persistable>
    
    Returns:
    
    Version of the managed instance at this point in the transaction
  - clearFields
```
public void clearFields()
```
    Method to clear all fields of the object.
    
    Specified by:
    
    clearFields in interface ObjectProvider<Persistable>
  - clearNonPrimaryKeyFields
```
public void clearNonPrimaryKeyFields()
```
    Method to clear all fields that are not part of the primary key of the object.
    
    Specified by:
    
    clearNonPrimaryKeyFields in interface ObjectProvider<Persistable>
  - clearLoadedFlags
```
public void clearLoadedFlags()
```
    Method to clear all loaded flags on the object. Note that the contract of this method implies, especially for object database backends, that the memory form of the object is outdated. Thus, for features like implicit saving of dirty object subgraphs should be switched off for this PC, even if the object actually looks like being dirty (because it is being changed to null values).
    
    Specified by:
    
    clearLoadedFlags in interface ObjectProvider<Persistable>
  - replacingFlags
```
public byte replacingFlags(Persistable pc)
```
    The StateManager uses this method to supply the value of dnFlags to the associated persistable instance.
    
    Specified by:
    
    replacingFlags in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    Returns:
    
    the value of dnFlags to be stored in the Persistable instance
  - provideField
```
public Object provideField(int fieldNumber)
```
    Method to return the current value of a particular field.
    
    Specified by:
    
    provideField in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - Number of field
    
    Returns:
    
    The value of the field
  - provideField
```
protected Object provideField(Persistable pc,
                              int fieldNumber)
```
    Method to retrieve the value of a field from the PC object. Assumes that it is loaded.
    
    Parameters:
    
    pc - The PC object
    
    fieldNumber - Number of field
    
    Returns:
    
    The value of the field
  - provideFields
```
public void provideFields(int[] fieldNumbers,
                          FieldManager fm)
```
    Called from the StoreManager after StoreManager.update() is called to obtain updated values from the Persistable associated with this StateManager.
    
    Specified by:
    
    provideFields in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumbers - An array of field numbers to be updated by the Store
    
    fm - The updated values are stored in this object. This object is only valid for the duration of this call.
  - setBooleanField
```
public void setBooleanField(Persistable pc,
                            int fieldNumber,
                            boolean currentValue,
                            boolean newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setBooleanField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setByteField
```
public void setByteField(Persistable pc,
                         int fieldNumber,
                         byte currentValue,
                         byte newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setByteField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setCharField
```
public void setCharField(Persistable pc,
                         int fieldNumber,
                         char currentValue,
                         char newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setCharField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setDoubleField
```
public void setDoubleField(Persistable pc,
                           int fieldNumber,
                           double currentValue,
                           double newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setDoubleField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setFloatField
```
public void setFloatField(Persistable pc,
                          int fieldNumber,
                          float currentValue,
                          float newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setFloatField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setIntField
```
public void setIntField(Persistable pc,
                        int fieldNumber,
                        int currentValue,
                        int newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setIntField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setLongField
```
public void setLongField(Persistable pc,
                         int fieldNumber,
                         long currentValue,
                         long newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setLongField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setShortField
```
public void setShortField(Persistable pc,
                          int fieldNumber,
                          short currentValue,
                          short newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setShortField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setStringField
```
public void setStringField(Persistable pc,
                           int fieldNumber,
                           String currentValue,
                           String newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setStringField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - setObjectField
```
public void setObjectField(Persistable pc,
                           int fieldNumber,
                           Object currentValue,
                           Object newValue)
```
    This method is called by the associated Persistable when the corresponding mutator method (setXXX()) is called on the Persistable.
    
    Specified by:
    
    setObjectField in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the field number
    
    currentValue - the current value of the field
    
    newValue - the new value for the field
  - updateField
```
protected void updateField(Persistable pc,
                           int fieldNumber,
                           Object value)
```
    Convenience method to perform the update of a field value when a setter is invoked. Called by setXXXField methods.
    
    Parameters:
    
    pc - The PC object
    
    fieldNumber - The field number
    
    value - The new value
  - replaceField
```
protected void replaceField(Persistable pc,
                            int fieldNumber,
                            Object value)
```
    Method to change the value of a field in the PC object.
    
    Parameters:
    
    pc - The PC object
    
    fieldNumber - Number of field
    
    value - The new value of the field
  - disconnectClone
```
protected boolean disconnectClone(Persistable pc)
```
    Method to disconnect any cloned persistence capable objects from their StateManager.
    
    Parameters:
    
    pc - The Persistable object
    
    Returns:
    
    Whether the object was disconnected.
  - retrieveDetachState
```
public void retrieveDetachState(ObjectProvider op)
```
    Convenience method to retrieve the detach state from the passed ObjectProvider's object.
    
    Specified by:
    
    retrieveDetachState in interface ObjectProvider<Persistable>
    
    Parameters:
    
    op - ObjectProvider
  - resetDetachState
```
public void resetDetachState()
```
    Convenience method to reset the detached state in the current object.
    
    Specified by:
    
    resetDetachState in interface ObjectProvider<Persistable>
  - replacingDetachedState
```
public Object[] replacingDetachedState(Detachable pc,
                                       Object[] currentState)
```
    Method to update the "detached state" in the detached object to obtain the "detached state" from the detached object, or to reset it (to null).
    
    Specified by:
    
    replacingDetachedState in interface StateManager
    
    Parameters:
    
    pc - The Persistable being updated
    
    currentState - The current state values
    
    Returns:
    
    The detached state to assign to the object
  - makeDirty
```
public void makeDirty(int fieldNumber)
```
    Marks the given field dirty.
    
    Specified by:
    
    makeDirty in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - The no of field to mark as dirty.
  - makeDirty
```
public void makeDirty(Persistable pc,
                      String fieldName)
```
    Mark the associated persistable field dirty.
    
    Specified by:
    
    makeDirty in interface StateManager
    
    Parameters:
    
    pc - the calling persistable instance
    
    fieldName - the name of the field
  - getInternalObjectId
```
public Object getInternalObjectId()
```
    Accessor for the internal object id of the object we are managing. This will return the "id" if it has been set, otherwise a temporary id based on this StateManager.
    
    Specified by:
    
    getInternalObjectId in interface ObjectProvider<Persistable>
    
    Returns:
    
    The internal object id
  - getObjectId
```
public Object getObjectId(Persistable pc)
```
    Return the object representing the JDO identity of the calling instance. According to the JDO specification, if the JDO identity is being changed in the current transaction, this method returns the JDO identify as of the beginning of the transaction.
    
    Specified by:
    
    getObjectId in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    Returns:
    
    the object representing the JDO identity of the calling instance
  - getTransactionalObjectId
```
public Object getTransactionalObjectId(Persistable pc)
```
    Return the object representing the JDO identity of the calling instance. If the JDO identity is being changed in the current transaction, this method returns the current identity as changed in the transaction. In this implementation we don't allow change of identity so this is always the same as the result of getObjectId(Persistable).
    
    Specified by:
    
    getTransactionalObjectId in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    Returns:
    
    the object representing the JDO identity of the calling instance
  - setPostStoreNewObjectId
```
public void setPostStoreNewObjectId(Object id)
```
    If the id is obtained after inserting the object into the database, set new a new id for persistent classes (for example, increment).
    
    Specified by:
    
    setPostStoreNewObjectId in interface ObjectProvider<Persistable>
    
    Parameters:
    
    id - the id received from the datastore
  - getExternalObjectId
```
protected Object getExternalObjectId(Object obj)
```
    Return an object id that the user can use.
    
    Parameters:
    
    obj - the Persistable object
    
    Returns:
    
    the object id
  - getExternalObjectId
```
public Object getExternalObjectId()
```
    Return an object identity that can be used by the user for the managed object.
    
    Specified by:
    
    getExternalObjectId in interface ObjectProvider<Persistable>
    
    Returns:
    
    the object id
  - loadFieldValues
```
public void loadFieldValues(FieldValues fv)
```
    Convenience method to load the passed field values. Loads the fields using any required fetch plan and calls dnPostLoad() as appropriate.
    
    Specified by:
    
    loadFieldValues in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fv - Field Values to load (including any fetch plan to use when loading)
  - loadSpecifiedFields
```
protected void loadSpecifiedFields(int[] fieldNumbers)
```
    Fetch the specified fields from the database.
    
    Parameters:
    
    fieldNumbers - the numbers of the field(s) to fetch.
  - loadField
```
public void loadField(int fieldNumber)
```
    Convenience method to load the specified field if not loaded.
    
    Specified by:
    
    loadField in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - Absolute field number
  - loadUnloadedRelationFields
```
public void loadUnloadedRelationFields()
```
    Description copied from interface: ObjectProvider
    
    Loads (from the database) all unloaded fields that store relations.
    
    Specified by:
    
    loadUnloadedRelationFields in interface ObjectProvider<Persistable>
  - loadUnloadedFields
```
public void loadUnloadedFields()
```
    Fetch from the database all fields that are not currently loaded regardless of whether they are in the current fetch group or not. Called by lifecycle transitions.
    
    Specified by:
    
    loadUnloadedFields in interface ObjectProvider<Persistable>
  - loadUnloadedFieldsInFetchPlan
```
public void loadUnloadedFieldsInFetchPlan()
```
    Fetchs from the database all fields that are not currently loaded and that are in the current fetch group. Called by lifecycle transitions.
    
    Specified by:
    
    loadUnloadedFieldsInFetchPlan in interface ObjectProvider<Persistable>
  - loadUnloadedFieldsInFetchPlanAndVersion
```
protected void loadUnloadedFieldsInFetchPlanAndVersion()
```
    Fetchs from the database all fields in current fetch plan that are not currently loaded as well as the version. Called by lifecycle transitions.
  - loadUnloadedFieldsOfClassInFetchPlan
```
public void loadUnloadedFieldsOfClassInFetchPlan(FetchPlan fetchPlan)
```
    Fetchs from the database all currently unloaded fields in the actual fetch plan. Called by life-cycle transitions.
    
    Specified by:
    
    loadUnloadedFieldsOfClassInFetchPlan in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fetchPlan - The FetchPlan
  - refreshFieldsInFetchPlan
```
public void refreshFieldsInFetchPlan()
```
    Refreshes from the database all fields in fetch plan. Called by life-cycle transitions when the object undergoes a "transitionRefresh".
    
    Specified by:
    
    refreshFieldsInFetchPlan in interface ObjectProvider<Persistable>
  - refreshLoadedFields
```
public void refreshLoadedFields()
```
    Refreshes from the database all fields currently loaded. Called by life-cycle transitions when making transactional or reading fields.
    
    Specified by:
    
    refreshLoadedFields in interface ObjectProvider<Persistable>
  - isLoaded
```
public boolean isLoaded(int fieldNumber)
```
    Returns the loaded setting for the field of the managed object. Refer to the javadoc of isLoaded(Persistable, int);
    
    Specified by:
    
    isLoaded in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - the absolute field number
    
    Returns:
    
    always returns true (this implementation)
  - isLoaded
```
public boolean isLoaded(Persistable pc,
                        int fieldNumber)
```
    Return true if the field is cached in the calling instance; in this implementation we always return true. If the field is not loaded, it will be loaded as a side effect of the call to this method. If it is in the default fetch group, the default fetch group, including this field, will be loaded.
    
    Specified by:
    
    isLoaded in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
    
    fieldNumber - the absolute field number
    
    Returns:
    
    always returns true (this implementation)
  - replaceFieldValue
```
public void replaceFieldValue(int fieldNumber,
                              Object newValue)
```
    Convenience method to change the value of a field that is assumed loaded. Will mark the object/field as dirty if it isn't previously. If the object is deleted then does nothing. Doesn't cater for embedded fields. *** Only for use in management of relations. ***
    
    Specified by:
    
    replaceFieldValue in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - Number of field
    
    newValue - The new value
  - replaceField
```
public void replaceField(int fieldNumber,
                         Object value)
```
    Method to change the value of a particular field and not mark it dirty.
    
    Specified by:
    
    replaceField in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - Number of field
    
    value - New value
  - replaceFieldMakeDirty
```
public void replaceFieldMakeDirty(int fieldNumber,
                                  Object value)
```
    Method to change the value of a particular field and mark it dirty.
    
    Specified by:
    
    replaceFieldMakeDirty in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - Number of field
    
    value - New value
  - replaceField
```
protected void replaceField(Persistable pc,
                            int fieldNumber,
                            Object value,
                            boolean makeDirty)
```
    Method to change the value of a field in the PC object. Adds on handling for embedded fields to the superclass handler.
    
    Parameters:
    
    pc - The PC object
    
    fieldNumber - Number of field
    
    value - The new value of the field
    
    makeDirty - Whether to make the field dirty while replacing its value (in embedded owners)
  - replaceFields
```
public void replaceFields(int[] fieldNumbers,
                          FieldManager fm,
                          boolean replaceWhenDirty)
```
    Called from the StoreManager to refresh data in the Persistable object associated with this StateManager.
    
    Specified by:
    
    replaceFields in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumbers - An array of field numbers to be refreshed by the Store
    
    fm - The updated values are stored in this object. This object is only valid for the duration of this call.
    
    replaceWhenDirty - Whether to replace the fields when they are dirty here
  - replaceFields
```
public void replaceFields(int[] fieldNumbers,
                          FieldManager fm)
```
    Called from the StoreManager to refresh data in the Persistable object associated with this StateManager.
    
    Specified by:
    
    replaceFields in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumbers - An array of field numbers to be refreshed by the Store
    
    fm - The updated values are stored in this object. This object is only valid for the duration of this call.
  - replaceNonLoadedFields
```
public void replaceNonLoadedFields(int[] fieldNumbers,
                                   FieldManager fm)
```
    Called from the StoreManager to refresh data in the Persistable object associated with this StateManager. Only fields that are not currently loaded are refreshed
    
    Specified by:
    
    replaceNonLoadedFields in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumbers - An array of field numbers to be refreshed by the Store
    
    fm - The updated values are stored in this object. This object is only valid for the duration of this call.
  - replaceAllLoadedSCOFieldsWithWrappers
```
public void replaceAllLoadedSCOFieldsWithWrappers()
```
    Method to replace all loaded SCO fields with wrappers. If the loaded field already uses a SCO wrapper nothing happens to that field.
    
    Specified by:
    
    replaceAllLoadedSCOFieldsWithWrappers in interface ObjectProvider<Persistable>
  - replaceAllLoadedSCOFieldsWithValues
```
public void replaceAllLoadedSCOFieldsWithValues()
```
    Method to replace all loaded SCO fields that have wrappers with their value. If the loaded field doesn't have a SCO wrapper nothing happens to that field.
    
    Specified by:
    
    replaceAllLoadedSCOFieldsWithValues in interface ObjectProvider<Persistable>
  - updateOwnerFieldInEmbeddedField
```
public void updateOwnerFieldInEmbeddedField(int fieldNumber,
                                            Object value)
```
    Method to update the "owner-field" in an embedded object with the owner object. TODO Likely this should be moved into a replaceField method, or maybe Managed Relationships.
    
    Specified by:
    
    updateOwnerFieldInEmbeddedField in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fieldNumber - The field number
    
    value - The value to initialise the wrapper with (if any)
  - makePersistent
```
public void makePersistent()
```
    Method to make the object persistent.
    
    Specified by:
    
    makePersistent in interface ObjectProvider<Persistable>
  - makeTransactional
```
public void makeTransactional()
```
    Method to change the object state to transactional.
    
    Specified by:
    
    makeTransactional in interface ObjectProvider<Persistable>
  - makeTransient
```
public void makeTransient(FetchPlanState state)
```
    Method to change the object state to transient.
    
    Specified by:
    
    makeTransient in interface ObjectProvider<Persistable>
    
    Parameters:
    
    state - Object containing the state of any fetchplan processing
  - detach
```
public void detach(FetchPlanState state)
```
    Method to detach this object. If the object is detachable then it will be migrated to DETACHED state, otherwise will migrate to TRANSIENT. Used by "DetachAllOnCommit"/"DetachAllOnRollback"
    
    Specified by:
    
    detach in interface ObjectProvider<Persistable>
    
    Parameters:
    
    state - State for the detachment process
  - detachCopy
```
public Persistable detachCopy(FetchPlanState state)
```
    Method to make detached copy of this instance If the object is detachable then the copy will be migrated to DETACHED state, otherwise will migrate the copy to TRANSIENT. Used by "ExecutionContext.detachObjectCopy()".
    
    Specified by:
    
    detachCopy in interface ObjectProvider<Persistable>
    
    Parameters:
    
    state - State for the detachment process
    
    Returns:
    
    the detached Persistable instance
  - isDetaching
```
public boolean isDetaching()
```
    Description copied from interface: ObjectProvider
    
    Tests whether this object is in the process of being detached.
    
    Specified by:
    
    isDetaching in interface ObjectProvider<Persistable>
    
    Returns:
    
    true if this instance is being detached.
  - attach
```
public void attach(Persistable detachedPC)
```
    Description copied from interface: ObjectProvider
    
    Method to attach the provided detached object into the managed instance.
    
    Specified by:
    
    attach in interface ObjectProvider<Persistable>
    
    Parameters:
    
    detachedPC - Detached object
  - attach
```
public void attach(boolean embedded)
```
    Method to attach the object managed by this StateManager.
    
    Specified by:
    
    attach in interface ObjectProvider<Persistable>
    
    Parameters:
    
    embedded - Whether it is embedded
  - attachCopy
```
public Persistable attachCopy(Persistable detachedPC,
                              boolean embedded)
```
    Method to attach a copy of the detached persistable instance and return the (attached) copy.
    
    Specified by:
    
    attachCopy in interface ObjectProvider<Persistable>
    
    Parameters:
    
    detachedPC - the detached persistable instance to be attached
    
    embedded - Whether the object is stored embedded/serialised in another object
    
    Returns:
    
    The attached copy
  - isAttaching
```
public boolean isAttaching()
```
  - deletePersistent
```
public void deletePersistent()
```
    Method to delete the object from persistence.
    
    Specified by:
    
    deletePersistent in interface ObjectProvider<Persistable>
  - becomingDeleted
```
public boolean becomingDeleted()
```
    Description copied from interface: ObjectProvider
    
    Whether this object is moving to a deleted state.
    
    Specified by:
    
    becomingDeleted in interface ObjectProvider<Persistable>
    
    Returns:
    
    Whether the object will be moved into a deleted state during this operation
  - validate
```
public void validate()
```
    Validates whether the persistable instance exists in the datastore. If the instance doesn't exist in the datastore, this method will fail raising a NucleusObjectNotFoundException. If the object is transactional then does nothing. If the object has unloaded (non-SCO, non-PK) fetch plan fields then fetches them. Else it checks the existence of the object in the datastore.
    
    Specified by:
    
    validate in interface ObjectProvider<Persistable>
  - preWriteField
```
protected boolean preWriteField(int fieldNumber)
```
    Method called before a write of the specified field.
    
    Parameters:
    
    fieldNumber - The field to write
    
    Returns:
    
    true if the field was already dirty before
  - postWriteField
```
protected void postWriteField(boolean wasDirty)
```
    Method called after the write of a field.
    
    Parameters:
    
    wasDirty - whether before writing this field the pc was dirty
  - postStateChange
```
protected void postStateChange()
```
    Method called after a change in state.
  - isPostLoadPending
```
protected boolean isPostLoadPending()
```
  - preSerialize
```
public void preSerialize(Persistable pc)
```
    Guarantee that the serializable transactional and persistent fields are loaded into the instance. This method is called by the generated dnPreSerialize method prior to serialization of the instance.
    
    Specified by:
    
    preSerialize in interface StateManager
    
    Parameters:
    
    pc - the calling Persistable instance
  - setStoringPC
```
public void setStoringPC()
```
    Description copied from interface: ObjectProvider
    
    Method to set the storing PC flag.
    
    Specified by:
    
    setStoringPC in interface ObjectProvider<Persistable>
  - unsetStoringPC
```
public void unsetStoringPC()
```
    Description copied from interface: ObjectProvider
    
    Method to unset the storing PC flag.
    
    Specified by:
    
    unsetStoringPC in interface ObjectProvider<Persistable>
  - isStoringPC
```
protected boolean isStoringPC()
```
  - flush
```
public void flush()
```
    Flushes any outstanding changes to the object to the datastore. This will process :-
    - Any objects that have been marked as provisionally persistent yet haven't been flushed to the datastore.
    - Any objects that have been marked as provisionally deleted yet haven't been flushed to the datastore.
    - Any fields that have been updated.
    Specified by:
    
    flush in interface ObjectProvider<Persistable>
  - saveFields
```
public void saveFields()
```
    Method to save all fields of the object, for use in any rollback.
    
    Specified by:
    
    saveFields in interface ObjectProvider<Persistable>
  - clearSavedFields
```
public void clearSavedFields()
```
    Method to clear all saved fields on the object.
    
    Specified by:
    
    clearSavedFields in interface ObjectProvider<Persistable>
  - restoreFields
```
public void restoreFields()
```
    Method to restore all fields of the object.
    
    Specified by:
    
    restoreFields in interface ObjectProvider<Persistable>
  - dump
```
public void dump(PrintWriter out)
```
    Utility to dump the contents of the StateManager.
    
    Parameters:
    
    out - PrintWriter to dump to
  - peekField
```
protected static Object peekField(Object obj,
                                  String fieldName)
```
    Utility to take a peek at a field in the persistable object.
    
    Parameters:
    
    obj - The persistable object
    
    fieldName - The field to peek at
    
    Returns:
    
    The value of the field.
  - changeActivityState
```
public void changeActivityState(ActivityState state)
```
    Description copied from interface: ObjectProvider
    
    Update the acitvity state.
    
    Specified by:
    
    changeActivityState in interface ObjectProvider<Persistable>
    
    Parameters:
    
    state - the activity state
  - updateFieldAfterInsert
```
public void updateFieldAfterInsert(Object pc,
                                   int fieldNumber)
```
    Description copied from interface: ObjectProvider
    
    Marks the given field dirty for issuing an update after the insert.
    
    Specified by:
    
    updateFieldAfterInsert in interface ObjectProvider<Persistable>
    
    Parameters:
    
    pc - The Persistable object
    
    fieldNumber - The no of field to mark as dirty.
  - initialiseForHollowAppId
```
public void initialiseForHollowAppId(FieldValues fv,
                                     Class pcClass)
```
    Deprecated. Remove use of this and use initialiseForHollow
    
    Initialises a state manager to manage a HOLLOW / P_CLEAN instance having the given FieldValues. This constructor is used for creating new instances of existing persistent objects using application identity, and consequently shouldn't be used when the StoreManager controls the creation of such objects (such as in an ODBMS).
    
    Specified by:
    
    initialiseForHollowAppId in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fv - the initial field values of the object.
    
    pcClass - Class of the object that this will manage the state for
  - checkInheritance
```
public void checkInheritance(FieldValues fv)
```
    Deprecated. Dont use this, to be removed
    
    Look to the database to determine which class this object is. This parameter is a hint. Set false, if it's already determined the correct pcClass for this pc "object" in a certain level in the hierarchy. Set to true and it will look to the database. TODO This is only called by some outdated code in LDAPUtils; remove it when that is fixed
    
    Specified by:
    
    checkInheritance in interface ObjectProvider<Persistable>
    
    Parameters:
    
    fv - the initial field values of the object.

Class StateManagerImpl

Embedded/Serialised Objects

Performance and Memory

Field Summary

Fields inherited from interface org.datanucleus.state.ObjectProvider

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.datanucleus.enhancement.StateManager

Field Detail

HOLLOWFIELDMANAGER

FLAG_VALIDATING

FLAG_RESTORE_VALUES

FLAG_STORING_PC

FLAG_NEED_INHERITANCE_VALIDATION

FLAG_POSTINSERT_UPDATE

FLAG_LOADINGFPFIELDS

FLAG_POSTLOAD_PENDING

FLAG_CHANGING_STATE

FLAG_FLUSHED_NEW

FLAG_BECOMING_DELETED

FLAG_UPDATING_EMBEDDING_FIELDS_WITH_OWNER

FLAG_RETRIEVING_DETACHED_STATE

FLAG_RESETTING_DETACHED_STATE

FLAG_ATTACHING

FLAG_DETACHING

FLAG_MAKING_TRANSIENT

FLAG_FLUSHING

FLAG_DISCONNECTING

myPC

flags

myEC

cmd

myInternalID

myID

myLC

myVersion

transactionalVersion

persistenceFlags

myFP

dirty

dirtyFields

loadedFields

lock

activity

currFM

objectType

savedPersistenceFlags

savedLoadedFields

savedImage

Constructor Detail

StateManagerImpl

Method Detail

connect

disconnect

initialiseForHollow

initialiseForHollowPreConstructed

initialiseForPersistentClean

initialiseForEmbedded

initialiseForPersistentNew

initialiseForTransactionalTransient

initialiseForDetached

initialiseForPNewToBeDeleted

initialiseForCachedPC

getClassMetaData

getExecutionContext

getStoreManager

getLifecycleState

getCallbackHandler

getObject

getObjectAsPrintable

toString

isWaitingToBeFlushedToDatastore

isRestoreValues

isChangingState

isInserting

isDeleting

markForInheritanceValidation

setTransactionalVersion

getTransactionalVersion