org.broadleafcommerce.core.order.service

Interface OrderLockManager

public interface OrderLockManager

It is recommended to only allow one write operation on orders at a time. For example, if two add to cart operations for the same order came through at the same time, we would want to execute them serially and not in parallel. Implementations of this interface are responsible for maintaining the lock status for the given order.

Author:

Andre Azzolini (apazzolini)

Method Summary

Methods

Modifier and Type	Method and Description
Object	acquireLock(Order order) Blocks the requesting thread until able to acquire a lock for the given order.
void	releaseLock(Object lockObject) Releases the given lockObject and notifies any threads that are waiting on that object that they are able to attempt to acquire the lock.

Method Detail

acquireLock

Object acquireLock(Order order)

Blocks the requesting thread until able to acquire a lock for the given order. NOTE: Callers of this method MUST call releaseLock(Object), passing in the Object returned from this call once their critical section has executed. The suggested idiom for this operation is: Object lockObject = null; try { lockObject = orderLockManager.acquireLock(order); // Do something } finally { orderLockManager.releaseLock(lockObject); }

Parameters:

order -

Returns:

the lock object, which should be passed in as the parameter to releaseLock(Object) once the operation that required a lock has completed.

releaseLock

void releaseLock(Object lockObject)

Releases the given lockObject and notifies any threads that are waiting on that object that they are able to attempt to acquire the lock.

Parameters:

lockObject -