oracle.toplink.exceptions
Class OptimisticLockException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
oracle.toplink.exceptions.TopLinkException
oracle.toplink.exceptions.OptimisticLockException

All Implemented Interfaces:

java.io.Serializable

public class OptimisticLockException

extends TopLinkException

Purpose: This exception is used when TopLink's optimistic locking feature is used. It will be raised if the object being updated or deleted was changed or deleted from the database since it as last read.

See Also:

Serialized Form

Field Summary

static int	MUST_HAVE_MAPPING_WHEN_IN_OBJECT
static int	NEED_TO_MAP_JAVA_SQL_TIMESTAMP
static int	NO_VERSION_NUMBER_WHEN_DELETING
static int	NO_VERSION_NUMBER_WHEN_UPDATING
static int	OBJECT_CHANGED_SINCE_LAST_READ_WHEN_DELETING
static int	OBJECT_CHANGED_SINCE_LAST_READ_WHEN_UPDATING

Method Summary

java.lang.Object	getObject() PUBLIC: Return the object for which the problem was detected.
ObjectLevelModifyQuery	getQuery() PUBLIC: Return the query in which the problem was detected.
static OptimisticLockException	mustHaveMappingWhenStoredInObject(java.lang.Class aClass)
static OptimisticLockException	needToMapJavaSqlTimestampWhenStoredInObject()
static OptimisticLockException	noVersionNumberWhenDeleting(java.lang.Object object, ObjectLevelModifyQuery query)
static OptimisticLockException	noVersionNumberWhenUpdating(java.lang.Object object, ObjectLevelModifyQuery query)
static OptimisticLockException	objectChangedSinceLastReadWhenDeleting(java.lang.Object object, ObjectLevelModifyQuery query)
static OptimisticLockException	objectChangedSinceLastReadWhenUpdating(java.lang.Object object, ObjectLevelModifyQuery query)

Methods inherited from class oracle.toplink.exceptions.TopLinkException

getErrorCode, getInternalException, getMessage, getSession, printStackTrace, printStackTrace, printStackTrace, setShouldPrintInternalException

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, setStackTrace

Methods inherited from class java.lang.Object

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

Field Detail

NO_VERSION_NUMBER_WHEN_DELETING

public static final int NO_VERSION_NUMBER_WHEN_DELETING

See Also:

Constant Field Values

OBJECT_CHANGED_SINCE_LAST_READ_WHEN_DELETING

public static final int OBJECT_CHANGED_SINCE_LAST_READ_WHEN_DELETING

See Also:

Constant Field Values

NO_VERSION_NUMBER_WHEN_UPDATING

public static final int NO_VERSION_NUMBER_WHEN_UPDATING

See Also:

Constant Field Values

OBJECT_CHANGED_SINCE_LAST_READ_WHEN_UPDATING

public static final int OBJECT_CHANGED_SINCE_LAST_READ_WHEN_UPDATING

See Also:

Constant Field Values

MUST_HAVE_MAPPING_WHEN_IN_OBJECT

public static final int MUST_HAVE_MAPPING_WHEN_IN_OBJECT

See Also:

Constant Field Values

NEED_TO_MAP_JAVA_SQL_TIMESTAMP

public static final int NEED_TO_MAP_JAVA_SQL_TIMESTAMP

See Also:

Constant Field Values

Method Detail

getObject

public java.lang.Object getObject()

PUBLIC: Return the object for which the problem was detected.

getQuery

public ObjectLevelModifyQuery getQuery()

PUBLIC: Return the query in which the problem was detected.

mustHaveMappingWhenStoredInObject

public static OptimisticLockException mustHaveMappingWhenStoredInObject(java.lang.Class aClass)

noVersionNumberWhenDeleting

public static OptimisticLockException noVersionNumberWhenDeleting(java.lang.Object object,
                                                                  ObjectLevelModifyQuery query)

noVersionNumberWhenUpdating

public static OptimisticLockException noVersionNumberWhenUpdating(java.lang.Object object,
                                                                  ObjectLevelModifyQuery query)

objectChangedSinceLastReadWhenDeleting

public static OptimisticLockException objectChangedSinceLastReadWhenDeleting(java.lang.Object object,
                                                                             ObjectLevelModifyQuery query)

objectChangedSinceLastReadWhenUpdating

public static OptimisticLockException objectChangedSinceLastReadWhenUpdating(java.lang.Object object,
                                                                             ObjectLevelModifyQuery query)

needToMapJavaSqlTimestampWhenStoredInObject

public static OptimisticLockException needToMapJavaSqlTimestampWhenStoredInObject()