org.broadleafcommerce.common.util

Class OptimisticLockUtils

java.lang.Object

org.broadleafcommerce.common.util.OptimisticLockUtils

public class OptimisticLockUtils
extends Object

Utility class for operations on entities that support optimistic locking.

Author:

Philip Baggett (pbaggett)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	OptimisticLockUtils.UpdateOperation<T>

Constructor Summary

Constructors

Constructor and Description
OptimisticLockUtils()

Method Summary

Modifier and Type	Method and Description
protected static <T> T	doTransactionalOptimisticUpdate(String name, OptimisticLockUtils.UpdateOperation operation, T t, Object identifier, org.springframework.transaction.PlatformTransactionManager transactionManager, javax.persistence.EntityManager entityManager)
static <T> T	performOptimisticLockUpdate(String name, OptimisticLockUtils.UpdateOperation operation, T t, Object identifier, int maxRetryCount, org.springframework.transaction.PlatformTransactionManager transactionManager, javax.persistence.EntityManager entityManager) Perform an update on a entity that supports optimistic locking.

Methods inherited from class java.lang.Object

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

Constructor Detail

OptimisticLockUtils

public OptimisticLockUtils()

Method Detail

performOptimisticLockUpdate

public static <T> T performOptimisticLockUpdate(String name,
                                                OptimisticLockUtils.UpdateOperation operation,
                                                T t,
                                                Object identifier,
                                                int maxRetryCount,
                                                org.springframework.transaction.PlatformTransactionManager transactionManager,
                                                javax.persistence.EntityManager entityManager)
                                         throws OptimisticLockMaxRetryException

Perform an update on a entity that supports optimistic locking.

This method will read the entity from the database, perform the update operation provided, and attempt to commit the transaction. If the transaction cannot be committed due to an OptimisticLockException then the operation will be retried until maxRetryCount is reached.

Optimistic locking can be enabled on an entity by adding a variable with the Version annotation.

Throws:

OptimisticLockMaxRetryException - if an OptimisticLockException occurs maxRetryCount times.

doTransactionalOptimisticUpdate

protected static <T> T doTransactionalOptimisticUpdate(String name,
                                                       OptimisticLockUtils.UpdateOperation operation,
                                                       T t,
                                                       Object identifier,
                                                       org.springframework.transaction.PlatformTransactionManager transactionManager,
                                                       javax.persistence.EntityManager entityManager)