org.kuali.rice.krad.service.impl

Class MaintenanceDocumentServiceImpl

java.lang.Object

org.kuali.rice.krad.service.impl.MaintenanceDocumentServiceImpl

All Implemented Interfaces:

MaintenanceDocumentService

public class MaintenanceDocumentServiceImpl
extends Object
implements MaintenanceDocumentService

Service implementation for the MaintenanceDocument structure. This is the default implementation, that is delivered with Kuali

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.apache.log4j.Logger	LOG

Constructor Summary

Constructors

Constructor and Description
MaintenanceDocumentServiceImpl()

Method Summary

Modifier and Type	Method and Description
protected Map<String,String>	buildKeyMapFromRequest(Map<String,String[]> requestParameters, Class<?> dataObjectClass) Based on the maintenance object class retrieves the key field names from the BusinessObjectMetaDataService (or alternatively from the request parameters), then retrieves any matching key value pairs from the request parameters
protected void	checkMaintenanceActionAuthorization(MaintenanceDocument document, Object oldBusinessObject, String maintenanceAction, Map<String,String[]> requestParameters) For the edit and delete maintenance actions checks with the BusinessObjectAuthorizationService to check whether the action is allowed for the record data.
protected void	clearPrimaryKeyFields(Object maintenanceObject, Class<?> dataObjectClass) Clears the value of the primary key fields on the maintenance object
protected void	clearUnauthorizedNewFields(MaintenanceDocument document) Used as part of the Copy functionality, to clear any field values that the user making the copy does not have permissions to modify.
void	deleteLocks(String documentNumber)
protected DataObjectAuthorizationService	getDataObjectAuthorizationService()
protected DataObjectMetaDataService	getDataObjectMetaDataService()
DocumentDictionaryService	getDocumentDictionaryService()
protected DocumentService	getDocumentService()
String	getLockingDocumentId(Maintainable maintainable, String documentNumber)
String	getLockingDocumentId(MaintenanceDocument document)
MaintenanceDocumentDao	getMaintenanceDocumentDao()
protected void	populateMaintenanceObjectWithCopyKeyValues(Map<String,String> parameters, Object oldBusinessObject, Maintainable oldMaintainableObject) Looks for a special request parameters giving the names of the keys that should be retrieved from the request parameters and copied to the maintenance object
protected void	processMaintenanceObjectForCopy(MaintenanceDocument document, Object maintenanceObject, Map<String,String[]> requestParameters) For the copy action clears out primary key values for the old record and does authorization checks on the remaining fields.
protected Object	retrieveObjectForMaintenance(MaintenanceDocument document, Map<String,String[]> requestParameters) For the edit or copy actions retrieves the record that is to be maintained
void	setDataObjectAuthorizationService(DataObjectAuthorizationService dataObjectAuthorizationService)
void	setDataObjectMetaDataService(DataObjectMetaDataService dataObjectMetaDataService)
void	setDocumentDictionaryService(DocumentDictionaryService documentDictionaryService)
void	setDocumentService(DocumentService documentService)
void	setMaintenanceDocumentDao(MaintenanceDocumentDao maintenanceDocumentDao)
void	setupMaintenanceObject(MaintenanceDocument document, String maintenanceAction, Map<String,String[]> requestParameters)
MaintenanceDocument	setupNewMaintenanceDocument(String objectClassName, String documentTypeName, String maintenanceAction)
void	storeLocks(List<MaintenanceLock> maintenanceLocks)

Methods inherited from class java.lang.Object

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

Field Detail

LOG

protected static final org.apache.log4j.Logger LOG

Constructor Detail

MaintenanceDocumentServiceImpl

public MaintenanceDocumentServiceImpl()

Method Detail

setupNewMaintenanceDocument

public MaintenanceDocument setupNewMaintenanceDocument(String objectClassName,
                                                       String documentTypeName,
                                                       String maintenanceAction)

Specified by:

setupNewMaintenanceDocument in interface MaintenanceDocumentService

See Also:

MaintenanceDocumentService.setupNewMaintenanceDocument(java.lang.String, java.lang.String, java.lang.String)

setupMaintenanceObject

public void setupMaintenanceObject(MaintenanceDocument document,
                                   String maintenanceAction,
                                   Map<String,String[]> requestParameters)

Specified by:

setupMaintenanceObject in interface MaintenanceDocumentService

See Also:

setupMaintenanceObject(org.kuali.rice.krad.maintenance.MaintenanceDocument, java.lang.String, java.util.Map<java.lang.String, java.lang.String[]>)

checkMaintenanceActionAuthorization

protected void checkMaintenanceActionAuthorization(MaintenanceDocument document,
                                                   Object oldBusinessObject,
                                                   String maintenanceAction,
                                                   Map<String,String[]> requestParameters)

For the edit and delete maintenance actions checks with the BusinessObjectAuthorizationService to check whether the action is allowed for the record data. In action is allowed invokes the custom processing hook on the Maintainble.

