org.kuali.ole

Class OleLookupableImpl

java.lang.Object

org.kuali.rice.krad.uif.service.impl.ViewHelperServiceImpl

org.kuali.ole.OleLookupableImpl

All Implemented Interfaces:

Serializable, org.kuali.rice.krad.lookup.Lookupable, org.kuali.rice.krad.uif.service.ViewHelperService

Direct Known Subclasses:

OleItemSearchLookupableImpl, OlePatronEnitityLookupableImpl, OlePatronLookupableImpl, OLEPurchaseOrderItemLookupableHelperServiceImpl

public class OleLookupableImpl
extends org.kuali.rice.krad.uif.service.impl.ViewHelperServiceImpl
implements org.kuali.rice.krad.lookup.Lookupable

Created by pvsubrah on 5/5/14.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
OleLookupableImpl()

Method Summary

Methods

Modifier and Type	Method and Description
protected Map<String,String>	adjustCriteriaForNestedEBOs(Map<String,String> searchCriteria, boolean unbounded)
boolean	allowsMaintenanceDeleteAction(Object dataObject) Determines if given data object has associated maintenance document that allows delete maintenance actions.
boolean	allowsMaintenanceEditAction(Object dataObject) Determines if given data object has associated maintenance document that allows edit maintenance actions
boolean	allowsMaintenanceNewOrCopyAction() Determines if given data object has associated maintenance document that allows new or copy maintenance actions
void	generateErrorMessageForResults(org.kuali.rice.krad.web.form.LookupForm form, String messageToDisplay) Convenience method for setting an error message on the lookup results section
protected void	generateLookupResultsMessages(org.kuali.rice.krad.web.form.LookupForm form, Map<String,String> searchCriteria, Collection<?> searchResult, boolean unbounded) Helper function to render lookup results messages
protected String	getActionUrlHref(org.kuali.rice.krad.web.form.LookupForm lookupForm, Object dataObject, String methodToCall, List<String> pkNames) Generates a URL to perform a maintenance action on the given result data object
protected Map<String,org.kuali.rice.krad.uif.field.InputField>	getCriteriaFieldsForValidation(org.kuali.rice.krad.uif.view.LookupView lookupView, org.kuali.rice.krad.web.form.LookupForm form) Returns the criteria fields in a map keyed by the field property name.
protected org.kuali.rice.krad.service.DataObjectAuthorizationService	getDataObjectAuthorizationService()
Class<?>	getDataObjectClass()
protected org.kuali.rice.krad.service.DataObjectMetaDataService	getDataObjectMetaDataService()
org.kuali.rice.krad.service.DocumentDictionaryService	getDocumentDictionaryService()
protected org.kuali.rice.core.api.encryption.EncryptionService	getEncryptionService()
protected org.kuali.rice.krad.service.LookupService	getLookupService()
void	getMaintenanceActionLink(org.kuali.rice.krad.uif.element.Action actionLink, Object model, String maintenanceMethodToCall)
protected String	getMaintenanceDocumentTypeName() Returns the maintenance document type associated with the business object class or null if one does not exist.
Map<String,String>	getPropertyKeyValuesFromDataObject(List<String> propertyNames, Object dataObject)
protected List<String>	getReturnKeys(org.kuali.rice.krad.uif.view.LookupView lookupView, org.kuali.rice.krad.web.form.LookupForm lookupForm, Object dataObject) Returns the configured return key property names or if not configured defaults to the primary keys for the data object class
protected String	getReturnUrl(org.kuali.rice.krad.uif.view.LookupView lookupView, org.kuali.rice.krad.web.form.LookupForm lookupForm, Object dataObject) Builds the URL for returning the given data object result row
void	getReturnUrlForResults(org.kuali.rice.krad.uif.element.Action returnLink, Object model)
protected Properties	getReturnUrlParameters(org.kuali.rice.krad.uif.view.LookupView lookupView, org.kuali.rice.krad.web.form.LookupForm lookupForm, Object dataObject) Builds up a Properties object that will be used to provide the request parameters for the return URL link
protected List<?>	getSearchResults(org.kuali.rice.krad.web.form.LookupForm form, Map<String,String> searchCriteria, boolean unbounded) Get the search results of the lookup
protected List<?>	getSearchResultsForEBO(Map<String,String> searchCriteria, boolean unbounded) Get the search results of an
void	initSuppressAction(org.kuali.rice.krad.web.form.LookupForm lookupForm)
protected boolean	isResultReturnable(Object dataObject) Determines whether a given data object that's returned as one of the lookup's results is considered returnable, which means that for single-value lookups, a "return value" link may be rendered, and for multiple value lookups, a checkbox is rendered.
Map<String,String>	performClear(org.kuali.rice.krad.web.form.LookupForm form, Map<String,String> searchCriteria)
void	performInitialization(org.kuali.rice.krad.uif.view.View view, Object model) Initialization of Lookupable requires that the business object class be set for the ViewHelperServiceImpl.initializeDataFieldFromDataDictionary(org.kuali.rice.krad.uif.view.View, org.kuali.rice.krad.uif.field.DataField) method
Collection<?>	performSearch(org.kuali.rice.krad.web.form.LookupForm form, Map<String,String> searchCriteria, boolean bounded)
protected Map<String,String>	processSearchCriteria(org.kuali.rice.krad.web.form.LookupForm lookupForm, Map<String,String> searchCriteria) Process the search criteria to be used with the lookup
void	setConfigurationService(org.kuali.rice.core.api.config.property.ConfigurationService configurationService)
void	setDataObjectAuthorizationService(org.kuali.rice.krad.service.DataObjectAuthorizationService dataObjectAuthorizationService)
void	setDataObjectClass(Class<?> dataObjectClass)
void	setDataObjectMetaDataService(org.kuali.rice.krad.service.DataObjectMetaDataService dataObjectMetaDataService)
void	setDocumentDictionaryService(org.kuali.rice.krad.service.DocumentDictionaryService documentDictionaryService)
void	setEncryptionService(org.kuali.rice.core.api.encryption.EncryptionService encryptionService)
void	setLookupService(org.kuali.rice.krad.service.LookupService lookupService)
void	setMultiValueLookupSelect(org.kuali.rice.krad.uif.field.InputField selectField, Object model) Sets the value for the attribute field control to contain the field conversion values for the line
protected void	sortSearchResults(org.kuali.rice.krad.web.form.LookupForm form, List<?> searchResults) Sorts the given list of search results based on the lookup view's configured sort attributes
boolean	validateSearchParameters(org.kuali.rice.krad.web.form.LookupForm form, Map<String,String> searchCriteria)
protected void	validateSearchParameterWildcardAndOperators(org.kuali.rice.krad.uif.field.InputField inputField, String searchPropertyValue) Validates that any wildcards contained within the search value are valid wilcards and allowed for the property type for which the field is searching

