oracle.toplink.descriptors
Class ChangedFieldsLockingPolicy

java.lang.Object
oracle.toplink.descriptors.FieldsLockingPolicy
oracle.toplink.descriptors.ChangedFieldsLockingPolicy

All Implemented Interfaces:

java.lang.Cloneable, oracle.toplink.internal.descriptors.OptimisticLockingPolicy, java.io.Serializable

public class ChangedFieldsLockingPolicy

extends FieldsLockingPolicy

Purpose: An implementation of the OptimisticLockingPolicy interface. This policy compares only the changed fields in the WHERE clause when doing an update. If any field has been changed, an optimistic locking exception will be thrown. A delete will only compare the primary key.

NOTE: This policy can only be used inside a unit of work.

Since:

TopLink 2.1

See Also:

Serialized Form

Constructor Summary

ChangedFieldsLockingPolicy()
PUBLIC: Create a new changed fields locking policy.

Method Summary

void	addLockValuesToTranslationRow(ObjectLevelModifyQuery query) INTERNAL: Values to be included in the locking mechanism are added to the translation row.
Expression	buildDeleteExpression(oracle.toplink.internal.helper.DatabaseTable table, Expression mainExpression, DatabaseRow row) INTERNAL: When given an expression, this method will return a new expression with the optimistic locking values included.

Methods inherited from class oracle.toplink.descriptors.FieldsLockingPolicy

addLockFieldsToUpdateRow, buildUpdateExpression, clone, getValueToPutInCache, getVersionDifference, getWriteLockValue, initialize, initializeProperties, isChildWriteLockValueGreater, isChildWriteLockValueGreater, isNewerVersion, isNewerVersion, mergeIntoParentCache, registerObjectIntoParentCache, setDescriptor, setupWriteFieldsForInsert, updateRowAndObjectForUpdate, validateDelete, validateUpdate

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ChangedFieldsLockingPolicy

public ChangedFieldsLockingPolicy()

PUBLIC: Create a new changed fields locking policy. This locking policy is based on locking on all changed fields by comparing with their previous values to detect field-level collisions. Note: the unit of work must be used for all updates when using field locking. Without a unit of work, there is no way for TopLink to know what the original values were without the back up clone in the unit of work.

Method Detail

addLockValuesToTranslationRow

public void addLockValuesToTranslationRow(ObjectLevelModifyQuery query)

INTERNAL: Values to be included in the locking mechanism are added to the translation row. For changed fields the normal build row is ok as only changed fields matter.

Specified by:

addLockValuesToTranslationRow in interface oracle.toplink.internal.descriptors.OptimisticLockingPolicy

Specified by:

addLockValuesToTranslationRow in class FieldsLockingPolicy

buildDeleteExpression

public Expression buildDeleteExpression(oracle.toplink.internal.helper.DatabaseTable table,
Expression mainExpression,
DatabaseRow row)

INTERNAL: When given an expression, this method will return a new expression with the optimistic locking values included. The values are taken from the passed in database row. This expression will be used in a delete call. No new criteria will be added for changed fields.

Specified by:

buildDeleteExpression in interface oracle.toplink.internal.descriptors.OptimisticLockingPolicy

Overrides:

buildDeleteExpression in class FieldsLockingPolicy