JDO Interface

Detachable

This interface is implemented by classes that can be detached from the persistence context and later attached. The interface includes the contract by which the StateManager can set the object id, version, BitSet of loaded fields, and BitSet of modified fields so they are preserved while outside the persistence environment.

The detached state is stored as a field in each instance of Detachable. The field is serialized so as to maintain the state of the instance while detached. While detached, only the BitSet of modified fields will be modified. The structure of the Object[] jdoDetachedState is as follows:

  • jdoDetachedState[0]: the Object Id of the instance
  • jdoDetachedState[1]: the Version of the instance
  • jdoDetachedState[2]: a BitSet of loaded fields
  • jdoDetachedState[3]: a BitSet of modified fields
Since:
JDO 1.0

Public Methods

void jdoReplaceDetachedState()
This method calls the StateManager with the current detached state instance as a parameter and replaces the current detached state instance with the value provided by the StateManager.
Since:
JDO 2.0