org.kuali.rice.krad.uif.widget
Class LocationSuggest

java.lang.Object
  org.kuali.rice.krad.datadictionary.DictionaryBeanBase
      org.kuali.rice.krad.datadictionary.uif.UifDictionaryBeanBase
          org.kuali.rice.krad.uif.component.ComponentBase
              org.kuali.rice.krad.uif.widget.WidgetBase
                  org.kuali.rice.krad.uif.widget.Suggest
                      org.kuali.rice.krad.uif.widget.LocationSuggest

All Implemented Interfaces:

Serializable, Cloneable, DictionaryBean, UifDictionaryBean, Component, ScriptEventSupport, Widget, org.springframework.core.Ordered

public class LocationSuggest
extends Suggest

LocationSuggest widget for providing suggestions that represent locations. When the suggestion is clicked, the navigation occurs immediately.

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.kuali.rice.krad.uif.component.Ordered

INITIAL_ORDER_VALUE

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

LocationSuggest()

Method Summary

Map<String,String>	getAdditionalRequestParameters() AdditionalRequestParameters specify the static(constant) request parameters that should be appended to the url.
String	getAdditionalRequestParameterString() Gets the constant additionalRequestParameters as a request string value to use as part of the url
String	getAdditionalUrlPathPropertyName() AdditionalUrlPathProperty specifies the property on the retrieved suggestion result that contains a url appendage to be appended to the baseUrl when this selection is chosen.
String	getBaseUrl() BaseUrl for the suggestions.
String	getHrefPropertyName() The hrefPropertyName specifies the property on the retrieved suggestion result that contains the href value (full url).
String	getObjectIdPropertyName() The objectIdPropertyName that represents the key for getting the object as a request parameter.
String	getRequestParameterPropertyNameJsObject() Gets an object translated to js for the requestParameterPropertyNames.
Map<String,String>	getRequestParameterPropertyNames() RequestParameterPropertyNames specify the properties that should be included in the request parameters.
void	performFinalize(View view, Object model, Component parent) Process the objectIdPropertyName, if set
void	setAdditionalRequestParameters(Map<String,String> additionalRequestParameters) Get the additionalRequestParameters
void	setAdditionalUrlPathPropertyName(String additionalUrlPathPropertyName) Set additionalUrlPathProperty
void	setBaseUrl(String baseUrl) Set the baseUrl
void	setHrefPropertyName(String hrefPropertyName) Set the hrefPropertyName
void	setObjectIdPropertyName(String objectIdPropertyName) Set the objectIdPropertyName
void	setRequestParameterPropertyNames(Map<String,String> requestParameterPropertyNames) Set the requestParameterPropertyNames

Methods inherited from class org.kuali.rice.krad.uif.widget.Suggest

copyProperties, getAdditionalPropertiesToReturn, getLabelPropertyName, getSuggestOptions, getSuggestOptionsJsString, getSuggestQuery, getValuePropertyName, isRetrieveAllSuggestions, isReturnFullQueryObject, isSuggestConfigured, performApplyModel, retrieveSuggestOptions, setAdditionalPropertiesToReturn, setLabelPropertyName, setRetrieveAllSuggestions, setReturnFullQueryObject, setSuggestOptions, setSuggestOptionsJsString, setSuggestQuery, setValuePropertyName

Methods inherited from class org.kuali.rice.krad.uif.widget.WidgetBase

getComponentTypeName

Methods inherited from class org.kuali.rice.krad.uif.component.ComponentBase

