org.kuali.rice.krad.lookup
Interface Lookupable

All Superinterfaces:

Serializable, ViewHelperService

All Known Implementing Classes:

AgendaLookupableHelperServiceImpl, AgendaStudentLookupableHelperServiceImpl, FiscalOfficerInfoLookupViewHelperServiceImpl, GroupLookupableImpl, LookupableImpl, PersonLookupableImpl, PropositionLookupableHelperServiceImpl, RoleLookupableImpl

public interface Lookupable
extends ViewHelperService, Serializable

Provides contract for implementing a lookup within the lookup framework

Author:

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

Method Summary

Class<?>	getDataObjectClass() Returns the class for the data object the lookup is configured with
void	getMaintenanceActionLink(Link actionLink, Object model, String maintenanceMethodToCall) Invoked to build a maintenance URL for a result row
void	getReturnUrlForResults(LinkField returnLinkField, Object model) Invoked to build the return URL for a result row
Map<String,String>	performClear(LookupForm form, Map<String,String> searchCriteria) Invoked when the clear action is requested to result the search fields to their initial default values
Collection<?>	performSearch(LookupForm form, Map<String,String> searchCriteria, boolean bounded) Invoked to carry out the lookup search based on the given map of key/value search values
void	setDataObjectClass(Class<?> dataObjectClass) Sets the class for the data object the lookup will be provided on
void	setMultiValueLookupSelect(InputField selectField, Object model) Set the value for the input field control to contain the field conversion values for the line
boolean	validateSearchParameters(LookupForm form, Map<String,String> searchCriteria) Invoked to perform validation on the search criteria before the search is performed

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

applyDefaultValuesForCollectionLine, buildInquiryLink, cleanViewAfterRender, performApplyModel, performComponentInitialization, performComponentLifecycle, performFinalize, performInitialization, populateViewFromRequestParameters, processCollectionAddBlankLine, processCollectionAddLine, processCollectionDeleteLine, processCollectionSaveLine, processMultipleValueLookupResults

Method Detail

performSearch

Collection<?> performSearch(LookupForm form,
                            Map<String,String> searchCriteria,
                            boolean bounded)

Invoked to carry out the lookup search based on the given map of key/value search values

Parameters:

form - - lookup form instance containing the lookup data

searchCriteria - - map of criteria currently set

bounded - - indicates whether the results should be limited (if necessary) to the max search result limit configured

Returns:

the list of result objects, possibly bounded

performClear

Map<String,String> performClear(LookupForm form,
                                Map<String,String> searchCriteria)

Invoked when the clear action is requested to result the search fields to their initial default values

Parameters:

form - - lookup form instance containing the lookup data

searchCriteria - - map of criteria currently set

Returns:

map of criteria with field values reset to defaults

validateSearchParameters

boolean validateSearchParameters(LookupForm form,
                                 Map<String,String> searchCriteria)

Invoked to perform validation on the search criteria before the search is performed

Parameters:

form - - lookup form instance containing the lookup data

searchCriteria - - map of criteria where key is search property name and value is search value (which can include wildcards)

setDataObjectClass

void setDataObjectClass(Class<?> dataObjectClass)

Sets the class for the data object the lookup will be provided on

Parameters:

dataObjectClass - - data object class for lookup

getDataObjectClass

Class<?> getDataObjectClass()

Returns the class for the data object the lookup is configured with

Returns:

Class data object class

getReturnUrlForResults

void getReturnUrlForResults(LinkField returnLinkField,
                            Object model)

Invoked to build the return URL for a result row

Based on the line contained in the field context, the URL for returning the role is constructed and set as the href for the link field. If a return link cannot be constructed the field should be set to not render

Parameters:

returnLinkField - - link field that will be used to render the return URL

model - - lookup form containing the data

getMaintenanceActionLink

void getMaintenanceActionLink(Link actionLink,
                              Object model,
                              String maintenanceMethodToCall)

Invoked to build a maintenance URL for a result row

Based on the line contained in the field context and the given maintenance method that should be called a URL is constructed and set as the href on the link field. If a maintenance link cannot be constructed the field should be set to not render

Parameters:

actionLink - - link that will be used to return the maintenance URL

model - - lookup form containing the data

maintenanceMethodToCall - - name of the method that should be invoked in the maintenance controller

setMultiValueLookupSelect

void setMultiValueLookupSelect(InputField selectField,
                               Object model)

Set the value for the input field control to contain the field conversion values for the line

Creates and populate the value of the input field control. This value is build according to LookupForm.getFieldConversions() and allows for client side population of the returned fields without having to do an additional server call.

Parameters:

selectField - - the InputField used to mark the lookup row as selected

model - - lookup form containing the data