org.kuali.rice.krad.service.impl

Class PessimisticLockServiceImpl

java.lang.Object

org.kuali.rice.krad.service.impl.PessimisticLockServiceImpl

All Implemented Interfaces:

PessimisticLockService

@Transactional
public class PessimisticLockServiceImpl
extends Object
implements PessimisticLockService

This is a service implementation for pessimistic locking

Author:

Kuali Rice Team (rice.collab@kuali.org)

Constructor Summary

Constructors

Constructor and Description
PessimisticLockServiceImpl()

Method Summary

Modifier and Type	Method and Description
protected PessimisticLock	createNewPessimisticLock(Document document, Map editMode, org.kuali.rice.kim.api.identity.Person user) This method creates a new PessimisticLock object using the given document and user.
void	delete(String id)
Map	establishLocks(Document document, Map editMode, org.kuali.rice.kim.api.identity.Person user) This implementation will check the given document, editMode map, and user object to verify Pessimistic Locking.
void	establishWorkflowPessimisticLocking(Document document) This method creates a new PessimisticLock when Workflow processing requires one
PessimisticLock	generateNewLock(String documentNumber)
PessimisticLock	generateNewLock(String documentNumber, org.kuali.rice.kim.api.identity.Person user)
PessimisticLock	generateNewLock(String documentNumber, String lockDescriptor)
PessimisticLock	generateNewLock(String documentNumber, String lockDescriptor, org.kuali.rice.kim.api.identity.Person user)
BusinessObjectService	getBusinessObjectService()
DataDictionaryService	getDataDictionaryService()
Set	getDocumentActions(Document document, org.kuali.rice.kim.api.identity.Person user, Set<String> documentActions)
protected Map	getEditModeWithEditableModesRemoved(Map currentEditMode) This method is used to remove edit modes from the given map that allow the user to edit data on the document.
protected Map	getEntryEditModeReplacementMode(Map.Entry entry) This method is used to return values needed to replace the given 'entry type' edit mode Map.Entry with one that will not allow the user to enter data on the document
org.kuali.rice.kim.api.permission.PermissionService	getPermissionService()
org.kuali.rice.kim.api.identity.PersonService	getPersonService()
List<PessimisticLock>	getPessimisticLocksForDocument(String documentNumber)
List<PessimisticLock>	getPessimisticLocksForSession(String sessionId)
protected org.kuali.rice.kim.api.identity.Person	getWorkflowPessimisticLockOwnerUser() This method identifies the user that should be used to create and clear PessimisticLock objects required by Workflow. The default is the Kuali system user defined by RiceConstants#SYSTEM_USER.
protected boolean	hasPreRouteEditAuthorization(Document document, org.kuali.rice.kim.api.identity.Person user) This method checks to see that the given user has a lock on the document and return true if one is found.
protected boolean	isEntryEditMode(Map.Entry entry) This method is used to check if the given Map.Entry is an 'entry type' edit mode and that the value is set to signify that this user has that edit mode available to them
protected boolean	isLockRequiredByUser(Document document, Map editMode, org.kuali.rice.kim.api.identity.Person user) This method is used to check if the given parameters warrant a new lock to be created for the given user.
boolean	isPessimisticLockAdminUser(org.kuali.rice.kim.api.identity.Person user)
void	releaseAllLocksForUser(List<PessimisticLock> locks, org.kuali.rice.kim.api.identity.Person user)
void	releaseAllLocksForUser(List<PessimisticLock> locks, org.kuali.rice.kim.api.identity.Person user, String lockDescriptor)
void	releaseWorkflowPessimisticLocking(Document document) This method releases locks created via the establishWorkflowPessimisticLocking(Document) method for the given document
PessimisticLock	save(PessimisticLock lock)
void	setBusinessObjectService(BusinessObjectService businessObjectService)
protected boolean	usesPessimisticLocking(Document document)

Methods inherited from class java.lang.Object

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

Constructor Detail

PessimisticLockServiceImpl

public PessimisticLockServiceImpl()

Method Detail

delete

public void delete(String id)

Specified by:

delete in interface PessimisticLockService

See Also:

PessimisticLockService.delete(java.lang.String)

generateNewLock

public PessimisticLock generateNewLock(String documentNumber)

Specified by:

generateNewLock in interface PessimisticLockService

See Also:

PessimisticLockService.generateNewLock(String)

generateNewLock

public PessimisticLock generateNewLock(String documentNumber,
                                       String lockDescriptor)

Specified by:

generateNewLock in interface PessimisticLockService