addCellCssClass, addDataAttribute, addDataAttributeIfNonEmpty, addStyleClass, appendToStyle, completeValidation, copy, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAlign, getBaseId, getCellCssClasses, getCellStyle, getCellStyleClassesAsString, getCellWidth, getColSpan, getComponentModifiers, getComponentPrototypes, getComponentSecurity, getComponentSecurityClass, getComponentsForLifecycle, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContext, getCssClasses, getDataAttributes, getEventHandlerScript, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getId, getLibraryCssClasses, getMethodToCallOnRefresh, getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, getOrder, getPostRenderContent, getPreRenderContent, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getRefreshTimer, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRowSpan, getSimpleDataAttributes, getStyle, getStyleClassesAsString, getTemplate, getTemplateName, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, getValign, getWidth, isDisableSessionPersistence, isDisclosedByAction, isForceSessionPersistence, isHidden, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isReadOnly, isRefreshedByAction, isRender, isResetDataOnRefresh, isRetrieveViaAjax, isSelfRendered, isSkipInTabOrder, performInitialization, pushAllToContext, pushObjectToContext, pushToPropertyReplacerContext, setAdditionalComponentsToRefresh, setAdditionalCssClasses, setAlign, setBaseId, setCellCssClasses, setCellStyle, setCellWidth, setColSpan, setComponentModifiers, setComponentSecurity, setConditionalRefresh, setContext, setCssClasses, setDataAttributes, setDisableSessionPersistence, setDisclosedByAction, setFinalizeMethodAdditionalArguments, setFinalizeMethodInvoker, setFinalizeMethodToCall, setForceSessionPersistence, setHidden, setId, setLibraryCssClasses, setMethodToCallOnRefresh, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScript, setOrder, setPostRenderContent, setPreRenderContent, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshTimer, setRefreshWhenChangedPropertyNames, setRender, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRetrieveViaAjax, setRowSpan, setSelfRendered, setSkipInTabOrder, setStyle, setTemplate, setTemplateName, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip, setValign, setWidth

Methods inherited from class org.kuali.rice.krad.datadictionary.uif.UifDictionaryBeanBase

getExpressionGraph, getPropertyExpression, getPropertyExpressions, getRefreshExpressionGraph, setExpressionGraph, setPropertyExpressions, setRefreshExpressionGraph

Methods inherited from class org.kuali.rice.krad.datadictionary.DictionaryBeanBase

getComponentCode, getNamespaceCode, setComponentCode, setNamespaceCode

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.component.Component

addCellCssClass, addDataAttribute, addStyleClass, appendToStyle, completeValidation, copy, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAlign, getBaseId, getCellCssClasses, getCellStyle, getCellWidth, getColSpan, getComponentModifiers, getComponentPrototypes, getComponentSecurity, getComponentsForLifecycle, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContext, getCssClasses, getDataAttributes, getEventHandlerScript, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getId, getLibraryCssClasses, getOrder, getPostRenderContent, getPreRenderContent, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getRefreshTimer, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRowSpan, getSimpleDataAttributes, getStyle, getTemplate, getTemplateName, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, getValign, getWidth, isDisableSessionPersistence, isDisclosedByAction, isForceSessionPersistence, isHidden, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isReadOnly, isRefreshedByAction, isRender, isResetDataOnRefresh, isRetrieveViaAjax, isSelfRendered, performInitialization, pushAllToContext, pushObjectToContext, setAdditionalComponentsToRefresh, setAdditionalCssClasses, setAlign, setBaseId, setCellCssClasses, setCellStyle, setCellWidth, setColSpan, setComponentModifiers, setComponentSecurity, setConditionalRefresh, setContext, setCssClasses, setDataAttributes, setDisableSessionPersistence, setDisclosedByAction, setForceSessionPersistence, setHidden, setId, setLibraryCssClasses, setOrder, setPostRenderContent, setPreRenderContent, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshTimer, setRefreshWhenChangedPropertyNames, setRender, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRetrieveViaAjax, setRowSpan, setSelfRendered, setStyle, setTemplate, setTemplateName, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip, setValign, setWidth

Methods inherited from interface org.kuali.rice.krad.datadictionary.uif.UifDictionaryBean

getExpressionGraph, getPropertyExpression, getPropertyExpressions, getRefreshExpressionGraph, setExpressionGraph, setPropertyExpressions, setRefreshExpressionGraph

Methods inherited from interface org.kuali.rice.krad.datadictionary.DictionaryBean

getComponentCode, getNamespaceCode

Methods inherited from interface org.kuali.rice.krad.uif.component.ScriptEventSupport

getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScript

Constructor Detail

LocationSuggest

public LocationSuggest()

Method Detail

performFinalize

public void performFinalize(View view,
                            Object model,
                            Component parent)

Process the objectIdPropertyName, if set

Specified by:

performFinalize in interface Component

Overrides:

performFinalize in class Suggest

Parameters:

view - - view instance that should be finalized for rendering

model - - top level object containing the data

parent - - parent component

See Also:

Component.performFinalize(org.kuali.rice.krad.uif.view.View, Object, org.kuali.rice.krad.uif.component.Component)

getBaseUrl

public String getBaseUrl()

BaseUrl for the suggestions. Unless the suggestion contains an href, baseUrl + additionalUrlPath value + request parameters is used to generate the url.

Returns:

the baseUrl

setBaseUrl

public void setBaseUrl(String baseUrl)

Set the baseUrl

Parameters:

baseUrl -

getAdditionalUrlPathPropertyName

public String getAdditionalUrlPathPropertyName()

AdditionalUrlPathProperty specifies the property on the retrieved suggestion result that contains a url appendage to be appended to the baseUrl when this selection is chosen.

One use case for setting this is to retrieve a controllerMapping that changes based on selection. Note: for suggestions that all point to the same controllerMapping, simply set it as part of the baseUrl.

Returns:

the additionalUrlPathPropertyName

setAdditionalUrlPathPropertyName

public void setAdditionalUrlPathPropertyName(String additionalUrlPathPropertyName)

Set additionalUrlPathProperty

Parameters:

additionalUrlPathPropertyName -

getHrefPropertyName

public String getHrefPropertyName()

The hrefPropertyName specifies the property on the retrieved suggestion result that contains the href value (full url).

This property must contain a full url if it exists on the object. If this property name is matched on the suggestion result, it takes precedence over any other settings set on this locationSuggest and is used as the navigation url. If the property name does not exist on the object, the suggest will fall back to building the url dynamically with baseUrl.

Returns:

the hrefPropertyName

setHrefPropertyName

public void setHrefPropertyName(String hrefPropertyName)

Set the hrefPropertyName

Parameters:

hrefPropertyName -

getObjectIdPropertyName

public String getObjectIdPropertyName()

The objectIdPropertyName that represents the key for getting the object as a request parameter. The property will be added to the request parameters by the name given with the value pulled from the result object.

This convenience method is essentially equivalent to having a property by objectIdPropertyName as a key and value in the requestParameterPropertyNames.

Returns:

the objectIdPropertyName which represents which property is the "key" of the object

setObjectIdPropertyName

public void setObjectIdPropertyName(String objectIdPropertyName)

Set the objectIdPropertyName

Parameters:

objectIdPropertyName -

getRequestParameterPropertyNames

public Map<String,String> getRequestParameterPropertyNames()

RequestParameterPropertyNames specify the properties that should be included in the request parameters.

The key is used as the key of the request parameter and the value is used as the property name to look for in the suggestion result object. If the property name specified exists on the result object, the request parameter in the url will appear as key=propertyValue in the request parameters.

Returns:

the RequestParameterPropertyNames map with key and property names

setRequestParameterPropertyNames

public void setRequestParameterPropertyNames(Map<String,String> requestParameterPropertyNames)

Set the requestParameterPropertyNames

Parameters:

requestParameterPropertyNames -

getAdditionalRequestParameters

public Map<String,String> getAdditionalRequestParameters()

AdditionalRequestParameters specify the static(constant) request parameters that should be appended to the url.

The key represents the key of the request parameter and the value represents the value of the request parameter. This will be used on each suggestion which uses a generated url (using baseUrl construction).

Returns:

setAdditionalRequestParameters

public void setAdditionalRequestParameters(Map<String,String> additionalRequestParameters)

Get the additionalRequestParameters

Parameters:

additionalRequestParameters -

getRequestParameterPropertyNameJsObject

public String getRequestParameterPropertyNameJsObject()

Gets an object translated to js for the requestParameterPropertyNames. Used to construct the url on the client.

Returns:

the requestParameterPropertyNames js map object

getAdditionalRequestParameterString

public String getAdditionalRequestParameterString()

Gets the constant additionalRequestParameters as a request string value to use as part of the url

Returns:

the request parameter string for additionalRequestParameters