Parameters:

document - - document instance for the maintenance object

oldBusinessObject - - the old maintenance record

maintenanceAction - - type of maintenance action requested

requestParameters - - map of parameters from the request

retrieveObjectForMaintenance

protected Object retrieveObjectForMaintenance(MaintenanceDocument document,
                                              Map<String,String[]> requestParameters)

For the edit or copy actions retrieves the record that is to be maintained

Based on the persistence metadata for the maintenance object class retrieves the primary key values from the given request parameters map (if the class is persistable). With those key values attempts to find the record using the LookupService.

Parameters:

document - - document instance for the maintenance object

requestParameters - - Map of parameters from the request

Returns:

Object the retrieved old object

processMaintenanceObjectForCopy

protected void processMaintenanceObjectForCopy(MaintenanceDocument document,
                                               Object maintenanceObject,
                                               Map<String,String[]> requestParameters)

For the copy action clears out primary key values for the old record and does authorization checks on the remaining fields. Also invokes the custom processing method on the Maintainble

Parameters:

document - - document instance for the maintenance object

maintenanceObject - - the object instance being maintained

requestParameters - - map of parameters from the request

clearPrimaryKeyFields

protected void clearPrimaryKeyFields(Object maintenanceObject,
                                     Class<?> dataObjectClass)

Clears the value of the primary key fields on the maintenance object

Parameters:

document - - document to clear the pk fields on

dataObjectClass - - class to use for retrieving primary key metadata

clearUnauthorizedNewFields

protected void clearUnauthorizedNewFields(MaintenanceDocument document)

Used as part of the Copy functionality, to clear any field values that the user making the copy does not have permissions to modify. This will prevent authorization errors on a copy.

Parameters:

document - - document to be adjusted

buildKeyMapFromRequest

protected Map<String,String> buildKeyMapFromRequest(Map<String,String[]> requestParameters,
                                                    Class<?> dataObjectClass)

Based on the maintenance object class retrieves the key field names from the BusinessObjectMetaDataService (or alternatively from the request parameters), then retrieves any matching key value pairs from the request parameters

Parameters:

requestParameters - - map of parameters from the request

dataObjectClass - - class to use for checking security parameter restrictions

Returns:

Map key value pairs

populateMaintenanceObjectWithCopyKeyValues

protected void populateMaintenanceObjectWithCopyKeyValues(Map<String,String> parameters,
                                                          Object oldBusinessObject,
                                                          Maintainable oldMaintainableObject)

Looks for a special request parameters giving the names of the keys that should be retrieved from the request parameters and copied to the maintenance object

Parameters:

parameters - - map of parameters from the request

oldBusinessObject - - the old maintenance object

oldMaintainableObject - - the old maintainble object (used to get object class for security checks)

getLockingDocumentId

public String getLockingDocumentId(MaintenanceDocument document)

Specified by:

getLockingDocumentId in interface MaintenanceDocumentService

See Also:

MaintenanceDocumentService.getLockingDocumentId(org.kuali.rice.krad.maintenance.MaintenanceDocument)

getLockingDocumentId

public String getLockingDocumentId(Maintainable maintainable,
                                   String documentNumber)

Specified by:

getLockingDocumentId in interface MaintenanceDocumentService

See Also:

MaintenanceDocumentService.getLockingDocumentId(org.kuali.rice.krad.maintenance.Maintainable, java.lang.String)

deleteLocks

public void deleteLocks(String documentNumber)

Specified by:

deleteLocks in interface MaintenanceDocumentService

See Also:

MaintenanceDocumentService.deleteLocks(String)

storeLocks

public void storeLocks(List<MaintenanceLock> maintenanceLocks)

Specified by:

storeLocks in interface MaintenanceDocumentService

See Also:

org.kuali.rice.krad.service.MaintenanceDocumentService#saveLocks(List)

getMaintenanceDocumentDao

public MaintenanceDocumentDao getMaintenanceDocumentDao()

setMaintenanceDocumentDao

public void setMaintenanceDocumentDao(MaintenanceDocumentDao maintenanceDocumentDao)

getDataObjectAuthorizationService

protected DataObjectAuthorizationService getDataObjectAuthorizationService()

setDataObjectAuthorizationService

public void setDataObjectAuthorizationService(DataObjectAuthorizationService dataObjectAuthorizationService)

getDocumentService

protected DocumentService getDocumentService()

setDocumentService

public void setDocumentService(DocumentService documentService)

getDataObjectMetaDataService

protected DataObjectMetaDataService getDataObjectMetaDataService()

setDataObjectMetaDataService

public void setDataObjectMetaDataService(DataObjectMetaDataService dataObjectMetaDataService)

getDocumentDictionaryService

public DocumentDictionaryService getDocumentDictionaryService()

setDocumentDictionaryService

public void setDocumentDictionaryService(DocumentDictionaryService documentDictionaryService)