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

Service implementation for pessimistic locking

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected DataDictionaryService	dataDictionaryService
protected org.kuali.rice.krad.data.DataObjectService	dataObjectService
protected org.kuali.rice.kim.api.permission.PermissionService	permissionService
protected org.kuali.rice.kim.api.identity.PersonService	personService

Constructor Summary

Constructors

Constructor and Description
PessimisticLockServiceImpl()

Method Summary

Modifier and Type	Method and Description
protected void	checkExistingPessimisticLocks(Document document, List<String> userOwnedLockDescriptors, Map<String,Set<String>> otherOwnedLockDescriptors) Check to make sure that the current user doesn't erroneously share the same lock with another user.
protected PessimisticLock	createNewPessimisticLock(Document document, Map editMode, org.kuali.rice.kim.api.identity.Person user) Deprecated.
protected PessimisticLock	createNewPessimisticLock(Document document, org.kuali.rice.kim.api.identity.Person user) Creates a new PessimisticLock on a document for a user.
void	delete(String id)
Map	establishLocks(Document document, Map editMode, org.kuali.rice.kim.api.identity.Person user) Deprecated.
boolean	establishPessimisticLocks(Document document, org.kuali.rice.kim.api.identity.Person user, boolean canEdit)
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)
DataDictionaryService	getDataDictionaryService()
Set	getDocumentActions(Document document, org.kuali.rice.kim.api.identity.Person user, Set<String> documentActions) Deprecated.
protected Map	getEditModeWithEditableModesRemoved(Map currentEditMode) Deprecated.
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) Deprecated. Different mechanism of obtaining authorization in KRAD
protected boolean	isEntryEditMode(Map.Entry entry) Deprecated.
protected boolean	isLockRequiredByUser(Document document, Map editMode, org.kuali.rice.kim.api.identity.Person user) Deprecated.
boolean	isPessimisticLockAdminUser(org.kuali.rice.kim.api.identity.Person user)
protected boolean	isPessimisticLockNeeded(Document document, org.kuali.rice.kim.api.identity.Person user, boolean canEdit) Determines whether to add a pessimistic lock on the document for user based on the current pessimistic locks and edit modes.
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	setDataDictionaryService(DataDictionaryService dataDictionaryService)
void	setDataObjectService(org.kuali.rice.krad.data.DataObjectService dataObjectService)
protected boolean	usesPessimisticLocking(Document document) Deprecated.

Methods inherited from class java.lang.Object

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

Field Detail

dataObjectService

protected org.kuali.rice.krad.data.DataObjectService dataObjectService

dataDictionaryService

protected DataDictionaryService dataDictionaryService

permissionService

protected org.kuali.rice.kim.api.permission.PermissionService permissionService

personService

protected org.kuali.rice.kim.api.identity.PersonService personService

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)

establishPessimisticLocks

public boolean establishPessimisticLocks(Document document,
                                         org.kuali.rice.kim.api.identity.Person user,
                                         boolean canEdit)

Specified by:

establishPessimisticLocks in interface PessimisticLockService

isPessimisticLockNeeded

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

Determines whether to add a pessimistic lock on the document for user based on the current pessimistic locks and edit modes.

Parameters:

document - the document on which the locks will be established

user - the user for which the locks are being established

canEdit - whether the user currently can edit the document

Returns:

true if a pessimistic lock should be added, false otherwise

checkExistingPessimisticLocks

protected void checkExistingPessimisticLocks(Document document,
                                             List<String> userOwnedLockDescriptors,
                                             Map<String,Set<String>> otherOwnedLockDescriptors)

Check to make sure that the current user doesn't erroneously share the same lock with another user.

Parameters:

document - the document to check for erroneous locks

userOwnedLockDescriptors - the list of lock descriptors for the current user

otherOwnedLockDescriptors - the map of other lock descriptors to all of the other users that own them

createNewPessimisticLock

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

Creates a new PessimisticLock on a document for a user.

If the document uses custom lock descriptors, then the new lock is generated with a custom lock descriptor for a portion of the document. Otherwise, it will create a lock over the entire document.

Parameters:

document - the document on which the locks will be established

user - the user for which the locks are being established

Returns:

the newly created lock object

getDocumentActions

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

Deprecated.

Specified by:

getDocumentActions in interface PessimisticLockService

hasPreRouteEditAuthorization

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

Deprecated. Different mechanism of obtaining authorization in KRAD

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

@Deprecated
protected boolean usesPessimisticLocking(Document document)

Deprecated.

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

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

Deprecated.

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

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

Deprecated.

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

@Deprecated
protected Map getEditModeWithEditableModesRemoved(Map currentEditMode)

Deprecated.

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

@Deprecated
protected boolean isEntryEditMode(Map.Entry entry)

Deprecated.

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

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

Deprecated.

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

setDataDictionaryService

public void setDataDictionaryService(DataDictionaryService dataDictionaryService)

getPermissionService

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

setDataObjectService

public void setDataObjectService(org.kuali.rice.krad.data.DataObjectService dataObjectService)