|
EclipseLink 1.1.0_ 1.1.0.r3634 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 Form| Field 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.OptimisticLockingPolicypublic abstract void addLockValuesToTranslationRow(ObjectLevelModifyQuery query)
addLockValuesToTranslationRow in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicyprotected 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.OptimisticLockingPolicypublic java.lang.Object clone()
clone in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicyclone in class java.lang.Objectpublic 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.OptimisticLockingPolicyprotected 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.OptimisticLockingPolicypublic void initialize(org.eclipse.persistence.internal.sessions.AbstractSession session)
initialize in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicypublic void initializeProperties()
initializeProperties in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicypublic boolean isStoredInCache()
isStoredInCache in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicypublic 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.OptimisticLockingPolicyprotected 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.OptimisticLockingPolicyprotected void setAllNonPrimaryKeyFields(java.util.Vector allNonPrimaryKeyFields)
public void setDescriptor(ClassDescriptor descriptor)
setDescriptor in interface org.eclipse.persistence.internal.descriptors.OptimisticLockingPolicypublic 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.OptimisticLockingPolicyprotected void verifyUsage(org.eclipse.persistence.internal.sessions.AbstractSession session)
|
EclipseLink 1.1.0_ 1.1.0.r3634 API Reference | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||