Methods inherited from class org.kuali.rice.krad.uif.service.impl.ViewHelperServiceImpl

addCustomContainerComponents, addLine, adjustIdIfNecessary, applyAuthorizationAndPresentationLogic, applyDefaultValues, applyDefaultValuesForCollectionLine, buildClientSideStateScript, buildExportTableData, buildExportTableRow, buildGrowlScript, buildInquiryLink, cleanViewAfterRender, findNestedDictionaryAttribute, getBusinessObjectService, getCommonContext, getConfigurationService, getDataDictionaryService, getExportTableFormatOptions, getExpressionEvaluator, getPersistenceService, getPersistenceStructureService, getPreModelContext, getViewDictionaryService, initializeDataFieldFromDataDictionary, invokeMethodFinalizer, logAndThrowRuntime, performAddLineValidation, performApplyModel, performComponentApplyModel, performComponentFinalize, performComponentInitialization, performComponentLifecycle, performCustomApplyModel, performCustomFinalize, performCustomInitialization, performDeleteLineValidation, performFinalize, populateDefaultValueForField, populateViewFromRequestParameters, processAfterAddLine, processAfterDeleteLine, processAfterSaveLine, processAnyRemoteFieldsHolder, processBeforeAddLine, processBeforeSaveLine, processCollectionAddBlankLine, processCollectionAddLine, processCollectionDeleteLine, processCollectionSaveLine, processMultipleValueLookupResults, refreshReferences, retrieveEditModesAndActionFlags, runComponentModifiers, setBusinessObjectService, setDataDictionaryService, setExpressionEvaluator, setPersistenceService, setPersistenceStructureService, setViewContext, setViewDictionaryService, spawnSubLifecyle, syncClientSideStateForComponent

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.kuali.rice.krad.uif.service.ViewHelperService

