com.amazon.carbonado

Class OptimisticLockException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.amazon.carbonado.RepositoryException

com.amazon.carbonado.PersistException

com.amazon.carbonado.OptimisticLockException

All Implemented Interfaces:

java.io.Serializable

public class OptimisticLockException
extends PersistException

An OptimisticLockException is thrown if the Repository is using optimistic locking for concurrency control, and lock aquisition failed. This exception may also be thrown if multiversion concurrency control (MVCC) is being used and the commit fails.

Author:

Brian S O'Neill

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
OptimisticLockException()
OptimisticLockException(long expectedVersion)
OptimisticLockException(java.lang.Object expectedVersion)
OptimisticLockException(java.lang.Object expectedVersion, java.lang.Object savedVersion)
OptimisticLockException(java.lang.Object expectedVersion, java.lang.Object savedVersion, Storable s)
OptimisticLockException(java.lang.Object savedVersion, Storable s, java.lang.Object newVersion) Construct exception for when new version was expected to have increased.
OptimisticLockException(java.lang.String message)
OptimisticLockException(java.lang.String message, java.lang.Throwable cause)
OptimisticLockException(java.lang.Throwable cause)

Method Summary

Methods

Modifier and Type	Method and Description
Storable	getStorable() Returns the Storable which was acted upon, or null if not available.

Methods inherited from class com.amazon.carbonado.RepositoryException

backoff, getRootCause, makeFetchException, makePersistException, toFetchException, toFetchException, toPersistException, toPersistException

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, 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

Constructor Detail

OptimisticLockException

public OptimisticLockException()

OptimisticLockException

public OptimisticLockException(java.lang.String message)

OptimisticLockException

public OptimisticLockException(java.lang.String message,
                       java.lang.Throwable cause)

OptimisticLockException

public OptimisticLockException(java.lang.Throwable cause)

OptimisticLockException

public OptimisticLockException(long expectedVersion)

Parameters:

expectedVersion - version number that was expected for persistent record when update was executed

OptimisticLockException

public OptimisticLockException(java.lang.Object expectedVersion)

Parameters:

expectedVersion - version number that was expected for persistent record when update was executed

OptimisticLockException

public OptimisticLockException(java.lang.Object expectedVersion,
                       java.lang.Object savedVersion)

Parameters:

expectedVersion - version number that was expected for persistent record when update was executed

savedVersion - actual persistent version number of storable

OptimisticLockException

public OptimisticLockException(java.lang.Object expectedVersion,
                       java.lang.Object savedVersion,
                       Storable s)

Parameters:

expectedVersion - version number that was expected for persistent record when update was executed

savedVersion - actual persistent version number of storable

s - Storable which was acted upon

OptimisticLockException

public OptimisticLockException(java.lang.Object savedVersion,
                       Storable s,
                       java.lang.Object newVersion)

Construct exception for when new version was expected to have increased.

Parameters:

savedVersion - actual persistent version number of storable

s - Storable which was acted upon

newVersion - new version which was provided

Since:

1.2

Method Detail

getStorable

public Storable getStorable()

Returns the Storable which was acted upon, or null if not available.