JDOStateManager (DataNucleus Core 3.2.10 API)

java.lang.Object
- org.datanucleus.state.AbstractStateManager
- - org.datanucleus.state.JDOStateManager

All Implemented Interfaces:

javax.jdo.spi.StateManager, ObjectProvider

Direct Known Subclasses:

ReferentialJDOStateManager
```
public class JDOStateManager
extends AbstractStateManager
implements javax.jdo.spi.StateManager, ObjectProvider
```
Implementation of a JDO StateManager, supporting the bytecode enhancement contract of JDO. Implemented here as one StateManager per Object so adds on functionality particular to each object. All PersistenceCapable objects will have a StateManager when they have had communication with the PersistenceManager. 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 PersistentCapable object made persistent, there will be one StateManager instance, adding up to the total memory footprint of that object. In heap profiling analysis, JDOStateManager 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. TODO The future aim is to have different types of StateManagers (ObjectProviders) that have particular features. In addition we want to have a JPAStateManager using an internal enhancement contract. This means we'll need various things generalising into a superclass

Field Summary

Fields
Modifier and Type	Field and Description
`protected javax.jdo.spi.PersistenceCapable`	`myPC` The PersistenceCapable instance managed by this StateManager
`protected javax.jdo.spi.PersistenceCapable`	`savedImage` Image of the PersistenceCapable instance when the instance is enlisted in the transaction.

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
`JDOStateManager(ExecutionContext ec, AbstractClassMetaData cmd)` Constructor for object of specified type managed by the provided ExecutionContext.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`attach(boolean embedded)` Method to attach the object managed by this StateManager.
`void`	`attach(Object trans)` Method to attach the provided transient into the managed instance.
`Object`	`attachCopy(Object obj, boolean embedded)` Method to attach a copy of the detached persistable instance and return the (attached) copy.
`void`	`changeActivityState(ActivityState state)` Update the acitvity state.
`void`	`checkInheritance(FieldValues fv)` Deprecated. Dont use this, to be removed
`void`	`clearFields()` Method to clear all fields of the object.
`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 the provider to the specified ExecutionContext and object type.
`void`	`copyFieldsFromObject(Object obj, int[] fieldNumbers)` Convenience method to update our object with the field values from the passed object.
`void`	`deletePersistent()` Method to delete the object from persistence.
`void`	`detach(FetchPlanState state)` Method to detach this object.
`Object`	`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 the provider from the ExecutionContext and PC object.
`protected boolean`	`disconnectClone(javax.jdo.spi.PersistenceCapable 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`	`evictFromTransaction()` Method to evict the managed object from the current transaction.
`void`	`flush()` Flushes any outstanding changes to the object to the datastore.
`boolean`	`getBooleanField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, boolean currentValue)`
`byte`	`getByteField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, byte currentValue)`
`char`	`getCharField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, char currentValue)`
`double`	`getDoubleField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, double currentValue)`
`ObjectProvider[]`	`getEmbeddedOwners()` Accessor for the owning ObjectProviders for the managed object when stored embedded.
`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.
`float`	`getFloatField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, float currentValue)`
`int`	`getIntField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, int currentValue)`
`long`	`getLongField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, long currentValue)`
`Object`	`getObject()` Accessor for the Persistent Capable object.
`Object`	`getObjectField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, Object currentValue)`
`Object`	`getObjectId(javax.jdo.spi.PersistenceCapable pc)` Return the object representing the JDO identity of the calling instance.
`javax.jdo.PersistenceManager`	`getPersistenceManager(javax.jdo.spi.PersistenceCapable pc)` Accessor for the PersistenceManager that owns this instance.
`Object`	`getReferencedPC()` Accessor for the referenced PC object when we are attaching or detaching.
`short`	`getShortField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, short currentValue)`
`String`	`getStringField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, String currentValue)`
`Object`	`getTransactionalObjectId(javax.jdo.spi.PersistenceCapable pc)` Return the object representing the JDO identity of the calling instance.
`Object`	`getTransactionalVersion()` Return the transactional version of the managed object.
`Object`	`getVersion()` Method to return the current version of the managed object.
`Object`	`getVersion(javax.jdo.spi.PersistenceCapable pc)` Return the object representing the version of the calling instance.
`void`	`initialiseForCachedPC(CachedPC cachedPC, Object id)` Initialise the ObjectProvider, assigning the specified id to the object.
`void`	`initialiseForDetached(Object pc, Object id, Object version)` Initialises the StateManager to manage a PersistenceCapable object in detached state.
`void`	`initialiseForEmbedded(Object pc, boolean copyPc)` Initialises a state manager to manage a PersistenceCapable instance that will be EMBEDDED/SERIALISED into another PersistenceCapable 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, Object pc)` Initialises a state manager to manage the given hollow instance having the given object ID.
`void`	`initialiseForPersistentClean(Object id, Object pc)` Initialises a state manager to manage the passed persistent instance having the given object ID.
`void`	`initialiseForPersistentNew(Object pc, FieldValues preInsertChanges)` Initialises a state manager to manage a transient instance that is becoming newly persistent.
`void`	`initialiseForPNewToBeDeleted(Object pc)` Initialises the StateManager to manage a PersistenceCapable object that is not persistent but is about to be deleted.
`void`	`initialiseForTransactionalTransient(Object pc)` Initialises a state manager to manage a Transactional Transient instance.
`boolean`	`isDeleted(javax.jdo.spi.PersistenceCapable pc)` Tests whether this object has been deleted.
`boolean`	`isDirty(javax.jdo.spi.PersistenceCapable pc)` Tests whether this object is dirty.
`boolean`	`isLoaded(int fieldNumber)` Returns the loaded setting for the field of the managed object.
`boolean`	`isLoaded(javax.jdo.spi.PersistenceCapable pc, int fieldNumber)` Return true if the field is cached in the calling instance.
`boolean`	`isNew(javax.jdo.spi.PersistenceCapable pc)` Tests whether this object has been newly made persistent.
`boolean`	`isPersistent(javax.jdo.spi.PersistenceCapable pc)` Tests whether this object is persistent.
`boolean`	`isTransactional(javax.jdo.spi.PersistenceCapable pc)` Tests whether this object is transactional.
`void`	`loadField(int fieldNumber)` Convenience method to load the specified field if not loaded.
`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 fields in the actual fetch plan.
`void`	`makeDirty(int fieldNumber)` Marks the given field dirty.
`void`	`makeDirty(javax.jdo.spi.PersistenceCapable pc, String fieldName)` Mark the associated PersistenceCapable field dirty.
`void`	`makePersistent()` Method to make the object persistent.
`void`	`makeTransactional()` Method to change the object state to transactional.
`void`	`makeTransient(FetchPlanState state)` Method to change the object state to transient.
`void`	`nullifyFields()` Nullify fields with reference to PersistenceCapable or SCO instances
`protected static Object`	`peekField(Object obj, String fieldName)` Utility to take a peek at a field in the persistable object.
`protected void`	`postStateChange()` Method called after a change in state.
`protected void`	`postWriteField(boolean wasDirty)` Method called after the write of a field.
`void`	`preSerialize(javax.jdo.spi.PersistenceCapable pc)` Guarantee that the serializable transactional and persistent fields are loaded into the instance.
`protected boolean`	`preWriteField(int fieldNumber)` Method called before a write of the specified field.
`void`	`providedBooleanField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, boolean currentValue)` This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedByteField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, byte currentValue)` This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedCharField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, char currentValue)` This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedDoubleField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, double currentValue)` This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedFloatField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, float currentValue)` This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedIntField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, int currentValue)` This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedLongField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, long currentValue)` This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedObjectField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, Object currentValue)` This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedShortField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, short currentValue)` This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked.
`void`	`providedStringField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, String currentValue)` This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked.
`Object`	`provideField(int fieldNumber)` Method to return the current value of a particular field.
`protected Object`	`provideField(javax.jdo.spi.PersistenceCapable 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 PersistenceCapable associated with this StateManager.
`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`	`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(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, Object value)` Method to change the value of a field in the PC object.
`protected void`	`replaceField(javax.jdo.spi.PersistenceCapable 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 PersistenceCapable object associated with this StateManager.
`void`	`replaceFields(int[] fieldNumbers, FieldManager fm, boolean replaceWhenDirty)` Called from the StoreManager to refresh data in the PersistenceCapable 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(Object 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 PersistenceCapable object associated with this StateManager.
`protected void`	`replaceStateManager(javax.jdo.spi.PersistenceCapable pc, javax.jdo.spi.StateManager sm)` Utility to update the passed object with the passed StateManager (can be null).
`boolean`	`replacingBooleanField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber)` This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a boolean field.
`byte`	`replacingByteField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a byte field.
`char`	`replacingCharField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a char field.
`Object[]`	`replacingDetachedState(javax.jdo.spi.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(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a double field.
`byte`	`replacingFlags(javax.jdo.spi.PersistenceCapable pc)` The StateManager uses this method to supply the value of jdoFlags to the associated PersistenceCapable instance.
`float`	`replacingFloatField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a float field.
`int`	`replacingIntField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of a int field.
`long`	`replacingLongField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of a long field.
`Object`	`replacingObjectField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of an Object field.
`short`	`replacingShortField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of a short field.
`javax.jdo.spi.StateManager`	`replacingStateManager(javax.jdo.spi.PersistenceCapable pc, javax.jdo.spi.StateManager sm)` Replace the current value of jdoStateManager.
`String`	`replacingStringField(javax.jdo.spi.PersistenceCapable obj, int fieldNumber)` This method is invoked by the persistable object's jdoReplaceField() 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`	`retrieveDetachState(ObjectProvider op)` Convenience method to retrieve the detach state from the passed ObjectProvider's object.
`void`	`runReachability(Set reachables)` Method to mark an object for reachability.
`void`	`saveFields()` Method to save all fields of the object so we can potentially restore them later.
`void`	`setBooleanField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, boolean currentValue, boolean newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setByteField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, byte currentValue, byte newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setCharField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, char currentValue, char newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setDoubleField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, double currentValue, double newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setFloatField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, float currentValue, float newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setIntField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, int currentValue, int newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setLongField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, long currentValue, long newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setObjectField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, Object currentValue, Object newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`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(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, short currentValue, short newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`void`	`setStringField(javax.jdo.spi.PersistenceCapable pc, int fieldNumber, String currentValue, String newValue)` This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
`Object`	`unwrapSCOField(int fieldNumber, Object value, boolean replaceFieldIfChanged)` Method to unwrap a SCO field (if it is wrapped currently).
`protected void`	`updateField(javax.jdo.spi.PersistenceCapable 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.
`void`	`validate()` Validates whether the persistence capable instance exists in the datastore.
`Object`	`wrapSCOField(int fieldNumber, Object value, boolean forInsert, boolean forUpdate, boolean replaceFieldIfChanged)` Method to create a new SCO wrapper for the specified field.

Methods inherited from class org.datanucleus.state.AbstractStateManager
areFieldsLoaded, becomingDeleted, clearDirtyFlags, clearDirtyFlags, clearFieldsByNumbers, containsAssociatedValue, evict, getAllFieldsLoaded, getAssociatedValue, getCallbackHandler, getClassMetaData, getDirtyFieldNames, getDirtyFieldNumbers, getDirtyFields, getExecutionContext, getFieldNumbersOfLoadedOrDirtyFields, getInternalObjectId, getLifecycleState, getLoadedFieldNames, getLoadedFieldNumbers, getLoadedFields, getLockMode, getObjectAsPrintable, getObjectValueGenerator, getTransactionalVersion, internalDeletePersistent, isAttaching, isChangingState, isDeleting, isDetaching, isDisconnecting, isEmbedded, isFieldLoaded, isFlushedNew, isFlushedToDatastore, isFlushing, isInserting, isMakingTransient, isPostLoadPending, isResettingDetachedState, isRestoreValues, isRetrievingDetachedState, isStoringPC, isWaitingToBeFlushedToDatastore, loadFieldFromDatastore, loadFieldsFromDatastore, loadFieldsFromLevel2Cache, loadFieldsInFetchPlan, locate, lock, makeNontransactional, makePersistentTransactionalTransient, markAsFlushed, markForInheritanceValidation, markPKFieldsAsLoaded, postCommit, preBegin, preRollback, preStateChange, refresh, removeAssociatedValue, retrieve, setAssociatedValue, setFlushedNew, setFlushing, setPcObjectType, setStoringPC, setTransactionalVersion, setVersion, toString, transitionReadField, transitionWriteField, unloadField, unloadNonFetchPlanFields, unlock, unsetStoringPC, updateLevel2CacheForFields

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

Methods inherited from interface org.datanucleus.state.ObjectProvider
becomingDeleted, evict, getAllFieldsLoaded, getAssociatedValue, getClassMetaData, getDirtyFieldNames, getDirtyFieldNumbers, getDirtyFields, getExecutionContext, getInternalObjectId, getLifecycleState, getLoadedFieldNames, getLoadedFieldNumbers, getLoadedFields, getLockMode, getObjectAsPrintable, isDeleting, isEmbedded, isFieldLoaded, isFlushedNew, isFlushedToDatastore, isInserting, isRestoreValues, isWaitingToBeFlushedToDatastore, loadFieldFromDatastore, loadFieldsInFetchPlan, locate, lock, makeNontransactional, makePersistentTransactionalTransient, markAsFlushed, markForInheritanceValidation, postCommit, preBegin, preRollback, refresh, removeAssociatedValue, retrieve, setAssociatedValue, setFlushedNew, setFlushing, setPcObjectType, setStoringPC, setTransactionalVersion, setVersion, unloadField, unloadNonFetchPlanFields, unlock, unsetStoringPC

- Field Detail
  - myPC
```
protected javax.jdo.spi.PersistenceCapable myPC
```
    The PersistenceCapable instance managed by this StateManager
  - savedImage
```
protected javax.jdo.spi.PersistenceCapable savedImage
```
    Image of the PersistenceCapable instance when the instance is enlisted in the transaction.
- Constructor Detail
  - JDOStateManager
```
public JDOStateManager(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 class: AbstractStateManager
    
    Method to (re)connect the provider to the specified ExecutionContext and object type.
    
    Specified by:
    
    connect in interface ObjectProvider
    
    Overrides:
    
    connect in class AbstractStateManager
  - disconnect
```
public void disconnect()
```
    Disconnect the provider from the ExecutionContext and PC object.
    
    Specified by:
    
    disconnect in interface ObjectProvider
  - 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 shouldnt be used when the StoreManager controls the creation of such objects (such as in an ODBMS).
    
    Specified by:
    
    initialiseForHollow in interface ObjectProvider
    
    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
  - 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 shouldnt be used when the StoreManager controls the creation of such objects (such as in an ODBMS).
    
    Specified by:
    
    initialiseForHollowAppId in interface ObjectProvider
    
    Parameters:
    fv - the initial field values of the object.
    pcClass - Class of the object that this will manage the state for
  - initialiseForHollowPreConstructed
```
public void initialiseForHollowPreConstructed(Object id,
                                     Object 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
    
    Parameters:
    id - the identity of the object.
    pc - the object to be managed.
  - initialiseForPersistentClean
```
public void initialiseForPersistentClean(Object id,
                                Object 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
    
    Parameters:
    id - the identity of the object.
    pc - The object to be managed
  - initialiseForEmbedded
```
public void initialiseForEmbedded(Object pc,
                         boolean copyPc)
```
    Initialises a state manager to manage a PersistenceCapable instance that will be EMBEDDED/SERIALISED into another PersistenceCapable object. The instance will not be assigned an identity in the process since it is a SCO.
    
    Specified by:
    
    initialiseForEmbedded in interface ObjectProvider
    
    Parameters:
    pc - The PersistenceCapable to manage (see copyPc also)
    copyPc - Whether the SM should manage a copy of the passed PC or that one
  - initialiseForPersistentNew
```
public void initialiseForPersistentNew(Object 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
    
    Parameters:
    pc - the instance being make persistent.
    preInsertChanges - Any changes to make before inserting
  - initialiseForTransactionalTransient
```
public void initialiseForTransactionalTransient(Object 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
    
    Parameters:
    pc - the instance being make persistent.
  - initialiseForDetached
```
public void initialiseForDetached(Object pc,
                         Object id,
                         Object version)
```
    Initialises the StateManager to manage a PersistenceCapable object in detached state.
    
    Specified by:
    
    initialiseForDetached in interface ObjectProvider
    
    Parameters:
    pc - the detach object.
    id - the identity of the object.
    version - the detached version
  - initialiseForPNewToBeDeleted
```
public void initialiseForPNewToBeDeleted(Object pc)
```
    Initialises the StateManager to manage a PersistenceCapable object that is not persistent but is about to be deleted.
    
    Specified by:
    
    initialiseForPNewToBeDeleted in interface ObjectProvider
    
    Parameters:
    pc - the object to delete
  - initialiseForCachedPC
```
public void initialiseForCachedPC(CachedPC 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
    
    Parameters:
    cachedPC - The cached PC object
    id - Id to assign to the PersistenceCapable object
  - getObject
```
public Object getObject()
```
    Accessor for the Persistent Capable object.
    
    Specified by:
    
    getObject in interface ObjectProvider
    
    Specified by:
    
    getObject in class AbstractStateManager
    
    Returns:
    The PersistentCapable object
  - saveFields
```
public void saveFields()
```
    Method to save all fields of the object so we can potentially restore them later.
    
    Specified by:
    
    saveFields in interface ObjectProvider
  - clearSavedFields
```
public void clearSavedFields()
```
    Method to clear all saved fields on the object.
    
    Specified by:
    
    clearSavedFields in interface ObjectProvider
  - restoreFields
```
public void restoreFields()
```
    Method to restore all fields of the object.
    
    Specified by:
    
    restoreFields in interface ObjectProvider
  - enlistInTransaction
```
public void enlistInTransaction()
```
    Method to enlist the managed object in the current transaction.
    
    Specified by:
    
    enlistInTransaction in interface ObjectProvider
  - evictFromTransaction
```
public void evictFromTransaction()
```
    Method to evict the managed object from the current transaction.
    
    Specified by:
    
    evictFromTransaction in interface ObjectProvider
  - replaceStateManager
```
protected void replaceStateManager(javax.jdo.spi.PersistenceCapable pc,
                       javax.jdo.spi.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 javax.jdo.spi.StateManager replacingStateManager(javax.jdo.spi.PersistenceCapable pc,
                                               javax.jdo.spi.StateManager sm)
```
    Replace the current value of jdoStateManager.
    This method is called by the PersistenceCapable whenever jdoReplaceStateManager 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 PersistenceCapable.
    
    Specified by:
    
    replacingStateManager in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    sm - the proposed new value for the jdoStateManager
    
    Returns:
    the new value for the jdoStateManager
  - replaceManagedPC
```
public void replaceManagedPC(Object pc)
```
    Method that replaces the PC managed by this StateManager to be the supplied object. This happens 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 DB4O)
    
    Specified by:
    
    replaceManagedPC in interface ObjectProvider
    
    Parameters:
    pc - The PersistenceCapable to use
  - getPersistenceManager
```
public javax.jdo.PersistenceManager getPersistenceManager(javax.jdo.spi.PersistenceCapable pc)
```
    Accessor for the PersistenceManager that owns this instance.
    
    Specified by:
    
    getPersistenceManager in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - The PersistenceCapable instance
    
    Returns:
    The PersistenceManager that owns this instance
  - isDirty
```
public boolean isDirty(javax.jdo.spi.PersistenceCapable 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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    
    Returns:
    true if this instance has been modified in current transaction.
    See Also:
    PersistenceCapable.jdoMakeDirty(String fieldName)
  - isTransactional
```
public boolean isTransactional(javax.jdo.spi.PersistenceCapable 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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    
    Returns:
    true if this instance is transactional.
  - isPersistent
```
public boolean isPersistent(javax.jdo.spi.PersistenceCapable 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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    
    Returns:
    true if this instance is persistent.
  - isNew
```
public boolean isNew(javax.jdo.spi.PersistenceCapable 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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    
    Returns:
    true if this instance was made persistent in the current transaction.
  - isDeleted
```
public boolean isDeleted(javax.jdo.spi.PersistenceCapable 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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    
    Returns:
    true if this instance was deleted in the current transaction.
  - getVersion
```
public Object getVersion(javax.jdo.spi.PersistenceCapable pc)
```
    Return the object representing the version of the calling instance.
    
    Specified by:
    
    getVersion in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    
    Returns:
    the object representing the version of the calling instance
    Since:
    
    JDO 2.0
  - getVersion
```
public Object getVersion()
```
    Method to return the current version of the managed object.
    
    Specified by:
    
    getVersion in interface ObjectProvider
    
    Returns:
    The version
  - getTransactionalVersion
```
public Object getTransactionalVersion()
```
    Return the transactional version of the managed object.
    
    Specified by:
    
    getTransactionalVersion in interface ObjectProvider
    
    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
  - 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
  - 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
  - replacingFlags
```
public byte replacingFlags(javax.jdo.spi.PersistenceCapable pc)
```
    The StateManager uses this method to supply the value of jdoFlags to the associated PersistenceCapable instance.
    
    Specified by:
    
    replacingFlags in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    
    Returns:
    the value of jdoFlags to be stored in the PersistenceCapable instance
  - providedBooleanField
```
public void providedBooleanField(javax.jdo.spi.PersistenceCapable pc,
                        int fieldNumber,
                        boolean currentValue)
```
    This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedBooleanField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedByteField
```
public void providedByteField(javax.jdo.spi.PersistenceCapable pc,
                     int fieldNumber,
                     byte currentValue)
```
    This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedByteField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedCharField
```
public void providedCharField(javax.jdo.spi.PersistenceCapable pc,
                     int fieldNumber,
                     char currentValue)
```
    This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedCharField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedDoubleField
```
public void providedDoubleField(javax.jdo.spi.PersistenceCapable pc,
                       int fieldNumber,
                       double currentValue)
```
    This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedDoubleField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedFloatField
```
public void providedFloatField(javax.jdo.spi.PersistenceCapable pc,
                      int fieldNumber,
                      float currentValue)
```
    This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedFloatField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedIntField
```
public void providedIntField(javax.jdo.spi.PersistenceCapable pc,
                    int fieldNumber,
                    int currentValue)
```
    This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedIntField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedLongField
```
public void providedLongField(javax.jdo.spi.PersistenceCapable pc,
                     int fieldNumber,
                     long currentValue)
```
    This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedLongField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedShortField
```
public void providedShortField(javax.jdo.spi.PersistenceCapable pc,
                      int fieldNumber,
                      short currentValue)
```
    This method is called from the associated PersistenceCapable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedShortField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedStringField
```
public void providedStringField(javax.jdo.spi.PersistenceCapable pc,
                       int fieldNumber,
                       String currentValue)
```
    This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedStringField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - providedObjectField
```
public void providedObjectField(javax.jdo.spi.PersistenceCapable pc,
                       int fieldNumber,
                       Object currentValue)
```
    This method is called from the associated persistable when its PersistenceCapable.jdoProvideFields() method is invoked. Its purpose is to provide the value of the specified field to the StateManager.
    
    Specified by:
    
    providedObjectField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
  - provideField
```
public Object provideField(int fieldNumber)
```
    Method to return the current value of a particular field.
    
    Specified by:
    
    provideField in interface ObjectProvider
    
    Parameters:
    fieldNumber - Number of field
    
    Returns:
    The value of the field
  - provideField
```
protected Object provideField(javax.jdo.spi.PersistenceCapable 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 PersistenceCapable associated with this StateManager.
    
    Specified by:
    
    provideFields in interface ObjectProvider
    
    Specified by:
    
    provideFields in class AbstractStateManager
    
    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(javax.jdo.spi.PersistenceCapable pc,
                   int fieldNumber,
                   boolean currentValue,
                   boolean newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setBooleanField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setByteField
```
public void setByteField(javax.jdo.spi.PersistenceCapable pc,
                int fieldNumber,
                byte currentValue,
                byte newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setByteField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setCharField
```
public void setCharField(javax.jdo.spi.PersistenceCapable pc,
                int fieldNumber,
                char currentValue,
                char newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setCharField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setDoubleField
```
public void setDoubleField(javax.jdo.spi.PersistenceCapable pc,
                  int fieldNumber,
                  double currentValue,
                  double newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setDoubleField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setFloatField
```
public void setFloatField(javax.jdo.spi.PersistenceCapable pc,
                 int fieldNumber,
                 float currentValue,
                 float newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setFloatField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setIntField
```
public void setIntField(javax.jdo.spi.PersistenceCapable pc,
               int fieldNumber,
               int currentValue,
               int newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setIntField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setLongField
```
public void setLongField(javax.jdo.spi.PersistenceCapable pc,
                int fieldNumber,
                long currentValue,
                long newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setLongField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setShortField
```
public void setShortField(javax.jdo.spi.PersistenceCapable pc,
                 int fieldNumber,
                 short currentValue,
                 short newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setShortField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setStringField
```
public void setStringField(javax.jdo.spi.PersistenceCapable pc,
                  int fieldNumber,
                  String currentValue,
                  String newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setStringField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - setObjectField
```
public void setObjectField(javax.jdo.spi.PersistenceCapable pc,
                  int fieldNumber,
                  Object currentValue,
                  Object newValue)
```
    This method is called by the associated PersistenceCapable when the corresponding mutator method (setXXX()) is called on the PersistenceCapable.
    
    Specified by:
    
    setObjectField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldNumber - the field number
    currentValue - the current value of the field
    newValue - the new value for the field
  - updateField
```
protected void updateField(javax.jdo.spi.PersistenceCapable 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
  - replacingBooleanField
```
public boolean replacingBooleanField(javax.jdo.spi.PersistenceCapable pc,
                            int fieldNumber)
```
    This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a boolean field.
    
    Specified by:
    
    replacingBooleanField in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingByteField
```
public byte replacingByteField(javax.jdo.spi.PersistenceCapable obj,
                      int fieldNumber)
```
    This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a byte field.
    
    Specified by:
    
    replacingByteField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingCharField
```
public char replacingCharField(javax.jdo.spi.PersistenceCapable obj,
                      int fieldNumber)
```
    This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a char field.
    
    Specified by:
    
    replacingCharField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingDoubleField
```
public double replacingDoubleField(javax.jdo.spi.PersistenceCapable obj,
                          int fieldNumber)
```
    This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a double field.
    
    Specified by:
    
    replacingDoubleField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling PersistenceCapable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingFloatField
```
public float replacingFloatField(javax.jdo.spi.PersistenceCapable obj,
                        int fieldNumber)
```
    This method is invoked by the PersistenceCapable object's jdoReplaceField() method to refresh the value of a float field.
    
    Specified by:
    
    replacingFloatField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling PersistenceCapable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingIntField
```
public int replacingIntField(javax.jdo.spi.PersistenceCapable obj,
                    int fieldNumber)
```
    This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of a int field.
    
    Specified by:
    
    replacingIntField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingLongField
```
public long replacingLongField(javax.jdo.spi.PersistenceCapable obj,
                      int fieldNumber)
```
    This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of a long field.
    
    Specified by:
    
    replacingLongField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingShortField
```
public short replacingShortField(javax.jdo.spi.PersistenceCapable obj,
                        int fieldNumber)
```
    This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of a short field.
    
    Specified by:
    
    replacingShortField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingStringField
```
public String replacingStringField(javax.jdo.spi.PersistenceCapable obj,
                          int fieldNumber)
```
    This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of a String field.
    
    Specified by:
    
    replacingStringField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replacingObjectField
```
public Object replacingObjectField(javax.jdo.spi.PersistenceCapable obj,
                          int fieldNumber)
```
    This method is invoked by the persistable object's jdoReplaceField() method to refresh the value of an Object field.
    
    Specified by:
    
    replacingObjectField in interface javax.jdo.spi.StateManager
    
    Parameters:
    obj - the calling persistable instance
    fieldNumber - the field number
    
    Returns:
    the new value for the field
  - replaceField
```
protected void replaceField(javax.jdo.spi.PersistenceCapable 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(javax.jdo.spi.PersistenceCapable pc)
```
    Method to disconnect any cloned persistence capable objects from their StateManager.
    
    Parameters:
    pc - The PersistenceCapable 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
    
    Parameters:
    op - ObjectProvider
  - resetDetachState
```
public void resetDetachState()
```
    Convenience method to reset the detached state in the current object.
    
    Specified by:
    
    resetDetachState in interface ObjectProvider
  - replacingDetachedState
```
public Object[] replacingDetachedState(javax.jdo.spi.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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - The PersistenceCapable beind updated
    currentState - The current state values
    
    Returns:
    The detached state to assign to the object
  - getBooleanField
```
public boolean getBooleanField(javax.jdo.spi.PersistenceCapable pc,
                      int fieldNumber,
                      boolean currentValue)
```
    Specified by:
    
    getBooleanField in interface javax.jdo.spi.StateManager
  - getByteField
```
public byte getByteField(javax.jdo.spi.PersistenceCapable pc,
                int fieldNumber,
                byte currentValue)
```
    Specified by:
    
    getByteField in interface javax.jdo.spi.StateManager
  - getCharField
```
public char getCharField(javax.jdo.spi.PersistenceCapable pc,
                int fieldNumber,
                char currentValue)
```
    Specified by:
    
    getCharField in interface javax.jdo.spi.StateManager
  - getDoubleField
```
public double getDoubleField(javax.jdo.spi.PersistenceCapable pc,
                    int fieldNumber,
                    double currentValue)
```
    Specified by:
    
    getDoubleField in interface javax.jdo.spi.StateManager
  - getFloatField
```
public float getFloatField(javax.jdo.spi.PersistenceCapable pc,
                  int fieldNumber,
                  float currentValue)
```
    Specified by:
    
    getFloatField in interface javax.jdo.spi.StateManager
  - getIntField
```
public int getIntField(javax.jdo.spi.PersistenceCapable pc,
              int fieldNumber,
              int currentValue)
```
    Specified by:
    
    getIntField in interface javax.jdo.spi.StateManager
  - getLongField
```
public long getLongField(javax.jdo.spi.PersistenceCapable pc,
                int fieldNumber,
                long currentValue)
```
    Specified by:
    
    getLongField in interface javax.jdo.spi.StateManager
  - getShortField
```
public short getShortField(javax.jdo.spi.PersistenceCapable pc,
                  int fieldNumber,
                  short currentValue)
```
    Specified by:
    
    getShortField in interface javax.jdo.spi.StateManager
  - getStringField
```
public String getStringField(javax.jdo.spi.PersistenceCapable pc,
                    int fieldNumber,
                    String currentValue)
```
    Specified by:
    
    getStringField in interface javax.jdo.spi.StateManager
  - getObjectField
```
public Object getObjectField(javax.jdo.spi.PersistenceCapable pc,
                    int fieldNumber,
                    Object currentValue)
```
    Specified by:
    
    getObjectField in interface javax.jdo.spi.StateManager
  - 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
    
    Parameters:
    fv - the initial field values of the object.
  - loadFieldValues
```
public void loadFieldValues(FieldValues fv)
```
    Convenience method to load the passed field values. Loads the fields using any required fetch plan and calls jdoPostLoad() as appropriate.
    
    Specified by:
    
    loadFieldValues in interface ObjectProvider
    
    Parameters:
    fv - Field Values to load (including any fetch plan to use when loading)
  - copyFieldsFromObject
```
public void copyFieldsFromObject(Object obj,
                        int[] fieldNumbers)
```
    Convenience method to update our object with the field values from the passed object. Objects need to be of the same type, and the other object should not have a StateManager. TODO Only used by XML plugin so strip this out into a convenience method.
    
    Specified by:
    
    copyFieldsFromObject in interface ObjectProvider
    
    Parameters:
    obj - The object that we should copy fields from
    fieldNumbers - Numbers of fields to copy
  - makeDirty
```
public void makeDirty(int fieldNumber)
```
    Marks the given field dirty.
    
    Specified by:
    
    makeDirty in interface ObjectProvider
    
    Parameters:
    fieldNumber - The no of field to mark as dirty.
  - makeDirty
```
public void makeDirty(javax.jdo.spi.PersistenceCapable pc,
             String fieldName)
```
    Mark the associated PersistenceCapable field dirty.
    
    Specified by:
    
    makeDirty in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    fieldName - the name of the field
  - getObjectId
```
public Object getObjectId(javax.jdo.spi.PersistenceCapable 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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
    
    Returns:
    the object representing the JDO identity of the calling instance
  - getTransactionalObjectId
```
public Object getTransactionalObjectId(javax.jdo.spi.PersistenceCapable 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(PersistenceCapable).
    
    Specified by:
    
    getTransactionalObjectId in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable 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
    
    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 PersistenceCapable 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
    
    Returns:
    the object id
  - 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
    
    Parameters:
    fieldNumber - Absolute field number
  - 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
  - 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
  - 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 fields in the actual fetch plan. Called by life-cycle transitions.
    
    Specified by:
    
    loadUnloadedFieldsOfClassInFetchPlan in interface ObjectProvider
    
    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
  - 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
  - isLoaded
```
public boolean isLoaded(int fieldNumber)
```
    Returns the loaded setting for the field of the managed object. Refer to the javadoc of isLoaded(PersistenceCapable, int);
    
    Specified by:
    
    isLoaded in interface ObjectProvider
    
    Parameters:
    fieldNumber - the absolute field number
    
    Returns:
    always returns true (this implementation)
  - isLoaded
```
public boolean isLoaded(javax.jdo.spi.PersistenceCapable pc,
               int fieldNumber)
```
    Return true if the field is cached in the calling instance. In this implementation, isLoaded() will 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 javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable 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
    
    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
    
    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
    
    Parameters:
    fieldNumber - Number of field
    value - New value
  - replaceField
```
protected void replaceField(javax.jdo.spi.PersistenceCapable 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 PersistenceCapable object associated with this StateManager.
    
    Specified by:
    
    replaceFields in interface ObjectProvider
    
    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 PersistenceCapable object associated with this StateManager.
    
    Specified by:
    
    replaceFields in interface ObjectProvider
    
    Specified by:
    
    replaceFields in class AbstractStateManager
    
    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 PersistenceCapable object associated with this StateManager. Only not loaded fields are refreshed
    
    Specified by:
    
    replaceNonLoadedFields in interface ObjectProvider
    
    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
  - replaceAllLoadedSCOFieldsWithValues
```
public void replaceAllLoadedSCOFieldsWithValues()
```
    Method to replace all loaded SCO fields that have wrappers with their value. If the loaded field doesnt have a SCO wrapper nothing happens to that field.
    
    Specified by:
    
    replaceAllLoadedSCOFieldsWithValues in interface ObjectProvider
  - unwrapSCOField
```
public Object unwrapSCOField(int fieldNumber,
                    Object value,
                    boolean replaceFieldIfChanged)
```
    Method to unwrap a SCO field (if it is wrapped currently). If the field is not a SCO field will just return the value. If "replaceFieldIfChanged" is set, we replace the value in the object with the unwrapped value.
    
    Specified by:
    
    unwrapSCOField in interface ObjectProvider
    
    Parameters:
    fieldNumber - The field number
    value - The value for the field
    replaceFieldIfChanged - Whether to replace the field value in the object if unwrapping the value
    
    Returns:
    The unwrapped field value
  - wrapSCOField
```
public Object wrapSCOField(int fieldNumber,
                  Object value,
                  boolean forInsert,
                  boolean forUpdate,
                  boolean replaceFieldIfChanged)
```
    Method to create a new SCO wrapper for the specified field. If the field is not a SCO field will just return the value.
    
    Specified by:
    
    wrapSCOField in interface ObjectProvider
    
    Parameters:
    fieldNumber - The field number
    value - The value to initialise the wrapper with (if any)
    forInsert - Whether the creation of any wrapper should insert this value into the datastore
    forUpdate - Whether the creation of any wrapper should update the datastore with this value
    replaceFieldIfChanged - Whether to replace the field in the object if wrapping the value
    
    Returns:
    The wrapper (or original value if not wrappable)
  - runReachability
```
public void runReachability(Set reachables)
```
    Method to mark an object for reachability. Provides the basis for "persistence-by-reachability", but run at commit time only. The reachability algorithm is also run at makePersistent, but directly via InsertRequest.
    
    Specified by:
    
    runReachability in interface ObjectProvider
    
    Parameters:
    reachables - List of object ids currently logged as reachable
  - makePersistent
```
public void makePersistent()
```
    Method to make the object persistent.
    
    Specified by:
    
    makePersistent in interface ObjectProvider
  - makeTransactional
```
public void makeTransactional()
```
    Method to change the object state to transactional.
    
    Specified by:
    
    makeTransactional in interface ObjectProvider
  - makeTransient
```
public void makeTransient(FetchPlanState state)
```
    Method to change the object state to transient.
    
    Specified by:
    
    makeTransient in interface ObjectProvider
    
    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
    
    Parameters:
    state - State for the detachment process
  - detachCopy
```
public Object 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
    
    Parameters:
    state - State for the detachment process
    
    Returns:
    the detached PersistenceCapable instance
  - getReferencedPC
```
public Object 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
    
    Returns:
    The referenced object (or null).
  - attach
```
public void attach(Object trans)
```
    Description copied from interface: ObjectProvider
    
    Method to attach the provided transient into the managed instance.
    
    Specified by:
    
    attach in interface ObjectProvider
    
    Parameters:
    trans - Transient object
  - attach
```
public void attach(boolean embedded)
```
    Method to attach the object managed by this StateManager.
    
    Specified by:
    
    attach in interface ObjectProvider
    
    Parameters:
    embedded - Whether it is embedded
  - attachCopy
```
public Object attachCopy(Object obj,
                boolean embedded)
```
    Method to attach a copy of the detached persistable instance and return the (attached) copy.
    
    Specified by:
    
    attachCopy in interface ObjectProvider
    
    Parameters:
    obj - the detached persistable instance to be attached
    embedded - Whether the object is stored embedded/serialised in another object
    
    Returns:
    The attached copy
  - deletePersistent
```
public void deletePersistent()
```
    Method to delete the object from persistence.
    
    Specified by:
    
    deletePersistent in interface ObjectProvider
  - nullifyFields
```
public void nullifyFields()
```
    Nullify fields with reference to PersistenceCapable or SCO instances
    
    Specified by:
    
    nullifyFields in interface ObjectProvider
  - validate
```
public void validate()
```
    Validates whether the persistence capable 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
  - 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.
    
    Specified by:
    
    postStateChange in class AbstractStateManager
  - preSerialize
```
public void preSerialize(javax.jdo.spi.PersistenceCapable pc)
```
    Guarantee that the serializable transactional and persistent fields are loaded into the instance. This method is called by the generated jdoPreSerialize method prior to serialization of the instance.
    
    Specified by:
    
    preSerialize in interface javax.jdo.spi.StateManager
    
    Parameters:
    pc - the calling PersistenceCapable instance
  - 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
  - registerTransactional
```
public void registerTransactional()
```
    Registers the pc class in the cache
    
    Specified by:
    
    registerTransactional in interface ObjectProvider
  - 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.
  - getEmbeddedOwners
```
public ObjectProvider[] getEmbeddedOwners()
```
    Accessor for the owning ObjectProviders for the managed object when stored embedded. Should really only have a single owner but users could, in principle, assign it to multiple. TODO Move this to ExecutionContext - need to update some store plugins
    
    Specified by:
    
    getEmbeddedOwners in interface ObjectProvider
    
    Returns:
    ObjectProviders owning this embedded object.
  - changeActivityState
```
public void changeActivityState(ActivityState state)
```
    Description copied from interface: ObjectProvider
    
    Update the acitvity state.
    
    Specified by:
    
    changeActivityState in interface ObjectProvider
    
    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
    
    Parameters:
    pc - The Persistable object
    fieldNumber - The no of field to mark as dirty.

Class JDOStateManager

Embedded/Serialised Objects

Performance and Memory

Field Summary

Fields inherited from class org.datanucleus.state.AbstractStateManager

Fields inherited from interface org.datanucleus.state.ObjectProvider

Constructor Summary

Method Summary

Methods inherited from class org.datanucleus.state.AbstractStateManager

Methods inherited from class java.lang.Object

Methods inherited from interface org.datanucleus.state.ObjectProvider

Field Detail

myPC

savedImage

Constructor Detail

JDOStateManager

Method Detail

connect

disconnect

initialiseForHollow

initialiseForHollowAppId

initialiseForHollowPreConstructed

initialiseForPersistentClean

initialiseForEmbedded

initialiseForPersistentNew

initialiseForTransactionalTransient

initialiseForDetached

initialiseForPNewToBeDeleted

initialiseForCachedPC

getObject

saveFields

clearSavedFields

restoreFields

enlistInTransaction

evictFromTransaction

replaceStateManager

replacingStateManager

replaceManagedPC

getPersistenceManager

isDirty

isTransactional

isPersistent

isNew

isDeleted

getVersion

getVersion

getTransactionalVersion

clearFields

clearNonPrimaryKeyFields

clearLoadedFlags

replacingFlags

providedBooleanField

providedByteField

providedCharField

providedDoubleField

providedFloatField

providedIntField

providedLongField

providedShortField

providedStringField

providedObjectField

provideField

provideField

provideFields

setBooleanField

setByteField

setCharField

setDoubleField

setFloatField

setIntField

setLongField

setShortField

setStringField

setObjectField

updateField

replacingBooleanField

replacingByteField

replacingCharField

replacingDoubleField

replacingFloatField