|
EclipseLink 1.1.4, build 'v20100812-r7860' API Reference | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.persistence.descriptors.FieldsLockingPolicy
public abstract class FieldsLockingPolicy
Purpose: An abstract superclass of some implementations of the OptimisticLockingPolicy interface. All of the subclasses of this class implement OptimisticLocking based on mapped fields in the object. These fields are only compared and not modified. Any modification (incrementing etc..) must be handled by the application.
AllFieldsLockingPolicy
,
ChangedFieldsLockingPolicy
,
SelectedFieldsLockingPolicy
,
Serialized FormField Summary | |
---|---|
protected java.util.Vector |
allNonPrimaryKeyFields
|
protected ClassDescriptor |
descriptor
|
Constructor Summary | |
---|---|
FieldsLockingPolicy()
PUBLIC: Create a new field locking policy. |
Method Summary | |
---|---|
void |
addLockFieldsToUpdateRow(org.eclipse.persistence.internal.sessions.AbstractRecord Record,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Add update fields for template row. |
abstract void |
addLockValuesToTranslationRow(ObjectLevelModifyQuery query)
INTERNAL: Values to be included in the locking mechanism are added to the translation row. |
protected java.util.Vector |
buildAllNonPrimaryKeyFields()
INTERNAL: Returns the fields that should be compared in the where clause. |
Expression |
buildDeleteExpression(org.eclipse.persistence.internal.helper.DatabaseTable table,
Expression mainExpression,
org.eclipse.persistence.internal.sessions.AbstractRecord row)
INTERNAL: When given an expression, this method will return a new expression with the optimistic locking values included. |
protected Expression |
buildExpression(org.eclipse.persistence.internal.helper.DatabaseTable table,
org.eclipse.persistence.internal.sessions.AbstractRecord transRow,
org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow,
ExpressionBuilder builder)
INTERNAL: returns the expression to be used in both the delete and update where clause. |
Expression |
buildUpdateExpression(org.eclipse.persistence.internal.helper.DatabaseTable table,
Expression mainExpression,
org.eclipse.persistence.internal.sessions.AbstractRecord transRow,
org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow)
INTERNAL: This method must be included in any locking policy. |
java.lang.Object |
clone()
INTERNAL: Clone the policy |
int |
compareWriteLockValues(java.lang.Object value1,
java.lang.Object value2)
INTERNAL: This method shouldn't be called if supportsWriteLockValuesComparison() returns false. |
protected java.util.Vector |
getAllNonPrimaryKeyFields()
INTERNAL: Returns the fields that should be compared in the where clause. |
protected java.util.Vector |
getAllNonPrimaryKeyFields(org.eclipse.persistence.internal.helper.DatabaseTable table)
INTERNAL: filter the fields based on the passed in table. |
java.lang.Object |
getBaseValue()
INTERNAL: This is the base value that is older than all other values, it is used in the place of null in some situations. |
protected abstract java.util.Vector |
getFieldsToCompare(org.eclipse.persistence.internal.helper.DatabaseTable table,
org.eclipse.persistence.internal.sessions.AbstractRecord transRow,
org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow)
INTERNAL: Returns the fields that should be compared in the where clause. |
java.lang.Object |
getValueToPutInCache(org.eclipse.persistence.internal.sessions.AbstractRecord row,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Return the value that should be stored in the identity map. |
int |
getVersionDifference(java.lang.Object currentValue,
java.lang.Object domainObject,
java.util.Vector primaryKeys,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Return the number of version difference between the two states of the object. |
org.eclipse.persistence.internal.helper.DatabaseField |
getWriteLockField()
INTERNAL: Return the write lock field. |
Expression |
getWriteLockUpdateExpression(ExpressionBuilder builder,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: |
java.lang.Object |
getWriteLockValue(java.lang.Object domainObject,
java.util.Vector primaryKey,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: This method will return the optimistic lock value for the object |
void |
initialize(org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: It is responsible for initializing the policy; |
void |
initializeProperties()
INTERNAL: It is responsible for initializing the policy; |
boolean |
isCascaded()
PUBLIC: Return true if the policy uses cascade locking. |
boolean |
isChildWriteLockValueGreater(org.eclipse.persistence.internal.sessions.AbstractSession session,
java.util.Vector primaryKey,
java.lang.Class original,
org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet)
INTERNAL: |
boolean |
isNewerVersion(org.eclipse.persistence.internal.sessions.AbstractRecord Record,
java.lang.Object domainObject,
java.util.Vector primaryKey,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Compares the value from the row and from the object (or cache). |
boolean |
isNewerVersion(java.lang.Object currentValue,
java.lang.Object domainObject,
java.util.Vector primaryKey,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: Compares the value and the value from the object (or cache). |
protected boolean |
isPrimaryKey(org.eclipse.persistence.internal.helper.DatabaseField dbField)
INTERNAL: Returns whether or not this field is a primary key. |
boolean |
isStoredInCache()
PUBLIC: Return true if the lock value is stored in the cache. |
void |
mergeIntoParentCache(org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow,
java.util.Vector primaryKey,
java.lang.Object object)
INTERNAL: Only applicable when the value is stored in the cache. |
protected void |
setAllNonPrimaryKeyFields(java.util.Vector allNonPrimaryKeyFields)
INTERNAL: Set method for all the primary keys |
void |
setDescriptor(ClassDescriptor descriptor)
INTERNAL: Set method for the descriptor |
void |
setupWriteFieldsForInsert(ObjectLevelModifyQuery query)
INTERNAL: Put the initial writelock value into the modifyRow. |
boolean |
supportsWriteLockValuesComparison()
INTERNAL: Indicates whether compareWriteLockValues method is supported by the policy. |
void |
updateRowAndObjectForUpdate(ObjectLevelModifyQuery query,
java.lang.Object domainObject)
INTERNAL: Nothing to do because all updates are handled by the application |
void |
validateDelete(int rowCount,
java.lang.Object object,
DeleteObjectQuery query)
INTERNAL: Check the row count for lock failure. |
void |
validateUpdate(int rowCount,
java.lang.Object object,
WriteObjectQuery query)
INTERNAL: Check the row count for lock failure. |
protected void |
verifyUsage(org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: throw an exception if not inside a unit of work at this point |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected ClassDescriptor descriptor
protected java.util.Vector allNonPrimaryKeyFields
Constructor Detail |
---|
public FieldsLockingPolicy()
Method Detail |
---|
public void addLockFieldsToUpdateRow(org.eclipse.persistence.internal.sessions.AbstractRecord Record, org.eclipse.persistence.internal.sessions.AbstractSession session)
addLockFieldsToUpdateRow
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public abstract void addLockValuesToTranslationRow(ObjectLevelModifyQuery query)
addLockValuesToTranslationRow
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
protected java.util.Vector buildAllNonPrimaryKeyFields()
public Expression buildDeleteExpression(org.eclipse.persistence.internal.helper.DatabaseTable table, Expression mainExpression, org.eclipse.persistence.internal.sessions.AbstractRecord row)
buildDeleteExpression
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
protected Expression buildExpression(org.eclipse.persistence.internal.helper.DatabaseTable table, org.eclipse.persistence.internal.sessions.AbstractRecord transRow, org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow, ExpressionBuilder builder)
public Expression buildUpdateExpression(org.eclipse.persistence.internal.helper.DatabaseTable table, Expression mainExpression, org.eclipse.persistence.internal.sessions.AbstractRecord transRow, org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow)
buildUpdateExpression
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public java.lang.Object clone()
clone
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
clone
in class java.lang.Object
public boolean supportsWriteLockValuesComparison()
supportsWriteLockValuesComparison
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public int compareWriteLockValues(java.lang.Object value1, java.lang.Object value2)
compareWriteLockValues
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
protected java.util.Vector getAllNonPrimaryKeyFields()
protected java.util.Vector getAllNonPrimaryKeyFields(org.eclipse.persistence.internal.helper.DatabaseTable table)
public java.lang.Object getBaseValue()
getBaseValue
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
protected abstract java.util.Vector getFieldsToCompare(org.eclipse.persistence.internal.helper.DatabaseTable table, org.eclipse.persistence.internal.sessions.AbstractRecord transRow, org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow)
public org.eclipse.persistence.internal.helper.DatabaseField getWriteLockField()
getWriteLockField
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public Expression getWriteLockUpdateExpression(ExpressionBuilder builder, org.eclipse.persistence.internal.sessions.AbstractSession session)
getWriteLockUpdateExpression
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public java.lang.Object getValueToPutInCache(org.eclipse.persistence.internal.sessions.AbstractRecord row, org.eclipse.persistence.internal.sessions.AbstractSession session)
getValueToPutInCache
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public int getVersionDifference(java.lang.Object currentValue, java.lang.Object domainObject, java.util.Vector primaryKeys, org.eclipse.persistence.internal.sessions.AbstractSession session)
getVersionDifference
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public java.lang.Object getWriteLockValue(java.lang.Object domainObject, java.util.Vector primaryKey, org.eclipse.persistence.internal.sessions.AbstractSession session)
getWriteLockValue
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public void initialize(org.eclipse.persistence.internal.sessions.AbstractSession session)
initialize
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public void initializeProperties()
initializeProperties
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public boolean isStoredInCache()
isStoredInCache
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public boolean isCascaded()
isCascaded
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public boolean isChildWriteLockValueGreater(org.eclipse.persistence.internal.sessions.AbstractSession session, java.util.Vector primaryKey, java.lang.Class original, org.eclipse.persistence.internal.sessions.ObjectChangeSet changeSet)
isChildWriteLockValueGreater
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public boolean isNewerVersion(java.lang.Object currentValue, java.lang.Object domainObject, java.util.Vector primaryKey, org.eclipse.persistence.internal.sessions.AbstractSession session)
isNewerVersion
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public boolean isNewerVersion(org.eclipse.persistence.internal.sessions.AbstractRecord Record, java.lang.Object domainObject, java.util.Vector primaryKey, org.eclipse.persistence.internal.sessions.AbstractSession session)
isNewerVersion
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
protected boolean isPrimaryKey(org.eclipse.persistence.internal.helper.DatabaseField dbField)
public void mergeIntoParentCache(org.eclipse.persistence.internal.sessions.UnitOfWorkImpl uow, java.util.Vector primaryKey, java.lang.Object object)
mergeIntoParentCache
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
protected void setAllNonPrimaryKeyFields(java.util.Vector allNonPrimaryKeyFields)
public void setDescriptor(ClassDescriptor descriptor)
setDescriptor
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public void setupWriteFieldsForInsert(ObjectLevelModifyQuery query)
setupWriteFieldsForInsert
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public void updateRowAndObjectForUpdate(ObjectLevelModifyQuery query, java.lang.Object domainObject)
updateRowAndObjectForUpdate
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public void validateDelete(int rowCount, java.lang.Object object, DeleteObjectQuery query)
validateDelete
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
public void validateUpdate(int rowCount, java.lang.Object object, WriteObjectQuery query)
validateUpdate
in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicy
protected void verifyUsage(org.eclipse.persistence.internal.sessions.AbstractSession session)
|
EclipseLink 1.1.4, build 'v20100812-r7860' API Reference | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |