public class View extends ContainerBase
The View component ties together all the components and configuration of the User Interface for a piece of functionality. In Rice applications the view is typically associated with a Document instance.
The view template lays out the common header, footer, and navigation for the related pages. In addition the view renders the HTML head element bringing in common script files and style sheets, along with optionally rendering a form element for pages that need to post data back to the server.
Configuration of UIF features such as model validation is also done through the View
Modifier and Type | Field and Description |
---|---|
protected boolean |
applyDirtyCheck |
protected ViewIndex |
viewIndex |
templateOptions
componentCode
INITIAL_ORDER_VALUE
Constructor and Description |
---|
View() |
Modifier and Type | Method and Description |
---|---|
void |
addViewTemplate(String template)
Adds a template to the views include list.
|
void |
afterEvaluateExpression()
No-op implementation.
|
void |
clearIndex()
Invoked to produce a ViewIndex of the current view's components
|
View |
clone()
Override
Object.clone() to assign the public modifier. |
void |
completeValidation(ValidationTrace tracer)
Validates different requirements of component compiling a series of reports detailing information on errors
found in the component.
|
Map<String,Boolean> |
getActionFlags()
Map of strings that flag what actions can be taken in the UI.
|
List<String> |
getAdditionalCssFiles()
Declares additional CSS files that should be included with the View.
|
List<HeadLink> |
getAdditionalHeadLinks()
List of additional link tags that should be included with the View in the html head.
|
List<MetaTag> |
getAdditionalMetaTags()
List of additional meta tags that should be included with the View in the html head tag.
|
List<String> |
getAdditionalScriptFiles()
Declares additional script files that should be included with the
View.
|
Group |
getApplicationFooter()
Footer for the application containing the view.
|
Header |
getApplicationHeader()
Header for the application containing the view.
|
String |
getApplicationTitleText()
Title text to be displayed on browser tab.
|
ViewAuthorizer |
getAuthorizer()
Authorizer that should be used for the View instance
|
BreadcrumbItem |
getBreadcrumbItem()
The View's breadcrumbItem defines settings for the breadcrumb which appears in the breadcrumb list for this
view.
|
List<BreadcrumbItem> |
getBreadcrumbItems()
Gets all breadcrumb items related to this view's parent location.
|
BreadcrumbOptions |
getBreadcrumbOptions()
The breadcrumbOptions for this view.
|
Breadcrumbs |
getBreadcrumbs()
Breadcrumb widget used for displaying homeward path and history
|
Group |
getBuildFooter()
Build footer for the application containing the view.
|
String |
getComponentTypeName()
The name for the component type
|
String |
getContentContainerClassesAsString()
Returns the list of
getContentContainerCssClasses() as a concatenated string (each class
is separated by a space). |
List<String> |
getContentContainerCssClasses()
List of CSS style classes that will be applied to a div that wraps the content.
|
PageGroup |
getCurrentPage()
Iterates through the contained page items and returns the Page that matches the set current page id or
the first page in the case of a single page view.
|
String |
getCurrentPageId()
The id for the page within the view that should be displayed in the UI.
|
String |
getDefaultBindingObjectPath()
For View types that work primarily with one nested object of
the form (for instance document, or bo) the default binding object path
can be set for each of the views DataBinding components.
|
List<Group> |
getDialogs()
Provide a list of dialog groups associated with this view.
|
Map<String,Boolean> |
getEditModes()
Map of edit modes that enabled for the view.
|
String |
getEntryPageId()
Specifies what page should be rendered by default.
|
Map<String,String> |
getExpressionVariables()
Map that contains expressions to evaluate and make available as variables
for conditional expressions within the view.
|
Class<?> |
getFormClass()
Class of the Form that should be used with the View instance.
|
Growls |
getGrowls()
Growls widget which sets up global settings for the growls used in this
view and its pages.
|
List<? extends Component> |
getItems()
List of Component instances that are held by
the container |
String |
getNamespaceCode()
Namespace code the view should be associated with.
|
Group |
getNavigation()
NavigationGroup instance for the View<
|
BlockUI |
getNavigationBlockUI() |
Map<String,Class<?>> |
getObjectPathToConcreteClassMapping()
Configures the concrete classes that will be used for properties in the
form object graph that have an abstract or interface type.
|
PageGroup |
getPage()
For single paged views (
isSinglePageView() , gives the page
Group the view should render. |
List<Component> |
getPagesForPreprocessing()
Getter for returning the view's items and page for inclusion in the pre-process phase.
|
ParentLocation |
getParentLocation()
The parentLocation defines urls that represent the parent of a View in a conceptial site hierarchy.
|
List<BreadcrumbItem> |
getPathBasedBreadcrumbs()
The pathBasedBreadcrumbs for this View.
|
int |
getPreloadPoolSize() |
String |
getPreLoadScript()
Script that is executed at the beginning of page load (before any other script).
|
Map<String,Object> |
getPreModelContext()
Returns the general context that is available before the apply model phase (during the
initialize phase)
|
ViewPresentationController |
getPresentationController()
PresentationController that should be used for the View instance.
|
BlockUI |
getRefreshBlockUI() |
Class<? extends RequestAuthorizationCache> |
getRequestAuthorizationCacheClass() |
ViewSessionPolicy |
getSessionPolicy()
Configures behavior that should occur when a session timeout occurs on the view.
|
StateMapping |
getStateMapping()
Gets the stateMapping.
|
String |
getStateObjectBindingPath()
The stateObject's binding path, this will be used along with the StateMapping's statePropertyName to
determine what field in the model state information is stored in for this view.
|
Set<Class<? extends Component>> |
getSupportedComponents()
Set of Component classes that may be placed
into the container |
ViewTheme |
getTheme()
The theme which contains stylesheets for this view.
|
Group |
getTopGroup()
TopGroup is an optional group of content that appears above the breadcrumbs and view header.
|
ViewHelperService |
getViewHelperService()
Creates the
ViewHelperService associated with the View |
Class<? extends ViewHelperService> |
getViewHelperServiceClass()
Class name of the ViewHelperService that handles the various phases of the Views lifecycle.
|
ViewIndex |
getViewIndex()
Holds field indexes of the View instance for retrieval.
|
String |
getViewName()
View name provides an identifier for a view within a type.
|
Map<String,String> |
getViewRequestParameters()
Map of parameters from the request that set view options, used to rebuild
the view on each post
|
List<String> |
getViewTemplates()
List of templates that are used to render the view.
|
UifConstants.ViewType |
getViewTypeName()
View type name the view is associated with the view instance
|
protected void |
initializeDialogLoadScript(UifFormBase form)
Helper method to set the view's load script to open a dialog.
|
protected void |
initializeDialogReclocationScript()
Without this script dialogs might be associated with a non visible action (i.e.
|
boolean |
isApplyDirtyCheck()
Indicates whether the form should be validated for dirtyness.
|
boolean |
isDisableBrowserCache()
Enables functionality to bust the browsers cache by appending an unique cache key.
|
boolean |
isDisableNativeAutocomplete()
Indicates whether the browser autocomplete functionality should be disabled for the
entire form (adds autocomplete="off").
|
boolean |
isGrowlMessagingEnabled()
Whether to use growls to show messages - info, warning and error
|
boolean |
isMergeWithPageItems()
Indicates whether the default sections specified in the page items list
should be included for this view.
|
boolean |
isPersistFormToSession()
Indicates whether the form (model) associated with the view should be stored in the user session.
|
boolean |
isSinglePageView()
Indicates whether the View only has a single page
Group or contains multiple page Group instances.
|
boolean |
isStickyApplicationFooter()
If true, the applicationFooter will become sticky (fixed to bottom of window).
|
boolean |
isStickyApplicationHeader()
Set to true to make the applicationHeader sticky (fixed to top of window)
|
boolean |
isStickyBreadcrumbs()
If true, the breadcrumb widget will be sticky (fixed to top of window).
|
boolean |
isStickyFooter()
If true, the view footer will become sticky (fixed to bottom of window).
|
boolean |
isStickyHeader()
If true, the ViewHeader for this view will be sticky (fixed to top of window).
|
boolean |
isStickyTopGroup()
If true, the top group will be sticky (fixed to top of window).
|
boolean |
isSupportsRequestOverrideOfReadOnlyFields()
Indicates whether the view allows read only fields to be specified on the request URL which will
override the view setting.
|
boolean |
isTranslateCodesOnReadOnlyDisplay()
Returns whether the current view supports displaying
KualiCode 's name as additional display value |
boolean |
isUnifiedHeader()
When true, this view will use a unified header - the page header will be omitted and its title will be used
in the ViewHeader supportTitle property (dynamically updated on page change).
|
boolean |
isUseLibraryCssClasses()
True if the libraryCssClasses set on components will be output to their class attribute, false otherwise.
|
void |
notifyCompleted(ViewLifecyclePhase phase)
Receive notification that a lifecycle phase, and all successor phases, have been completed on
this component.
|
void |
performApplyModel(Object model,
LifecycleElement parent)
The following updates are done here:
Invoke expression evaluation on view theme
Invoke theme to configure defaults
|
void |
performFinalize(Object model,
LifecycleElement parent)
The following is performed:
Adds to its document ready script the setupValidator js function for setting
up the validator for this view
The following finalization is performed:
Sets the headerText of the header Group if it is blank
Set the messageText of the summary Message if it is blank
Finalizes LayoutManager
The following finalization is done here:
progressiveRender and conditionalRefresh variables are processed if set
If any of the style properties were given, sets the style string on the style property
Set the skipInTabOrder flag for nested components
The last phase before the view is rendered
|
void |
performInitialization(Object model)
The following initialization is performed:
If a single paged view, set items in page group and put the page in
the items list
If
ViewSessionPolicy.enableTimeoutWarning is enabled add the session timeout dialogs to the
views list of dialog groups
The following initialization is performed:
Sorts the containers list of components
Initializes the instructional field if necessary
Initializes LayoutManager
The following updates are done here:
Invoke performInitialize on component modifiers
Initializes the component |
void |
setActionFlags(Map<String,Boolean> actionFlags) |
void |
setAdditionalCssFiles(List<String> additionalCssFiles) |
void |
setAdditionalHeadLinks(List<HeadLink> additionalHeadLinks) |
void |
setAdditionalMetaTags(List<MetaTag> additionalMetaTags) |
void |
setAdditionalScriptFiles(List<String> additionalScriptFiles) |
void |
setApplicationFooter(Group applicationFooter) |
void |
setApplicationHeader(Header applicationHeader) |
void |
setApplicationTitleText(String applicationTitleText) |
void |
setApplyDirtyCheck(boolean applyDirtyCheck) |
void |
setAuthorizer(ViewAuthorizer authorizer) |
void |
setAuthorizerClass(Class<? extends ViewAuthorizer> authorizerClass)
Setter for the view's authorizer by class
|
void |
setBreadcrumbItem(BreadcrumbItem breadcrumbItem) |
void |
setBreadcrumbOptions(BreadcrumbOptions breadcrumbOptions) |
void |
setBreadcrumbs(Breadcrumbs breadcrumbs) |
void |
setBuildFooter(Group buildFooter) |
void |
setContentContainerCssClasses(List<String> contentContainerCssClasses) |
void |
setCurrentPageId(String currentPageId) |
void |
setDefaultBindingObjectPath(String defaultBindingObjectPath) |
void |
setDialogs(List<Group> dialogs) |
void |
setDisableBrowserCache(boolean disableBrowserCache) |
void |
setDisableNativeAutocomplete(boolean disableNativeAutocomplete) |
void |
setEditModes(Map<String,Boolean> editModes) |
void |
setEntryPageId(String entryPageId) |
void |
setExpressionVariables(Map<String,String> expressionVariables) |
void |
setFormClass(Class<?> formClass) |
void |
setGrowlMessagingEnabled(boolean growlMessagingEnabled)
enable or disable showing of messages using growls
|
void |
setGrowls(Growls growls) |
void |
setItems(List<? extends Component> items)
Setter for the containers list of components
|
void |
setMergeWithPageItems(boolean mergeWithPageItems) |
void |
setNamespaceCode(String namespaceCode)
Setter for the bean's associated namespace code
|
void |
setNavigation(Group navigation) |
void |
setNavigationBlockUI(BlockUI navigationBlockUI)
Set the navigation BlockUI used with single page blocking
(such as full page loading/saving)
|
protected void |
setNestedComponentId(Component component,
String newId)
Helper method for setting a new ID for the nested components
|
void |
setObjectPathToConcreteClassMapping(Map<String,Class<?>> objectPathToConcreteClassMapping) |
void |
setPage(PageGroup page) |
void |
setParentLocation(ParentLocation parentLocation) |
void |
setPathBasedBreadcrumbs(List<BreadcrumbItem> pathBasedBreadcrumbs)
The pathBasedBreadcrumbs for this View.
|
void |
setPersistFormToSession(boolean persistFormToSession) |
void |
setPreloadPoolSize(int preloadPoolSize) |
void |
setPreLoadScript(String preLoadScript) |
void |
setPresentationController(ViewPresentationController presentationController) |
void |
setPresentationControllerClass(Class<? extends ViewPresentationController> presentationControllerClass)
Setter for the view's presentation controller by class
|
void |
setRefreshBlockUI(BlockUI refreshBlockUI)
Set the refresh BlockUI used with single element blocking
(such as ajax based element loading/updates)
|
void |
setRequestAuthorizationCacheClass(Class<? extends RequestAuthorizationCache> requestAuthorizationCacheClass) |
void |
setSessionPolicy(ViewSessionPolicy sessionPolicy) |
void |
setSinglePageView(boolean singlePageView) |
void |
setStateMapping(StateMapping stateMapping) |
void |
setStateObjectBindingPath(String stateObjectBindingPath)
The stateObject's binding path, this will be used along with the StateMapping's statePropertyName to
determine what field in the model state information is stored in for this view.
|
void |
setStickyApplicationFooter(boolean stickyApplicationFooter) |
void |
setStickyApplicationHeader(boolean stickyApplicationHeader) |
void |
setStickyBreadcrumbs(boolean stickyBreadcrumbs) |
void |
setStickyFooter(boolean stickyFooter) |
void |
setStickyHeader(boolean stickyHeader) |
void |
setStickyTopGroup(boolean stickyTopGroup) |
void |
setSupportsRequestOverrideOfReadOnlyFields(boolean supportsRequestOverrideOfReadOnlyFields) |
void |
setTheme(ViewTheme theme) |
void |
setTopGroup(Group topGroup) |
void |
setTranslateCodesOnReadOnlyDisplay(boolean translateCodesOnReadOnlyDisplay)
Indicates whether the Name of the Code should be displayed when a property is of type
KualiCode |
void |
setUnifiedHeader(boolean unifiedHeader) |
void |
setUseLibraryCssClasses(boolean useLibraryCssClasses) |
void |
setViewHelperService(ViewHelperService viewHelperService) |
void |
setViewHelperServiceClass(Class<? extends ViewHelperService> viewHelperServiceClass)
Setter for the
ViewHelperService class name
Also initializes the viewHelperService |
void |
setViewName(String viewName) |
void |
setViewRequestParameters(Map<String,String> viewRequestParameters) |
void |
setViewTemplates(List<String> viewTemplates)
Setter for the the list of template names that should be included to render the view
|
void |
setViewTypeName(UifConstants.ViewType viewTypeName) |
void |
sortItems()
Performs sorting of the container items based on the order property
|
getAdditionalTemplates, getDefaultItemPosition, getEnterKeyAction, getFooter, getHeader, getHeaderText, getHelp, getHelpTitle, getInstructionalMessage, getInstructionalText, getLayoutManager, getValidationMessages, isProcessRemoteFieldHolders, setDefaultItemPosition, setEnterKeyAction, setFooter, setHeader, setHeaderText, setHelp, setInstructionalMessage, setInstructionalText, setLayoutManager, setRenderFooter, setRenderHeader, setTooltipOfComponent, setValidationMessages
addAriaAttribute, addDataAttribute, addScriptDataAttribute, addStyleClass, addWrapperCssClass, appendToStyle, checkMutable, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAlign, getAriaAttributes, getAriaAttributesAsString, getCanCopyOnReadOnly, getCellWidth, getColSpan, getComponentModifiers, getComponentSecurity, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContainerIdSuffix, getContext, getCssClasses, getCssGridSizes, getDataAttributes, getEventHandlerScript, getExcludeIf, getExcludeUnless, getFieldsToSendOnRefresh, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getId, getLibraryCssClasses, getMethodToCallOnRefresh, getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnInputScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, getOrder, getPhasePathMapping, getPostRenderContent, getPreRenderContent, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getReadOnly, getRefreshTimer, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRole, getRowSpan, getScriptDataAttributes, getScriptDataAttributesJs, getSimpleDataAttributes, getStyle, getStyleClassesAsString, getTemplate, getTemplateName, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, getValign, getViewPath, getViewStatus, getWidth, getWrapperCssClasses, getWrapperCssClassesAsString, getWrapperStyle, initializeComponentSecurity, isDisableSessionPersistence, isDisclosedByAction, isEditAuthz, isFinal, isForceSessionPersistence, isHidden, isInitialized, isModelApplied, isMutable, isOmitFromFormPost, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isRefreshedByAction, isRender, isRendered, isResetDataOnRefresh, isRetrieveViaAjax, isSelfRendered, isSkipInTabOrder, isViewAuthz, pushAllToContext, pushObjectToContext, pushToPropertyReplacerContext, setAdditionalComponentsToRefresh, setAdditionalCssClasses, setAlign, setAriaAttributes, setCanCopyOnReadOnly, setCellWidth, setColSpan, setComponentModifiers, setComponentSecurity, setConditionalRefresh, setContainerIdSuffix, setContext, setCssClasses, setCssGridSizes, setDataAttributes, setDisableSessionPersistence, setDisclosedByAction, setEditAuthz, setExcludeIf, setExcludeUnless, setFieldsToSendOnRefresh, setFinalizeMethodAdditionalArguments, setFinalizeMethodInvoker, setFinalizeMethodToCall, setForceSessionPersistence, setHidden, setId, setLibraryCssClasses, setMethodToCallOnRefresh, setOmitFromFormPost, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnInputScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScript, setOrder, setPhasePathMapping, setPostRenderContent, setPreRenderContent, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshTimer, setRefreshWhenChangedPropertyNames, setRender, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRetrieveViaAjax, setRole, setRowSpan, setScriptDataAttributes, setSelfRendered, setSkipInTabOrder, setStyle, setTemplate, setTemplateName, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip, setValign, setViewAuthz, setViewPath, setViewStatus, setWidth, setWrapperCssClasses, setWrapperStyle, skipLifecycle
getExpressionGraph, getPropertyExpression, getPropertyExpressions, setExpressionGraph, setPropertyExpressions
copy, dataDictionaryPostProcessing, getComponentCode, setComponentCode
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
addAriaAttribute, addDataAttribute, addScriptDataAttribute, addStyleClass, addWrapperCssClass, appendToStyle, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAlign, getAriaAttributes, getAriaAttributesAsString, getCanCopyOnReadOnly, getCellWidth, getColSpan, getComponentModifiers, getComponentSecurity, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContext, getCssClasses, getCssGridSizes, getDataAttributes, getEventHandlerScript, getExcludeIf, getExcludeUnless, getFieldsToSendOnRefresh, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getLibraryCssClasses, getMethodToCallOnRefresh, getOrder, getPostRenderContent, getPreRenderContent, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getReadOnly, getRefreshTimer, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRole, getRowSpan, getScriptDataAttributes, getScriptDataAttributesJs, getSimpleDataAttributes, getStyle, getStyleClassesAsString, getTemplate, getTemplateName, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, getValign, getWidth, getWrapperCssClasses, getWrapperStyle, isDisableSessionPersistence, isDisclosedByAction, isForceSessionPersistence, isHidden, isOmitFromFormPost, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isRefreshedByAction, isRendered, isResetDataOnRefresh, isRetrieveViaAjax, isSelfRendered, setAdditionalComponentsToRefresh, setAdditionalCssClasses, setAlign, setAriaAttributes, setCanCopyOnReadOnly, setCellWidth, setColSpan, setComponentModifiers, setComponentSecurity, setConditionalRefresh, setContext, setCssClasses, setCssGridSizes, setDataAttributes, setDisableSessionPersistence, setDisclosedByAction, setFieldsToSendOnRefresh, setForceSessionPersistence, setHidden, setLibraryCssClasses, setOmitFromFormPost, setOrder, setPostRenderContent, setPreRenderContent, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshTimer, setRefreshWhenChangedPropertyNames, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRetrieveViaAjax, setRole, setRowSpan, setScriptDataAttributes, setSelfRendered, setStyle, setTemplate, setTemplateName, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip, setValign, setViewStatus, setWidth, setWrapperCssClasses, setWrapperStyle
getExpressionGraph, getPropertyExpression, getPropertyExpressions, setExpressionGraph, setPropertyExpressions
dataDictionaryPostProcessing, getComponentCode
checkMutable, getContainerIdSuffix, getId, getPhasePathMapping, getViewPath, getViewStatus, isFinal, isInitialized, isModelApplied, isMutable, isRender, pushAllToContext, pushObjectToContext, setContainerIdSuffix, setId, setPhasePathMapping, setRender, setViewPath, skipLifecycle
getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnInputScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnInputScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScript
protected boolean applyDirtyCheck
public View()
public void performInitialization(Object model)
ViewSessionPolicy.enableTimeoutWarning
is enabled add the session timeout dialogs to the
views list of dialog groupsWhere components can set defaults and setup other necessary state. The initialize method should only be called once per component lifecycle and is invoked within the initialize phase of the view lifecylce.
performInitialization
in interface LifecycleElement
performInitialization
in class ContainerBase
model
- - object instance containing the view dataComponentDefaultInitializeTask
protected void initializeDialogLoadScript(UifFormBase form)
form
- the form containing dataprotected void initializeDialogReclocationScript()
public void afterEvaluateExpression()
In general, this method is preferred to LifecycleElement.performApplyModel(Object, LifecycleElement)
for populating model data via code, since it is called before client-side state is synchronize.
afterEvaluateExpression
in interface Component
afterEvaluateExpression
in class ComponentBase
public void performApplyModel(Object model, LifecycleElement parent)
performApplyModel
in interface LifecycleElement
performApplyModel
in class ContainerBase
model
- - Top level object containing the data (could be the form or a
top level business object, dto)parent
- parent lifecycle elementpublic void performFinalize(Object model, LifecycleElement parent)
Here final preparations can be made based on the updated view state.
performFinalize
in interface LifecycleElement
performFinalize
in class ContainerBase
model
- - top level object containing the dataparent
- - parent componentprotected void setNestedComponentId(Component component, String newId)
component
- component to adjust ID fornewId
- public void notifyCompleted(ViewLifecyclePhase phase)
notifyCompleted
in interface LifecycleElement
notifyCompleted
in class ComponentBase
phase
- The completed view lifecycle phasepublic List<BreadcrumbItem> getBreadcrumbItems()
public Set<Class<? extends Component>> getSupportedComponents()
Set
of Component
classes that may be placed
into the container
If an empty or null list is returned, it is assumed the container supports all components. The returned set will be used by dictionary validators and allows renders to make assumptions about the contained components
public String getComponentTypeName()
This is used within the rendering layer to pass the component instance into the template. The component instance is exported under the name given by this method.
@ViewLifecycleRestriction(exclude="PRE_PROCESS") public PageGroup getCurrentPage()
@ViewLifecycleRestriction(value="PRE_PROCESS") public List<Component> getPagesForPreprocessing()
Note this is necessary so we get IDs assigned for all the pages during the pre-process phase. For other phases, only the current page is picked up.
public void sortItems()
sortItems
in interface Container
sortItems
in class ContainerBase
public String getNamespaceCode()
The namespace code is used within the framework in such places as permission checks and parameter retrieval
getNamespaceCode
in interface DictionaryBean
getNamespaceCode
in class DictionaryBeanBase
DictionaryBean.getNamespaceCode()
public void setNamespaceCode(String namespaceCode)
DictionaryBeanBase
setNamespaceCode
in class DictionaryBeanBase
getNamespaceCode()
public String getViewName()
A view type like the LookupView might have several views for the same object class, but one that is the 'default' lookup and another that is the 'advanced' lookup. Therefore the name on the first could be set to 'default', and likewise the name for the second 'advanced'
public void setViewName(String viewName)
getViewName()
public boolean isUnifiedHeader()
public void setUnifiedHeader(boolean unifiedHeader)
isUnifiedHeader()
public Group getTopGroup()
public void setTopGroup(Group topGroup)
getTopGroup()
public Header getApplicationHeader()
When deploying outside a portal, the application header and footer property can be configured to display a consistent header/footer across all views. Here application logos, menus, login controls and so on can be rendered
public void setApplicationHeader(Header applicationHeader)
getApplicationHeader()
public Group getApplicationFooter()
When deploying outside a portal, the application header and footer property can be configured to display a consistent header/footer across all views. Here such things as application links, copyrights and so on can be rendered
public void setApplicationFooter(Group applicationFooter)
getApplicationFooter()
public Group getBuildFooter()
public void setBuildFooter(Group buildFooter)
getBuildFooter()
public String getApplicationTitleText()
public void setApplicationTitleText(String applicationTitleText)
getApplicationTitleText()
public boolean isStickyTopGroup()
public void setStickyTopGroup(boolean stickyTopGroup)
isStickyTopGroup()
public boolean isStickyBreadcrumbs()
public void setStickyBreadcrumbs(boolean stickyBreadcrumbs)
isStickyBreadcrumbs()
public boolean isStickyHeader()
public void setStickyHeader(boolean stickyHeader)
isStickyHeader()
public boolean isStickyApplicationHeader()
public void setStickyApplicationHeader(boolean stickyApplicationHeader)
isStickyApplicationHeader()
public boolean isStickyFooter()
public void setStickyFooter(boolean stickyFooter)
isStickyFooter()
public boolean isStickyApplicationFooter()
public void setStickyApplicationFooter(boolean stickyApplicationFooter)
isStickyApplicationFooter()
public List<String> getContentContainerCssClasses()
Wrapping the content gives the ability to move between a fluid width container or a fixed width container. The div is also wraps content inside sticky elements (header and footer), so visual treatment can be given to the full width of the screen while restricting the area of the content.
In Bootstrap, use 'container-fluid' for a fluid width container, and 'container' for a fixed width container.
public void setContentContainerCssClasses(List<String> contentContainerCssClasses)
getContentContainerCssClasses()
public String getContentContainerClassesAsString()
getContentContainerCssClasses()
as a concatenated string (each class
is separated by a space).public String getEntryPageId()
public void setEntryPageId(String entryPageId)
getEntryPageId()
public String getCurrentPageId()
If current page id is not set, it is set to the configured entry page or first item in list id
public void setCurrentPageId(String currentPageId)
getCurrentPageId()
public Group getNavigation()
Provides configuration necessary to render the navigation. This includes navigation items in addition to configuration for the navigation renderer
public void setNavigation(Group navigation)
getNavigation()
public Class<?> getFormClass()
The form is the top level object for all the view's data and is used to present and accept data in the user interface. All form classes should extend UifFormBase
UifFormBase
public void setFormClass(Class<?> formClass)
getFormClass()
public String getDefaultBindingObjectPath()
public void setDefaultBindingObjectPath(String defaultBindingObjectPath)
getDefaultBindingObjectPath()
public Map<String,Class<?>> getObjectPathToConcreteClassMapping()
For properties that have an abstract or interface type, it is not possible to perform operations like getting/settings property values and getting information from the dictionary. When these properties are encountered in the object graph, this Map will be consulted to determine the concrete type to use
e.g. Suppose we have a property document.accountingLine.accountNumber and the accountingLine property on the document instance has an interface type 'AccountingLine'. We can then put an entry into this map with key 'document.accountingLine', and value 'org.kuali.rice.sampleapp.TravelAccountingLine'. When getting the property type or an entry from the dictionary for accountNumber, the TravelAccountingLine class will be used
public void setObjectPathToConcreteClassMapping(Map<String,Class<?>> objectPathToConcreteClassMapping)
public List<String> getAdditionalScriptFiles()
These files are brought into the HTML page along with common script files configured for the Rice application. Each entry contain the path to the CSS file, either a relative path, path from web root, or full URI
e.g. '/krad/scripts/myScript.js', '../scripts/myScript.js', 'http://my.edu/web/myScript.js'
public void setAdditionalScriptFiles(List<String> additionalScriptFiles)
getAdditionalScriptFiles()
public List<String> getAdditionalCssFiles()
These files are brought into the HTML page along with common CSS files configured for the Rice application. Each entry should contain the path to the CSS file, either a relative path, path from web root, or full URI
e.g. '/krad/css/stacked-view.css', '../css/stacked-view.css', 'http://my.edu/web/stacked-view.css'
public void setAdditionalCssFiles(List<String> additionalCssFiles)
getAdditionalCssFiles()
public List<HeadLink> getAdditionalHeadLinks()
public void setAdditionalHeadLinks(List<HeadLink> additionalHeadLinks)
getAdditionalHeadLinks()
public List<MetaTag> getAdditionalMetaTags()
public void setAdditionalMetaTags(List<MetaTag> additionalMetaTags)
getAdditionalMetaTags()
public boolean isUseLibraryCssClasses()
public void setUseLibraryCssClasses(boolean useLibraryCssClasses)
isUseLibraryCssClasses()
public List<String> getViewTemplates()
This list will be populated by unique template names as the components of the view are being processed. Additional templates can be added in the view configuration if desired. At the beginning of the the view rendering, each template in the list will then be included or processed by the template language
Note the user of this depends on the template language being used for rendering. Some languages might require including the template for each component instance (for example JSP templates). While others might simply include markup that is then available for rendering each component instance (for example FreeMarker which has a macro for each component that the template defines)
public void addViewTemplate(String template)
template
- path to template to addpublic void setViewTemplates(List<String> viewTemplates)
viewTemplates
- public UifConstants.ViewType getViewTypeName()
Views that share common features and functionality can be grouped by the
view type. Usually view types extend the View
class to
provide additional configuration and to set defaults. View types can also
implement the ViewTypeService
to add special indexing and
retrieval of views
public void setViewTypeName(UifConstants.ViewType viewTypeName)
getViewTypeName()
public Class<? extends ViewHelperService> getViewHelperServiceClass()
ViewHelperService
public void setViewHelperServiceClass(Class<? extends ViewHelperService> viewHelperServiceClass)
ViewHelperService
class name
Also initializes the viewHelperServiceviewHelperServiceClass
- public ViewHelperService getViewHelperService()
ViewHelperService
associated with the Viewpublic void setViewHelperService(ViewHelperService viewHelperService)
getViewHelperServiceClass()
public void clearIndex()
public ViewIndex getViewIndex()
public Map<String,String> getViewRequestParameters()
Views can be configured by parameters. These might impact which parts of the view are rendered or how the view behaves. Generally these would get passed in when a new view is requested (by request parameters). These will be used to initially populate the view properties. In addition, on a post the view will be rebuilt and properties reset again by the allow request parameters.
Example parameter would be for MaintenaceView whether a New, Edit, or Copy was requested (maintenance mode)
public void setViewRequestParameters(Map<String,String> viewRequestParameters)
getViewRequestParameters()
public boolean isPersistFormToSession()
The form class (or model) is used to hold the data that backs the view along with the built view object. Storing the form instance in session allows many things:
Note all forms will be cleared when the user session expires (based on the rice configuration). In addition, the framework enables clear points on certain actions to remove the form when it is no longer needed
public void setPersistFormToSession(boolean persistFormToSession)
isPersistFormToSession()
public ViewSessionPolicy getSessionPolicy()
public void setSessionPolicy(ViewSessionPolicy sessionPolicy)
getSessionPolicy()
public int getPreloadPoolSize()
public void setPreloadPoolSize(int preloadPoolSize)
public ViewPresentationController getPresentationController()
The presentation controller is consulted to determine component (group, field) state such as required, read-only, and hidden. The presentation controller does not take into account user permissions. The presentation controller can also output action flags and edit modes that will be set onto the view instance and can be referred to by conditional expressions
public void setPresentationController(ViewPresentationController presentationController)
getPresentationController()
public void setPresentationControllerClass(Class<? extends ViewPresentationController> presentationControllerClass)
presentationControllerClass
- public ViewAuthorizer getAuthorizer()
The authorizer class is consulted to determine component (group, field) state such as required, read-only, and hidden based on the users permissions. It typically communicates with the Kuali Identity Management system to determine roles and permissions. It is used with the presentation controller and dictionary conditional logic to determine the final component state. The authorizer can also output action flags and edit modes that will be set onto the view instance and can be referred to by conditional expressions
public void setAuthorizer(ViewAuthorizer authorizer)
getAuthorizer()
public void setAuthorizerClass(Class<? extends ViewAuthorizer> authorizerClass)
authorizerClass
- public Map<String,Boolean> getActionFlags()
These can be used in conditional expressions in the dictionary or by other UI logic
public void setActionFlags(Map<String,Boolean> actionFlags)
getActionFlags()
public Map<String,Boolean> getEditModes()
These can be used in conditional expressions in the dictionary or by other UI logic
public void setEditModes(Map<String,Boolean> editModes)
getEditModes()
public Class<? extends RequestAuthorizationCache> getRequestAuthorizationCacheClass()
public void setRequestAuthorizationCacheClass(Class<? extends RequestAuthorizationCache> requestAuthorizationCacheClass)
public Map<String,String> getExpressionVariables()
Each Map entry contains one expression variables, where the map key gives the name for the variable, and the map value gives the variable expression. The variables expressions will be evaluated before conditional logic is run and made available as variables for other conditional expressions. Variable expressions can be based on the model and any object contained in the view's context
public void setExpressionVariables(Map<String,String> expressionVariables)
getExpressionVariables()
public boolean isSinglePageView()
In the case of a single page it is assumed the group's items
list contains the section groups for the page, and the page itself is
given by the page property (getPage()
. This is for convenience
of configuration and also can drive other configuration like styling
public void setSinglePageView(boolean singlePageView)
isSinglePageView()
public boolean isMergeWithPageItems()
public void setMergeWithPageItems(boolean mergeWithPageItems)
isMergeWithPageItems()
@ViewLifecycleRestriction public PageGroup getPage()
isSinglePageView()
, gives the page
Group the view should render. The actual items for the page
is taken from the group's items list (getItems()
, and set onto
the give page group. This is for convenience of configuration.@ViewLifecycleRestriction public List<? extends Component> getItems()
List
of Component
instances that are held by
the container
Contained components are rendered within the section template by calling
the associated LayoutManager
.
getItems
in interface Container
getItems
in class ContainerBase
public void setItems(List<? extends Component> items)
setItems
in interface Container
setItems
in class ContainerBase
items
- list of components to set in container@ViewLifecycleRestriction(value="FINALIZE", condition="!ajaxRequest || (ajaxReturnType eq \'update-view\') || (ajaxReturnType eq \'update-page\')") public List<Group> getDialogs()
public void setDialogs(List<Group> dialogs)
getDialogs()
public Breadcrumbs getBreadcrumbs()
public void setBreadcrumbs(Breadcrumbs breadcrumbs)
breadcrumbs
- the breadcrumbs to setpublic BreadcrumbOptions getBreadcrumbOptions()
Render options set at the view level are always ignored (only apply to page level BreadcrumbOptions). BreadcrumbOptions for homewardPathBreadcrumbs, preViewBreadcrumbs, prePageBreadcrumbs, and breadcrumbOverrides are inherited by child pages unless they override them themselves.
public void setBreadcrumbOptions(BreadcrumbOptions breadcrumbOptions)
getBreadcrumbOptions()
public BreadcrumbItem getBreadcrumbItem()
public void setBreadcrumbItem(BreadcrumbItem breadcrumbItem)
getBreadcrumbItem()
public ParentLocation getParentLocation()
By defining a parent with these urls defined, a breadcrumb chain can be generated and displayed automatically before this View's breadcrumbItem(s). To chain multiple views, the urls must be defining viewId and controllerMapping settings instead of setting an href directly (this will end the chain). If labels are not set on parentLocations, the labels will attempt to be derived from parent views/pages breadcrumbItem and headerText - if these contain expressions which cannot be evaluated in the current context an exception will be thrown
public void setParentLocation(ParentLocation parentLocation)
getParentLocation()
public List<BreadcrumbItem> getPathBasedBreadcrumbs()
public void setPathBasedBreadcrumbs(List<BreadcrumbItem> pathBasedBreadcrumbs)
pathBasedBreadcrumbs
- public Growls getGrowls()
public BlockUI getRefreshBlockUI()
public void setRefreshBlockUI(BlockUI refreshBlockUI)
refreshBlockUI
- public BlockUI getNavigationBlockUI()
public void setNavigationBlockUI(BlockUI navigationBlockUI)
navigationBlockUI
- public boolean isGrowlMessagingEnabled()
Growls use the messages contained in the message map. If enabled, info messages in their entirety will be displayed in growls, for warning and error messages a growl message will notify the user that these messages exist on the page.
If this setting is disabled, it is recommended that infoMessage display be enabled for the page ValidationMessages bean in order to display relevant information to the user. Note: the growl scripts are built out in the PageGroup class.
public void setGrowlMessagingEnabled(boolean growlMessagingEnabled)
growlMessagingEnabled
- the growlMessagingEnabled to setpublic boolean isApplyDirtyCheck()
For FormView, it's necessary to validate when the user tries to navigate out of the form. If set, all the InputFields will be validated on refresh, navigate, cancel or close Action or on form unload and if dirty, displays a message and user can decide whether to continue with the action or stay on the form. For lookup and inquiry, it's not needed to validate
public void setApplyDirtyCheck(boolean applyDirtyCheck)
isApplyDirtyCheck()
public boolean isTranslateCodesOnReadOnlyDisplay()
KualiCode
's name as additional display valuepublic void setTranslateCodesOnReadOnlyDisplay(boolean translateCodesOnReadOnlyDisplay)
KualiCode
translateCodesOnReadOnlyDisplay
- indicates whether KualiCode's name should be included.public boolean isSupportsRequestOverrideOfReadOnlyFields()
If enabled, the readOnlyFields request parameter can be sent to indicate fields that should be set read only
public void setSupportsRequestOverrideOfReadOnlyFields(boolean supportsRequestOverrideOfReadOnlyFields)
public boolean isDisableNativeAutocomplete()
The browser's native autocomplete functionality can cause issues with security fields and also fields with the UIF suggest widget enabled
public void setDisableNativeAutocomplete(boolean disableNativeAutocomplete)
isDisableNativeAutocomplete()
public boolean isDisableBrowserCache()
Since response headers are unreliable for preventing caching in all browsers, the framework uses a technique for updating the URL to include an unique cache key. If the HTML 5 History API is supported a parameter can be added to the URL which causes the browser to not find the cached page when the user goes back. If not the framework falls back to using a hash key and resubmitting using script to pull the latest
public void setDisableBrowserCache(boolean disableBrowserCache)
isDisableBrowserCache()
public String getPreLoadScript()
Many used to set server variables client side
public void setPreLoadScript(String preLoadScript)
getPreLoadScript()
public ViewTheme getTheme()
public void setTheme(ViewTheme theme)
getTheme()
public String getStateObjectBindingPath()
public void setStateObjectBindingPath(String stateObjectBindingPath)
stateObjectBindingPath
- public StateMapping getStateMapping()
The state mapping object is used to determine the state information for a view, it must include an ordered list of states, and where to find the state information for the view. A stateMapping must be set for state based validation to occur. When stateMapping information is not included, the view's model is considered stateless and all constraints will apply regardless of their state information or replacements (ie, they will function as they did in version 2.1).
public void setStateMapping(StateMapping stateMapping)
getStateMapping()
public Map<String,Object> getPreModelContext()
public View clone() throws CloneNotSupportedException
ComponentBase
Object.clone()
to assign the public modifier.clone
in interface Copyable
clone
in class ComponentBase
Object.clone()
CloneNotSupportedException
- If Cloneable
is not implemented. This should not
be possible when using this interface.ComponentBase.clone()
public void completeValidation(ValidationTrace tracer)
completeValidation
in interface Component
completeValidation
in class ContainerBase
tracer
- Record of component's locationCopyright © 2005–2015 The Kuali Foundation. All rights reserved.