applyDefaultValuesForCollectionLine, buildExportTableData, buildInquiryLink, cleanViewAfterRender, getCommonContext, getExpressionEvaluator, performApplyModel, performComponentInitialization, performComponentLifecycle, performFinalize, populateViewFromRequestParameters, processCollectionAddBlankLine, processCollectionAddLine, processCollectionDeleteLine, processCollectionSaveLine, processMultipleValueLookupResults, refreshReferences, spawnSubLifecyle

Constructor Detail

OleLookupableImpl

public OleLookupableImpl()

Method Detail

performInitialization

public void performInitialization(org.kuali.rice.krad.uif.view.View view,
                         Object model)

Initialization of Lookupable requires that the business object class be set for the ViewHelperServiceImpl.initializeDataFieldFromDataDictionary(org.kuali.rice.krad.uif.view.View, org.kuali.rice.krad.uif.field.DataField) method

Specified by:

performInitialization in interface org.kuali.rice.krad.uif.service.ViewHelperService

Overrides:

performInitialization in class org.kuali.rice.krad.uif.service.impl.ViewHelperServiceImpl

See Also:

ViewHelperServiceImpl.performInitialization(org.kuali.rice.krad.uif.view.View, java.lang.Object)

initSuppressAction

public void initSuppressAction(org.kuali.rice.krad.web.form.LookupForm lookupForm)

Specified by:

initSuppressAction in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.initSuppressAction(org.kuali.rice.krad.web.form.LookupForm)

performSearch

public Collection<?> performSearch(org.kuali.rice.krad.web.form.LookupForm form,
                          Map<String,String> searchCriteria,
                          boolean bounded)

Specified by:

performSearch in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.performSearch(org.kuali.rice.krad.web.form.LookupForm, java.util.Map<java.lang.String, java.lang.String>, boolean)

getSearchResults

protected List<?> getSearchResults(org.kuali.rice.krad.web.form.LookupForm form,
                       Map<String,String> searchCriteria,
                       boolean unbounded)

Get the search results of the lookup

Parameters:

form - lookup form instance containing the lookup data

searchCriteria - map of criteria currently set

unbounded - indicates whether the complete result should be returned. When set to false the result is limited (if necessary) to the max search result limit configured.

Returns:

the list of result objects, possibly bounded

generateErrorMessageForResults

public void generateErrorMessageForResults(org.kuali.rice.krad.web.form.LookupForm form,
                                  String messageToDisplay)

Convenience method for setting an error message on the lookup results section

Specified by:

generateErrorMessageForResults in interface org.kuali.rice.krad.lookup.Lookupable

Parameters:

form -

messageToDisplay -

generateLookupResultsMessages

protected void generateLookupResultsMessages(org.kuali.rice.krad.web.form.LookupForm form,
                                 Map<String,String> searchCriteria,
                                 Collection<?> searchResult,
                                 boolean unbounded)

Helper function to render lookup results messages

Parameters:

form -

searchCriteria -

searchResult -

unbounded -

sortSearchResults

protected void sortSearchResults(org.kuali.rice.krad.web.form.LookupForm form,
                     List<?> searchResults)

Sorts the given list of search results based on the lookup view's configured sort attributes

First if the posted view exists we grab the sort attributes from it. This will take into account expressions that might have been configured on the sort attributes. If the posted view does not exist (because we did a search from a get request or form session storage is off), we get the sort attributes from the view that we will be rendered (and was initialized before controller call). However, expressions will not be evaluated yet, thus if expressions were configured we don't know the results and can not sort the list

Parameters:

form - - lookup form instance containing view information

searchResults - - list of search results to sort

processSearchCriteria

protected Map<String,String> processSearchCriteria(org.kuali.rice.krad.web.form.LookupForm lookupForm,
                                       Map<String,String> searchCriteria)

Process the search criteria to be used with the lookup

Processing entails primarily of the removal of filtered and unused/blank search criteria. Encrypted field values are decrypted in this process as well.

Parameters:

lookupForm - lookup form instance containing the lookup data

searchCriteria - map of criteria currently set

Returns:

map with the non blank search criteria

getSearchResultsForEBO

protected List<?> getSearchResultsForEBO(Map<String,String> searchCriteria,
                             boolean unbounded)

Get the search results of an

Parameters:

searchCriteria - map of criteria currently set

unbounded - indicates whether the complete result should be returned. When set to false the result is limited (if necessary) to the max search result limit configured.

Returns:

list of result objects, possibly bounded

adjustCriteriaForNestedEBOs