See Also:

PessimisticLockService.generateNewLock(java.lang.String)

generateNewLock

public PessimisticLock generateNewLock(String documentNumber,
                                       org.kuali.rice.kim.api.identity.Person user)

Specified by:

generateNewLock in interface PessimisticLockService

See Also:

PessimisticLockService.generateNewLock(java.lang.String, org.kuali.rice.kim.api.identity.Person)

generateNewLock

public PessimisticLock generateNewLock(String documentNumber,
                                       String lockDescriptor,
                                       org.kuali.rice.kim.api.identity.Person user)

Specified by:

generateNewLock in interface PessimisticLockService

See Also:

PessimisticLockService.generateNewLock(java.lang.String, java.lang.String, org.kuali.rice.kim.api.identity.Person)

getPessimisticLocksForDocument

public List<PessimisticLock> getPessimisticLocksForDocument(String documentNumber)

Specified by:

getPessimisticLocksForDocument in interface PessimisticLockService

See Also:

PessimisticLockService.getPessimisticLocksForDocument(java.lang.String)

getPessimisticLocksForSession

public List<PessimisticLock> getPessimisticLocksForSession(String sessionId)

Specified by:

getPessimisticLocksForSession in interface PessimisticLockService

See Also:

PessimisticLockService.getPessimisticLocksForSession(java.lang.String)

isPessimisticLockAdminUser

public boolean isPessimisticLockAdminUser(org.kuali.rice.kim.api.identity.Person user)

Specified by:

isPessimisticLockAdminUser in interface PessimisticLockService

See Also:

PessimisticLockService.isPessimisticLockAdminUser(org.kuali.rice.kim.api.identity.Person)

releaseAllLocksForUser

public void releaseAllLocksForUser(List<PessimisticLock> locks,
                                   org.kuali.rice.kim.api.identity.Person user)

Specified by:

releaseAllLocksForUser in interface PessimisticLockService

See Also:

PessimisticLockService.releaseAllLocksForUser(java.util.List, org.kuali.rice.kim.api.identity.Person)

releaseAllLocksForUser

public void releaseAllLocksForUser(List<PessimisticLock> locks,
                                   org.kuali.rice.kim.api.identity.Person user,
                                   String lockDescriptor)

Specified by:

releaseAllLocksForUser in interface PessimisticLockService

See Also:

PessimisticLockService.releaseAllLocksForUser(java.util.List, org.kuali.rice.kim.api.identity.Person, java.lang.String)

save

public PessimisticLock save(PessimisticLock lock)

Specified by:

save in interface PessimisticLockService

See Also:

PessimisticLockService.save(org.kuali.rice.krad.document.authorization.PessimisticLock)

getBusinessObjectService

public BusinessObjectService getBusinessObjectService()

setBusinessObjectService

public void setBusinessObjectService(BusinessObjectService businessObjectService)

getDocumentActions

public Set getDocumentActions(Document document,
                              org.kuali.rice.kim.api.identity.Person user,
                              Set<String> documentActions)

Specified by:

getDocumentActions in interface PessimisticLockService

Parameters:

document -

user -

Returns:

Set of actions are permitted the given user on the given document

hasPreRouteEditAuthorization

protected boolean hasPreRouteEditAuthorization(Document document,
                                               org.kuali.rice.kim.api.identity.Person user)

This method checks to see that the given user has a lock on the document and return true if one is found.

Parameters:

document - - document to check

user - - current user

Returns:

