org.hibernate.engine
Class Versioning
java.lang.Object
org.hibernate.engine.Versioning
public final class Versioning
extends java.lang.Object
Utilities for dealing with optimisitic locking values.
static Object | getVersion(Object[] fields, EntityPersister persister) - Extract the optimisitc locking value out of the entity state snapshot.
|
static Object | increment(Object version, VersionType versionType, SessionImplementor session) - Generate the next increment in the optimisitc locking value according
the
VersionType contract for the version property.
|
static boolean | isVersionIncrementRequired(int[] dirtyProperties, boolean hasDirtyCollections, boolean[] propertyVersionability) - Do we need to increment the version number, given the dirty properties?
|
static boolean | seedVersion(Object[] fields, int versionProperty, VersionType versionType, SessionImplementor session) - Create an initial optimisitc locking value according the
VersionType
contract for the version property if required and inject it into
the snapshot state.
|
static void | setVersion(Object[] fields, Object version, EntityPersister persister) - Inject the optimisitc locking value into the entity state snapshot.
|
OPTIMISTIC_LOCK_ALL
public static final int OPTIMISTIC_LOCK_ALL
Apply optimisitc locking based on the a current vs. snapshot comparison
of all properties.
OPTIMISTIC_LOCK_DIRTY
public static final int OPTIMISTIC_LOCK_DIRTY
Apply optimisitc locking based on the a current vs. snapshot comparison
of dirty properties.
OPTIMISTIC_LOCK_NONE
public static final int OPTIMISTIC_LOCK_NONE
Apply no optimistic locking
OPTIMISTIC_LOCK_VERSION
public static final int OPTIMISTIC_LOCK_VERSION
Apply optimisitc locking based on the defined version or timestamp
property.
getVersion
public static Object getVersion(Object[] fields,
EntityPersister persister)
Extract the optimisitc locking value out of the entity state snapshot.
fields
- The state snapshotpersister
- The entity persister
- The extracted optimisitc locking value
increment
public static Object increment(Object version,
VersionType versionType,
SessionImplementor session)
Generate the next increment in the optimisitc locking value according
the
VersionType
contract for the version property.
version
- The current versionversionType
- The version typesession
- The originating session
- The incremented optimistic locking value.
isVersionIncrementRequired
public static boolean isVersionIncrementRequired(int[] dirtyProperties,
boolean hasDirtyCollections,
boolean[] propertyVersionability)
Do we need to increment the version number, given the dirty properties?
dirtyProperties
- The array of property indexes which were deemed dirtyhasDirtyCollections
- Were any collections found to be dirty (structurally changed)propertyVersionability
- An array indicating versionability of each property.
- True if a version increment is required; false otherwise.
seedVersion
public static boolean seedVersion(Object[] fields,
int versionProperty,
VersionType versionType,
SessionImplementor session)
Create an initial optimisitc locking value according the
VersionType
contract for the version property
if required and inject it into
the snapshot state.
fields
- The current snapshot stateversionProperty
- The index of the version propertyversionType
- The version typesession
- The orginating session
- True if we injected a new version value into the fields array; false
otherwise.
setVersion
public static void setVersion(Object[] fields,
Object version,
EntityPersister persister)
Inject the optimisitc locking value into the entity state snapshot.
fields
- The state snapshotversion
- The optimisitc locking valuepersister
- The entity persister