org.axonframework.common.lock

Class PessimisticLockFactory

java.lang.Object

org.axonframework.common.lock.PessimisticLockFactory

All Implemented Interfaces:

LockFactory

public class PessimisticLockFactory
extends Object
implements LockFactory

Implementation of a LockFactory that uses a pessimistic locking strategy. Calls to obtainLock(java.lang.String) will block until a lock could be obtained. If a lock is obtained by a thread, that thread has guaranteed unique access.

Each thread can hold the same lock multiple times. The lock will only be released for other threads when the lock has been released as many times as it was obtained.

This lock can be used to ensure thread safe access to a number of objects, such as Aggregates and Sagas.

Since:

1.3

Author:

Allard Buijze

Constructor Summary

Constructors

Constructor and Description
PessimisticLockFactory() Creates a new IdentifierBasedLock instance.

Method Summary

Modifier and Type	Method and Description
Lock	obtainLock(String identifier) Obtain a lock for a resource identified by the given identifier.

Methods inherited from class java.lang.Object

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

Constructor Detail

PessimisticLockFactory

public PessimisticLockFactory()

Creates a new IdentifierBasedLock instance.

Deadlocks are detected across instances of the IdentifierBasedLock.

Method Detail

obtainLock

public Lock obtainLock(String identifier)

Obtain a lock for a resource identified by the given identifier. This method will block until a lock was successfully obtained.

Note: when an exception occurs during the locking process, the lock may or may not have been allocated.

Specified by:

obtainLock in interface LockFactory

Parameters:

identifier - the identifier of the lock to obtain.

Returns:

a handle to release the lock. If the thread that releases the lock does not hold the lock IllegalMonitorStateException is thrown