sirius.db.mixing

Class OptimisticLockException

java.lang.Object

java.lang.Throwable

java.lang.Exception

sirius.db.mixing.OptimisticLockException

All Implemented Interfaces:

Serializable

public class OptimisticLockException
extends Exception

Signals that a concurrent modification occured on an versioned entity which supports optimistic locking.

In contrast to pessimistic locking, optimistic locking does not acquire any locks or perform other measures to quarantee mutual exclusion. Rather it keepts track of the entity version it last read from the database and upon a modification, it expects the entity version in the database to remain the same.

Once a modification is performed, the version is then incremented. If the expected version does not match the actual version, the operation is aborted and an OptimisticLockException is thrown.

This yields is a highly performant and highly scaleble system as long as concurrent modifications are rare. The downsice of this approach is, that modification have to be retried once an error is detected. However most of the time this overhead is quite bearable.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
OptimisticLockException() Creates a new instance without any reference to another error.
OptimisticLockException(String message, Throwable cause) Creates a new instance with a reference to the given cause.

Method Summary

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()

Creates a new instance without any reference to another error.

OptimisticLockException

public OptimisticLockException(String message,
                               Throwable cause)

Creates a new instance with a reference to the given cause.

Parameters:

message - the message to show

cause - the cuase of this error