Top Description Fields Constructors Methods

org.eclipse.persistence.exceptions

public Class OptimisticLockException

Class Inheritance

extends EclipseLinkException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
org.eclipse.persistence.exceptions.EclipseLinkException
org.eclipse.persistence.exceptions.OptimisticLockException

Imports

org.eclipse.persistence.queries.*, org.eclipse.persistence.exceptions.i18n.ExceptionMessageGenerator, org.eclipse.persistence.sessions.SessionProfiler, java.util.Vector

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.

Field Summary

Modifier and Type	Field and Description
public static final int	MUST_HAVE_MAPPING_WHEN_IN_OBJECT
public static final int	NEED_TO_MAP_JAVA_SQL_TIMESTAMP
public static final int	NO_VERSION_NUMBER_WHEN_DELETING
public static final int	NO_VERSION_NUMBER_WHEN_UPDATING
public static final int	OBJECT_CHANGED_SINCE_LAST_MERGE
public static final int	OBJECT_CHANGED_SINCE_LAST_READ_WHEN_DELETING
public static final int	OBJECT_CHANGED_SINCE_LAST_READ_WHEN_UPDATING
protected transient ObjectLevelModifyQuery	query Store the query that raised the optimistic violation.
public static final int	STATEMENT_NOT_EXECUTED_IN_BATCH
public static final int	UNWRAPPING_OBJECT_DELETED_SINCE_LAST_READ

Inherited from org.eclipse.persistence.exceptions.EclipseLinkException:: CR errorCode hasBeenLogged indentationString internalException session shouldPrintInternalException

Constructor Summary

Access	Constructor and Description
protected	OptimisticLockException() INTERNAL: EclipseLink exceptions should only be thrown by EclipseLink.
protected	OptimisticLockException(String theMessage) INTERNAL: EclipseLink exceptions should only be thrown by EclipseLink.
protected	OptimisticLockException(String theMessage, ObjectLevelModifyQuery query) INTERNAL: EclipseLink exceptions should only be thrown by EclipseLink.

Method Summary

Modifier and Type	Method and Description
public static OptimisticLockException	batchStatementExecutionFailure()
public Object	getObject() PUBLIC: Return the object for which the problem was detected.
public ObjectLevelModifyQuery	getQuery() PUBLIC: Return the query in which the problem was detected.
public static OptimisticLockException	mustHaveMappingWhenStoredInObject(Class<?> aClass)
public static OptimisticLockException	needToMapJavaSqlTimestampWhenStoredInObject()
public static OptimisticLockException	noVersionNumberWhenDeleting(Object object, ObjectLevelModifyQuery query)
public static OptimisticLockException	noVersionNumberWhenUpdating(Object object, ObjectLevelModifyQuery query)
public static OptimisticLockException	objectChangedSinceLastMerge(Object object)
public static OptimisticLockException	objectChangedSinceLastReadWhenDeleting(Object object, ObjectLevelModifyQuery query)
public static OptimisticLockException	objectChangedSinceLastReadWhenUpdating(Object object, ObjectLevelModifyQuery query)
public void	setQuery(ObjectLevelModifyQuery query) INTERNAL: Set the query in which the problem was detected.
public static OptimisticLockException	unwrappingObjectDeletedSinceLastRead(Vector<E> pkVector, String className)

Field Detail

MUST_HAVE_MAPPING_WHEN_IN_OBJECT	back to summary
public static final int MUST_HAVE_MAPPING_WHEN_IN_OBJECT

NEED_TO_MAP_JAVA_SQL_TIMESTAMP	back to summary
public static final int NEED_TO_MAP_JAVA_SQL_TIMESTAMP

NO_VERSION_NUMBER_WHEN_DELETING	back to summary
public static final int NO_VERSION_NUMBER_WHEN_DELETING

NO_VERSION_NUMBER_WHEN_UPDATING	back to summary
public static final int NO_VERSION_NUMBER_WHEN_UPDATING

OBJECT_CHANGED_SINCE_LAST_MERGE	back to summary
public static final int OBJECT_CHANGED_SINCE_LAST_MERGE

OBJECT_CHANGED_SINCE_LAST_READ_WHEN_DELETING	back to summary
public static final int OBJECT_CHANGED_SINCE_LAST_READ_WHEN_DELETING

OBJECT_CHANGED_SINCE_LAST_READ_WHEN_UPDATING	back to summary
public static final int OBJECT_CHANGED_SINCE_LAST_READ_WHEN_UPDATING

query	back to summary
protected transient ObjectLevelModifyQuery query Store the query that raised the optimistic violation.

STATEMENT_NOT_EXECUTED_IN_BATCH	back to summary
public static final int STATEMENT_NOT_EXECUTED_IN_BATCH

UNWRAPPING_OBJECT_DELETED_SINCE_LAST_READ	back to summary
public static final int UNWRAPPING_OBJECT_DELETED_SINCE_LAST_READ

Constructor Detail

OptimisticLockException	back to summary
protected OptimisticLockException() INTERNAL: EclipseLink exceptions should only be thrown by EclipseLink.

OptimisticLockException	back to summary
protected OptimisticLockException(String theMessage) INTERNAL: EclipseLink exceptions should only be thrown by EclipseLink.

OptimisticLockException	back to summary
protected OptimisticLockException(String theMessage, ObjectLevelModifyQuery query) INTERNAL: EclipseLink exceptions should only be thrown by EclipseLink.

Method Detail

batchStatementExecutionFailure	back to summary
public static OptimisticLockException batchStatementExecutionFailure()

getObject	back to summary
public Object getObject() PUBLIC: Return the object for which the problem was detected.

getQuery	back to summary
public ObjectLevelModifyQuery getQuery() PUBLIC: Return the query in which the problem was detected.

mustHaveMappingWhenStoredInObject	back to summary
public static OptimisticLockException mustHaveMappingWhenStoredInObject(Class<?> aClass)

needToMapJavaSqlTimestampWhenStoredInObject	back to summary
public static OptimisticLockException needToMapJavaSqlTimestampWhenStoredInObject()

noVersionNumberWhenDeleting	back to summary
public static OptimisticLockException noVersionNumberWhenDeleting(Object object, ObjectLevelModifyQuery query)

noVersionNumberWhenUpdating	back to summary
public static OptimisticLockException noVersionNumberWhenUpdating(Object object, ObjectLevelModifyQuery query)

objectChangedSinceLastMerge	back to summary
public static OptimisticLockException objectChangedSinceLastMerge(Object object)

objectChangedSinceLastReadWhenDeleting	back to summary
public static OptimisticLockException objectChangedSinceLastReadWhenDeleting(Object object, ObjectLevelModifyQuery query)

objectChangedSinceLastReadWhenUpdating	back to summary
public static OptimisticLockException objectChangedSinceLastReadWhenUpdating(Object object, ObjectLevelModifyQuery query)

setQuery	back to summary
public void setQuery(ObjectLevelModifyQuery query) INTERNAL: Set the query in which the problem was detected.

unwrappingObjectDeletedSinceLastRead	back to summary
public static OptimisticLockException unwrappingObjectDeletedSinceLastRead(Vector<E> pkVector, String className)