protected Map<String,String> adjustCriteriaForNestedEBOs(Map<String,String> searchCriteria,
                                             boolean unbounded)
                                                  throws InstantiationException,
                                                         IllegalAccessException

Parameters:

searchCriteria - map of criteria currently set

unbounded - indicates whether the complete result should be returned. When set to false the result is limited (if necessary) to the max search result limit configured.

Returns:

Throws:

InstantiationException

IllegalAccessException

performClear

public Map<String,String> performClear(org.kuali.rice.krad.web.form.LookupForm form,
                              Map<String,String> searchCriteria)

Specified by:

performClear in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.performClear(org.kuali.rice.krad.web.form.LookupForm, java.util.Map<java.lang.String, java.lang.String>)

validateSearchParameters

public boolean validateSearchParameters(org.kuali.rice.krad.web.form.LookupForm form,
                               Map<String,String> searchCriteria)

Specified by:

validateSearchParameters in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.validateSearchParameters(org.kuali.rice.krad.web.form.LookupForm, java.util.Map<java.lang.String, java.lang.String>)

getCriteriaFieldsForValidation

protected Map<String,org.kuali.rice.krad.uif.field.InputField> getCriteriaFieldsForValidation(org.kuali.rice.krad.uif.view.LookupView lookupView,
                                                                                  org.kuali.rice.krad.web.form.LookupForm form)

Returns the criteria fields in a map keyed by the field property name.

Parameters:

lookupView -

form - lookup form instance containing the lookup data

Returns:

map of criteria fields

validateSearchParameterWildcardAndOperators

protected void validateSearchParameterWildcardAndOperators(org.kuali.rice.krad.uif.field.InputField inputField,
                                               String searchPropertyValue)

Validates that any wildcards contained within the search value are valid wilcards and allowed for the property type for which the field is searching

Parameters:

inputField - - attribute field instance for the field that is being searched

searchPropertyValue - - value given for field to search for

getReturnUrlForResults

public void getReturnUrlForResults(org.kuali.rice.krad.uif.element.Action returnLink,
                          Object model)

Specified by:

getReturnUrlForResults in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.getReturnUrlForResults(org.kuali.rice.krad.uif.element.Action, java.lang.Object)

getReturnUrl

protected String getReturnUrl(org.kuali.rice.krad.uif.view.LookupView lookupView,
                  org.kuali.rice.krad.web.form.LookupForm lookupForm,
                  Object dataObject)

Builds the URL for returning the given data object result row

Note return URL will only be built if a return location is specified on the LookupForm

Parameters:

lookupView - - lookup view instance containing lookup configuration

lookupForm - - lookup form instance containing the data

dataObject - - data object instance for the current line and for which the return URL is being built

Returns:

String return URL or blank if URL cannot be built

getReturnUrlParameters

protected Properties getReturnUrlParameters(org.kuali.rice.krad.uif.view.LookupView lookupView,
                                org.kuali.rice.krad.web.form.LookupForm lookupForm,
                                Object dataObject)

Builds up a Properties object that will be used to provide the request parameters for the return URL link

Parameters:

lookupView - - lookup view instance containing lookup configuration

lookupForm - - lookup form instance containing the data

dataObject - - data object instance for the current line and for which the return URL is being built

Returns:

Properties instance containing request parameters for return URL

getReturnKeys

protected List<String> getReturnKeys(org.kuali.rice.krad.uif.view.LookupView lookupView,
                         org.kuali.rice.krad.web.form.LookupForm lookupForm,
                         Object dataObject)

Returns the configured return key property names or if not configured defaults to the primary keys for the data object class

Parameters:

lookupView - - lookup view instance containing lookup configuration

lookupForm - - lookup form instance containing the data

dataObject - - data object instance

Returns:

List property names which should be passed back on the return URL

getMaintenanceActionLink

public void getMaintenanceActionLink(org.kuali.rice.krad.uif.element.Action actionLink,
                            Object model,
                            String maintenanceMethodToCall)

Specified by:

getMaintenanceActionLink in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.getMaintenanceActionLink(org.kuali.rice.krad.uif.element.Action, java.lang.Object, java.lang.String)

getActionUrlHref

protected String getActionUrlHref(org.kuali.rice.krad.web.form.LookupForm lookupForm,
                      Object dataObject,
                      String methodToCall,
                      List<String> pkNames)

Generates a URL to perform a maintenance action on the given result data object

Will build a URL containing keys of the data object to invoke the given maintenance action method within the maintenance controller

