Package org.apache.cayenne.access

Class OptimisticLockException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.cayenne.CayenneRuntimeException

org.apache.cayenne.access.OptimisticLockException

All Implemented Interfaces:

Serializable

public class OptimisticLockException
extends CayenneRuntimeException

An exception thrown on optimistic lock failure.

Since:

1.1

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected ObjectId	failedObjectId
protected Map	qualifierSnapshot
protected String	querySQL
protected DbEntity	rootEntity

Constructor Summary

Constructors

Constructor	Description
OptimisticLockException(ObjectId id, DbEntity rootEntity, String querySQL, Map qualifierSnapshot)

Method Summary

Modifier and Type	Method	Description
ObjectId	getFailedObjectId()	Returns the ObjectId of the object that caused the OptimisticLockException.
Map<?,?>	getFreshSnapshot(ObjectContext context)	Retrieves fresh snapshot for the failed row.
String	getMessage()	Returns descriptive message for this exception.
Map	getQualifierSnapshot()
String	getQuerySQL()

Methods inherited from class org.apache.cayenne.CayenneRuntimeException

getExceptionLabel, getUnlabeledMessage

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

failedObjectId

protected ObjectId failedObjectId

querySQL

protected String querySQL

rootEntity

protected DbEntity rootEntity

qualifierSnapshot

protected Map qualifierSnapshot

Constructor Details

OptimisticLockException

public OptimisticLockException(ObjectId id,
 DbEntity rootEntity,
 String querySQL,
 Map qualifierSnapshot)

Method Details

getQualifierSnapshot

public Map getQualifierSnapshot()

getQuerySQL

public String getQuerySQL()

getFreshSnapshot

public Map<?,?> getFreshSnapshot(ObjectContext context)

Retrieves fresh snapshot for the failed row. Null row indicates that it was deleted.

Since:

3.0

getMessage

public String getMessage()

Returns descriptive message for this exception.

Overrides:

getMessage in class CayenneRuntimeException

getFailedObjectId

public ObjectId getFailedObjectId()

Returns the ObjectId of the object that caused the OptimisticLockException.

Since:

3.1