true if the document is using Pessimistic Locking, the user has initiate authorization (see #hasInitiateAuthorization(Document, Person)), and the document has a lock owned by the given user. If the document is not using Pessimistic Locking the value returned will be that returned by #hasInitiateAuthorization(Document, Person).

usesPessimisticLocking

protected boolean usesPessimisticLocking(Document document)

establishWorkflowPessimisticLocking

public void establishWorkflowPessimisticLocking(Document document)

This method creates a new PessimisticLock when Workflow processing requires one

Specified by:

establishWorkflowPessimisticLocking in interface PessimisticLockService

Parameters:

document - - the document to create the lock against and add the lock to

See Also:

org.kuali.rice.kns.document.authorization.DocumentAuthorizer#establishWorkflowPessimisticLocking(org.kuali.rice.krad.document.Document)

releaseWorkflowPessimisticLocking

public void releaseWorkflowPessimisticLocking(Document document)

This method releases locks created via the establishWorkflowPessimisticLocking(Document) method for the given document

Specified by:

releaseWorkflowPessimisticLocking in interface PessimisticLockService

Parameters:

document - - document to release locks from

See Also:

org.kuali.rice.kns.document.authorization.DocumentAuthorizer#releaseWorkflowPessimisticLocking(org.kuali.rice.krad.document.Document)

getWorkflowPessimisticLockOwnerUser

protected org.kuali.rice.kim.api.identity.Person getWorkflowPessimisticLockOwnerUser()

This method identifies the user that should be used to create and clear PessimisticLock objects required by Workflow.

The default is the Kuali system user defined by RiceConstants#SYSTEM_USER. This method can be overriden by implementing documents if another user is needed.

Returns:

a valid Person object

establishLocks

public Map establishLocks(Document document,
                          Map editMode,
                          org.kuali.rice.kim.api.identity.Person user)

This implementation will check the given document, editMode map, and user object to verify Pessimistic Locking. If the given edit mode map contains an 'entry type' edit mode then the system will check the locks already in existence on the document. If a valid lock for the given user is found the system will return the given edit mode map. If a valid lock is found but is owned by another user the edit mode map returned will have any 'entry type' edit modes removed. If the given document has no locks and the edit mode map passed in has at least one 'entry type' mode then a new PessimisticLock object will be created and set on the document for the given user.

NOTE: This method is only called if the document uses pessimistic locking as described in the data dictionary file.

Specified by:

establishLocks in interface PessimisticLockService

See Also:

org.kuali.rice.kns.document.authorization.DocumentAuthorizer#establishLocks(org.kuali.rice.krad.document.Document, java.util.Map, org.kuali.rice.kim.api.identity.Person)

isLockRequiredByUser

protected boolean isLockRequiredByUser(Document document,
                                       Map editMode,
                                       org.kuali.rice.kim.api.identity.Person user)

This method is used to check if the given parameters warrant a new lock to be created for the given user. This method utilizes the isEntryEditMode(java.util.Map.Entry) method.

Parameters:

document - - document to verify lock creation against

editMode - - edit modes list to check for 'entry type' edit modes

user - - user the lock will be 'owned' by

Returns:

true if the given edit mode map has at least one 'entry type' edit mode... false otherwise

getEditModeWithEditableModesRemoved

protected Map getEditModeWithEditableModesRemoved(Map currentEditMode)

This method is used to remove edit modes from the given map that allow the user to edit data on the document. This method utilizes the isEntryEditMode(java.util.Map.Entry) method to identify if an edit mode is defined as an 'entry type' edit mode. It also uses the getEntryEditModeReplacementMode(java.util.Map.Entry) method to replace any 'entry type' edit modes it finds.

Parameters:

currentEditMode - - current set of edit modes the user has assigned to them

Returns:

an adjusted edit mode map where 'entry type' edit modes have been removed or replaced using the getEntryEditModeReplacementMode(java.util.Map.Entry) method

isEntryEditMode

protected boolean isEntryEditMode(Map.Entry entry)

This method is used to check if the given Map.Entry is an 'entry type' edit mode and that the value is set to signify that this user has that edit mode available to them

Parameters:

entry - - the Map.Entry object that contains an edit mode such as the ones returned but #getEditMode(Document, Person)

Returns:

true if the given entry has a key signifying an 'entry type' edit mode and the value is equal to #EDIT_MODE_DEFAULT_TRUE_VALUE... false if not

getEntryEditModeReplacementMode

protected Map getEntryEditModeReplacementMode(Map.Entry entry)

This method is used to return values needed to replace the given 'entry type' edit mode Map.Entry with one that will not allow the user to enter data on the document

Parameters:

entry - - the current 'entry type' edit mode to replace

Returns:

a Map of edit modes that will be used to replace this edit mode (represented by the given entry parameter)

createNewPessimisticLock

protected PessimisticLock createNewPessimisticLock(Document document,
                                                   Map editMode,
                                                   org.kuali.rice.kim.api.identity.Person user)

This method creates a new PessimisticLock object using the given document and user. If the document's useCustomLockDescriptors() method returns true then the new lock will also have a custom lock descriptor value set to the return value of the document's getCustomLockDescriptor(Person) method.

Parameters:

document - - document to place the lock on

editMode - - current edit modes for given user

user - - user who will 'own' the new lock object

Returns:

the newly created lock object

getPersonService

public org.kuali.rice.kim.api.identity.PersonService getPersonService()

getDataDictionaryService

public DataDictionaryService getDataDictionaryService()

getPermissionService

public org.kuali.rice.kim.api.permission.PermissionService getPermissionService()