Parameters:

dataObject - - data object instance for the line to build the maintenance action link for

methodToCall - - method name on the maintenance controller that should be invoked

pkNames - - list of primary key field names for the data object whose key/value pairs will be added to the maintenance link

Returns:

String URL link for the maintenance action

setMultiValueLookupSelect

public void setMultiValueLookupSelect(org.kuali.rice.krad.uif.field.InputField selectField,
                             Object model)

Sets the value for the attribute field control to contain the field conversion values for the line

Specified by:

setMultiValueLookupSelect in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

LookupableImpl.setMultiValueLookupSelect(org.kuali.rice.krad.uif.field.InputField, java.lang.Object)

allowsMaintenanceNewOrCopyAction

public boolean allowsMaintenanceNewOrCopyAction()

Determines if given data object has associated maintenance document that allows new or copy maintenance actions

Returns:

boolean true if the maintenance new or copy action is allowed for the data object instance, false otherwise

allowsMaintenanceEditAction

public boolean allowsMaintenanceEditAction(Object dataObject)

Determines if given data object has associated maintenance document that allows edit maintenance actions

Returns:

boolean true if the maintenance edit action is allowed for the data object instance, false otherwise

allowsMaintenanceDeleteAction

public boolean allowsMaintenanceDeleteAction(Object dataObject)

Determines if given data object has associated maintenance document that allows delete maintenance actions.

Returns:

boolean true if the maintenance delete action is allowed for the data object instance, false otherwise

getMaintenanceDocumentTypeName

protected String getMaintenanceDocumentTypeName()

Returns the maintenance document type associated with the business object class or null if one does not exist.

Returns:

String representing the maintenance document type name

isResultReturnable

protected boolean isResultReturnable(Object dataObject)

Determines whether a given data object that's returned as one of the lookup's results is considered returnable, which means that for single-value lookups, a "return value" link may be rendered, and for multiple value lookups, a checkbox is rendered. Note that this can be part of an authorization mechanism, but not the complete authorization mechanism. The component that invoked the lookup/ lookup caller (e.g. document, nesting lookup, etc.) needs to check that the object that was passed to it was returnable as well because there are ways around this method (e.g. crafting a custom return URL).

Parameters:

dataObject - - an object from the search result set

Returns:

true if the row is returnable and false if it is not

setDataObjectClass

public void setDataObjectClass(Class<?> dataObjectClass)

Specified by:

setDataObjectClass in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.setDataObjectClass(java.lang.Class<?>)

getDataObjectClass

public Class<?> getDataObjectClass()

Specified by:

getDataObjectClass in interface org.kuali.rice.krad.lookup.Lookupable

See Also:

Lookupable.getDataObjectClass()

setConfigurationService

public void setConfigurationService(org.kuali.rice.core.api.config.property.ConfigurationService configurationService)

Overrides:

setConfigurationService in class org.kuali.rice.krad.uif.service.impl.ViewHelperServiceImpl

getDataObjectAuthorizationService

protected org.kuali.rice.krad.service.DataObjectAuthorizationService getDataObjectAuthorizationService()

setDataObjectAuthorizationService

public void setDataObjectAuthorizationService(org.kuali.rice.krad.service.DataObjectAuthorizationService dataObjectAuthorizationService)

getDataObjectMetaDataService

protected org.kuali.rice.krad.service.DataObjectMetaDataService getDataObjectMetaDataService()

setDataObjectMetaDataService

public void setDataObjectMetaDataService(org.kuali.rice.krad.service.DataObjectMetaDataService dataObjectMetaDataService)

getDocumentDictionaryService

public org.kuali.rice.krad.service.DocumentDictionaryService getDocumentDictionaryService()

setDocumentDictionaryService

public void setDocumentDictionaryService(org.kuali.rice.krad.service.DocumentDictionaryService documentDictionaryService)

getLookupService

protected org.kuali.rice.krad.service.LookupService getLookupService()

setLookupService

public void setLookupService(org.kuali.rice.krad.service.LookupService lookupService)

getEncryptionService

protected org.kuali.rice.core.api.encryption.EncryptionService getEncryptionService()

setEncryptionService

public void setEncryptionService(org.kuali.rice.core.api.encryption.EncryptionService encryptionService)

getPropertyKeyValuesFromDataObject

public Map<String,String> getPropertyKeyValuesFromDataObject(List<String> propertyNames,
                                                    Object dataObject)