public class View extends ContainerBase
GroupContainer
instances tied together with a common page layout
and navigation.
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 ViewIndex |
viewIndex |
INITIAL_ORDER_VALUE
Constructor and Description |
---|
View() |
Modifier and Type | Method and Description |
---|---|
protected void |
assignComponentId(Component component)
Assigns an id to the given component
|
void |
assignComponentIds(Component component)
Assigns an id (if not configured) to a component and all its child components
|
protected void |
assignPageIds(View view)
Special handling of assigning ids for the view component to assure each page and all its children gets an
id and the page ids are always the same
|
void |
completeValidation(ValidationTrace tracer)
Validates different requirements of component compiling a series of reports detailing information on errors
found in the component.
|
protected <T> void |
copyProperties(T component)
Copies the properties over for the copy method
|
BooleanMap |
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<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
|
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.
|
BreadcrumbOptions |
getBreadcrumbOptions()
The breadcrumbOptions for this view.
|
Breadcrumbs |
getBreadcrumbs()
Breadcrumb widget used for displaying homeward path and history
|
List<Component> |
getComponentsForLifecycle()
List of components that are contained within the component and should be sent through
the lifecycle
|
String |
getComponentTypeName()
The name for the component type
|
PageGroup |
getCurrentPage()
Iterates through the contained page items and returns the Page that
matches the set current page id
|
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
|
BooleanMap |
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
|
int |
getIdSequence()
Current sequence value for id assignment
|
List<? extends Group> |
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() |
String |
getNextId()
Returns the next unique id available for components within the view instance
|
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. |
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.
|
String |
getPreLoadScript()
Script that is executed at the beginning of page load (before any other script)
|
ViewPresentationController |
getPresentationController()
PresentationController that should be used for the
View instance |
BlockUI |
getRefreshBlockUI() |
ViewSessionPolicy |
getSessionPolicy() |
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 |
getViewMenuGroupName()
Provides a grouping string for the view to group its menu link (within a
portal for instance)
|
Link |
getViewMenuLink()
Provides configuration for displaying a link to the view from an
application menu
|
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
|
String |
getViewStatus()
Indicates what lifecycle phase the View instance is in
|
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
|
void |
index()
Invoked to produce a ViewIndex of the current view's components
|
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 |
isFinal()
Indicates whether the view has been updated from the model and final
updates made
|
boolean |
isGrowlMessagingEnabled()
whether to use growls to show messages - info, warning and error
|
boolean |
isInitialized()
Indicates whether the view has been initialized
|
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 |
performApplyModel(View view,
Object model,
Component parent)
The following updates are done here:
Invoke expression evaluation on view theme
Invoke theme to configure defaults
|
void |
performFinalize(View view,
Object model,
Component parent)
The following is performed:
Adds to its document ready script the setupValidator js function for setting
up the validator for this view
|
void |
performInitialization(View view,
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
|
void |
setActionFlags(BooleanMap actionFlags)
Setter for the action flags Map
|
void |
setAdditionalCssFiles(List<String> additionalCssFiles)
Setter for the List of additional CSS files to included with the
View |
void |
setAdditionalScriptFiles(List<String> additionalScriptFiles)
Setter for the List of additional script files to included with the
View |
void |
setApplicationFooter(Group applicationFooter)
Setter for the application footer
|
void |
setApplicationHeader(Header applicationHeader)
Setter for the application header
|
void |
setApplyDirtyCheck(boolean applyDirtyCheck)
Setter for dirty validation.
|
void |
setAuthorizer(ViewAuthorizer authorizer)
Setter for the view's authorizer
|
void |
setAuthorizerClass(Class<? extends ViewAuthorizer> authorizerClass)
Setter for the view's authorizer by class
|
void |
setBreadcrumbItem(BreadcrumbItem breadcrumbItem)
Set the breadcrumbItem
|
void |
setBreadcrumbOptions(BreadcrumbOptions breadcrumbOptions)
Set the breadcrumbOptions
|
void |
setBreadcrumbs(Breadcrumbs breadcrumbs) |
void |
setCurrentPageId(String currentPageId)
Setter for the page id to display
|
void |
setDefaultBindingObjectPath(String defaultBindingObjectPath)
Setter for the default binding object path to use for the view
|
void |
setDialogs(List<Group> dialogs)
Sets the list of dialog groups for this view
|
void |
setDisableBrowserCache(boolean disableBrowserCache)
Setter to disable browser caching of the view
|
void |
setDisableNativeAutocomplete(boolean disableNativeAutocomplete)
Setter to disable browser autocomplete for the view's form
|
void |
setEditModes(BooleanMap editModes)
Setter for the edit modes Map
|
void |
setEntryPageId(String entryPageId)
Setter for default Page id
|
void |
setExpressionVariables(Map<String,String> expressionVariables)
Setter for the view's map of variable expressions
|
void |
setFormClass(Class<?> formClass)
Setter for the form class
|
void |
setGrowlMessagingEnabled(boolean growlMessagingEnabled)
enable or disable showing of messages using growls
|
void |
setGrowls(Growls growls) |
void |
setIdSequence(int idSequence)
Setter for the current id sequence value
|
void |
setItems(List<? extends Component> items)
Setter for the view's
Group instances |
void |
setMergeWithPageItems(boolean mergeWithPageItems)
Setter for the include page default sections indicator
|
void |
setNamespaceCode(String namespaceCode)
Setter for the view's namespace code
|
void |
setNavigation(Group navigation)
Setter for the View's
NavigationGroup |
void |
setNavigationBlockUI(BlockUI navigationBlockUI)
Set the navigation BlockUI used with single page blocking
(such as full page loading/saving)
|
void |
setObjectPathToConcreteClassMapping(Map<String,Class<?>> objectPathToConcreteClassMapping)
Setter for the Map of class implementations keyed by path
|
void |
setPage(PageGroup page)
Setter for the page group for single page views
|
void |
setParentLocation(ParentLocation parentLocation)
Set the parentLocation
|
void |
setPathBasedBreadcrumbs(List<BreadcrumbItem> pathBasedBreadcrumbs)
The pathBasedBreadcrumbs for this View.
|
void |
setPersistFormToSession(boolean persistFormToSession)
Setter for the persist form to session indicator
|
void |
setPreLoadScript(String preLoadScript)
Setter for the pre load script
|
void |
setPresentationController(ViewPresentationController presentationController)
Setter for the view's presentation controller
|
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 |
setSessionPolicy(ViewSessionPolicy sessionPolicy) |
void |
setSinglePageView(boolean singlePageView)
Setter for the single page indicator
|
void |
setStateMapping(StateMapping stateMapping)
Set the 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)
Set to true to make the application footer sticky
|
void |
setStickyApplicationHeader(boolean stickyApplicationHeader)
Set to true to make the applicationHeader sticky
|
void |
setStickyBreadcrumbs(boolean stickyBreadcrumbs)
Set to true to make the breadcrumbs sticky
|
void |
setStickyFooter(boolean stickyFooter)
Set to true to make the view footer sticky
|
void |
setStickyHeader(boolean stickyHeader)
Set to true to make the ViewHeader sticky
|
void |
setStickyTopGroup(boolean stickyTopGroup)
Set to true to make the top group sticky (fixed to top of window)
|
void |
setSupportsRequestOverrideOfReadOnlyFields(boolean supportsRequestOverrideOfReadOnlyFields)
Setter for the the read only field override indicator
|
void |
setTheme(ViewTheme theme)
Setter for The theme which contains stylesheets for this view
|
void |
setTopGroup(Group topGroup)
Set the topGroup component which appears the breadcrumbs and view header
|
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)
Set to true, to use unified header functionality
|
void |
setUseLibraryCssClasses(boolean useLibraryCssClasses)
Set useLibraryCssClasses
|
void |
setViewHelperService(ViewHelperService viewHelperService)
Setter for the
ViewHelperService |
void |
setViewHelperServiceClass(Class<? extends ViewHelperService> viewHelperServiceClass)
Setter for the
ViewHelperService class name
Also initializes the viewHelperService |
void |
setViewMenuGroupName(String viewMenuGroupName)
Setter for the views menu grouping
|
void |
setViewMenuLink(Link viewMenuLink)
Setter for the views link field
|
void |
setViewName(String viewName)
Setter for the view's name
|
void |
setViewRequestParameters(Map<String,String> viewRequestParameters)
Setter for the view's request parameters map
|
void |
setViewStatus(String viewStatus)
Setter for the view status
|
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)
Setter for the view's type name
|
protected void |
sortItems(View view,
Object model)
Override sort method to prevent sorting in the case of a single page view, since the items
will get pushed into the configured page and sorted through the page
|
getComponentPrototypes, getDefaultItemPosition, getFooter, getHeader, getHeaderText, getHelp, getHelpTitle, getInstructionalMessage, getInstructionalText, getLayoutManager, getValidationMessages, setDefaultItemPosition, setFooter, setHeader, setHeaderText, setHelp, setInstructionalMessage, setInstructionalText, setLayoutManager, setRenderFooter, setRenderHeader, setTooltipOfComponent, setValidationMessages
addCellCssClass, addDataAttribute, addDataAttributeIfNonEmpty, addStyleClass, appendToStyle, copy, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAlign, getBaseId, getCellCssClasses, getCellStyle, getCellStyleClassesAsString, getCellWidth, getColSpan, getComponentModifiers, getComponentSecurity, getComponentSecurityClass, 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, 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
getExpressionGraph, getPropertyExpression, getPropertyExpressions, getRefreshExpressionGraph, setExpressionGraph, setPropertyExpressions, setRefreshExpressionGraph
getComponentCode, setComponentCode
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
addCellCssClass, addDataAttribute, addStyleClass, appendToStyle, copy, getAdditionalComponentsToRefresh, getAdditionalComponentsToRefreshJs, getAdditionalCssClasses, getAlign, getBaseId, getCellCssClasses, getCellStyle, getCellWidth, getColSpan, getComponentModifiers, getComponentSecurity, 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, 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
getExpressionGraph, getPropertyExpression, getPropertyExpressions, getRefreshExpressionGraph, setExpressionGraph, setPropertyExpressions, setRefreshExpressionGraph
getComponentCode
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
public View()
public void performInitialization(View view, Object model)
ViewSessionPolicy.enableTimeoutWarning
is enabled add the session timeout dialogs to the
views list of dialog groupsperformInitialization
in interface Component
performInitialization
in class ContainerBase
view
- - view instance in which the component belongsmodel
- - object instance containing the view dataContainerBase.performInitialization(org.kuali.rice.krad.uif.view.View,
Object)
public void performApplyModel(View view, Object model, Component parent)
performApplyModel
in interface Component
performApplyModel
in class ContainerBase
view
- - view instance to which the component belongsmodel
- - Top level object containing the data (could be the form or a
top level business object, dto)ComponentBase.performApplyModel(org.kuali.rice.krad.uif.view.View,
java.lang.Object, org.kuali.rice.krad.uif.component.Component)
public void performFinalize(View view, Object model, Component parent)
performFinalize
in interface Component
performFinalize
in class ContainerBase
view
- - view instance that should be finalized for renderingmodel
- - top level object containing the dataparent
- - parent componentContainerBase.performFinalize(org.kuali.rice.krad.uif.view.View,
Object, org.kuali.rice.krad.uif.component.Component)
public void assignComponentIds(Component component)
component
- component instance to assign id toprotected void assignPageIds(View view)
First the pages are assigned ids sequentially so they always get the same ids regardless of what page is being displayed. Also, since the view doesn't include pages that are not being displayed (or are not the current page) in its tree (components for lifecycle) we need to loop through them explicity and assign ids
view
- view instance containing the pagesprotected void assignComponentId(Component component)
component
- component to assign id topublic List<Component> getComponentsForLifecycle()
Component
Used by ViewHelperService
for the various lifecycle callbacks
getComponentsForLifecycle
in interface Component
getComponentsForLifecycle
in class ContainerBase
ComponentBase.getComponentsForLifecycle()
public Set<Class<? extends Component>> getSupportedComponents()
Container
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
Container.getSupportedComponents()
public String getComponentTypeName()
Component
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.
Component.getComponentTypeName()
public PageGroup getCurrentPage()
protected void sortItems(View view, Object model)
sortItems
in class ContainerBase
view
- view instance containing the containermodel
- model object containing the view datapublic 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)
setNamespaceCode
in class DictionaryBeanBase
namespaceCode
- public String getViewName()
View
instances have the same values for the
properties that are used to retrieve them by their type, the name can be
given to further qualify the view that should be retrieved.
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)
viewName
- public boolean isUnifiedHeader()
public void setUnifiedHeader(boolean unifiedHeader)
unifiedHeader
- public Group getTopGroup()
public void setTopGroup(Group topGroup)
topGroup
- 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)
applicationHeader
- 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)
applicationFooter
- public boolean isStickyTopGroup()
public void setStickyTopGroup(boolean stickyTopGroup)
stickyTopGroup
- public boolean isStickyBreadcrumbs()
public void setStickyBreadcrumbs(boolean stickyBreadcrumbs)
stickyBreadcrumbs
- public boolean isStickyHeader()
public void setStickyHeader(boolean stickyHeader)
stickyHeader
- public boolean isStickyApplicationHeader()
public void setStickyApplicationHeader(boolean stickyApplicationHeader)
stickyApplicationHeader
- public boolean isStickyFooter()
public void setStickyFooter(boolean stickyFooter)
stickyFooter
- public boolean isStickyApplicationFooter()
public void setStickyApplicationFooter(boolean stickyApplicationFooter)
stickyApplicationFooter
- public int getIdSequence()
public void setIdSequence(int idSequence)
idSequence
- public String getNextId()
public String getEntryPageId()
View
is first rendered or when the
current page is not setpublic void setEntryPageId(String entryPageId)
entryPageId
- 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)
currentPageId
- public Group getNavigation()
NavigationGroup
instance for the View
Provides configuration necessary to render the navigation. This includes navigation items in addition to configuration for the navigation renderer.
public void setNavigation(Group navigation)
NavigationGroup
navigation
- public Class<?> getFormClass()
View
instance. 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 UifFormBaseUifFormBase
public void setFormClass(Class<?> formClass)
formClass
- public String getDefaultBindingObjectPath()
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. If
the component does not set its own binding object path it will inherit
the defaultpublic void setDefaultBindingObjectPath(String defaultBindingObjectPath)
defaultBindingObjectPath
- 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)
objectPathToConcreteClassMapping
- public List<String> getAdditionalScriptFiles()
View
. 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)
View
additionalScriptFiles
- public List<String> getAdditionalCssFiles()
View
. 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)
View
additionalCssFiles
- public boolean isUseLibraryCssClasses()
public void setUseLibraryCssClasses(boolean useLibraryCssClasses)
useLibraryCssClasses
- 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 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)
viewTypeName
- public Class<? extends ViewHelperService> getViewHelperServiceClass()
ViewHelperService
that handles the various
phases of the Views lifecycleViewHelperService
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)
ViewHelperService
viewHelperService
- public void index()
public ViewIndex getViewIndex()
View
instance for retrievalpublic 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)
viewRequestParameters
- 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)
persistFormToSession
- public ViewSessionPolicy getSessionPolicy()
public void setSessionPolicy(ViewSessionPolicy sessionPolicy)
public ViewPresentationController getPresentationController()
View
instance
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)
presentationController
- public void setPresentationControllerClass(Class<? extends ViewPresentationController> presentationControllerClass)
presentationControllerClass
- public ViewAuthorizer getAuthorizer()
View
instance
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)
authorizer
- public void setAuthorizerClass(Class<? extends ViewAuthorizer> authorizerClass)
authorizerClass
- public BooleanMap getActionFlags()
These can be used in conditional expressions in the dictionary or by other UI logic
public void setActionFlags(BooleanMap actionFlags)
actionFlags
- public BooleanMap getEditModes()
These can be used in conditional expressions in the dictionary or by other UI logic
public void setEditModes(BooleanMap editModes)
editModes
- 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)
expressionVariables
- public boolean isSinglePageView()
View
only has a single page
Group
or contains multiple page Group
instances. 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)
singlePageView
- public boolean isMergeWithPageItems()
public void setMergeWithPageItems(boolean mergeWithPageItems)
mergeWithPageItems
- 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.public void setPage(PageGroup page)
page
- public List<? extends Group> getItems()
Container
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
ContainerBase.getItems()
public void setItems(List<? extends Component> items)
Group
instancessetItems
in interface Container
setItems
in class ContainerBase
items
- public List<Group> getDialogs()
public void setDialogs(List<Group> dialogs)
dialogs
- List of dialog groupspublic Link getViewMenuLink()
public void setViewMenuLink(Link viewMenuLink)
viewMenuLink
- public String getViewMenuGroupName()
public void setViewMenuGroupName(String viewMenuGroupName)
viewMenuGroupName
- public String getViewStatus()
The view lifecycle begins with the CREATED status. In this status a new instance of the view has been retrieved from the dictionary, but no further processing has been done. After the initialize phase has been run the status changes to INITIALIZED. After the model has been applied and the view is ready for render the status changes to FINAL
UifConstants.ViewStatus
public void setViewStatus(String viewStatus)
viewStatus
- public boolean isInitialized()
public boolean isFinal()
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)
breadcrumbOptions
- public BreadcrumbItem getBreadcrumbItem()
public void setBreadcrumbItem(BreadcrumbItem breadcrumbItem)
breadcrumbItem
- 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)
parentLocation
- public List<BreadcrumbItem> getPathBasedBreadcrumbs()
public void setPathBasedBreadcrumbs(List<BreadcrumbItem> pathBasedBreadcrumbs)
pathBasedBreadcrumbs
- public Growls getGrowls()
public void setRefreshBlockUI(BlockUI refreshBlockUI)
refreshBlockUI
- public BlockUI getRefreshBlockUI()
public void setNavigationBlockUI(BlockUI navigationBlockUI)
navigationBlockUI
- public BlockUI getNavigationBlockUI()
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)
public void setTranslateCodesOnReadOnlyDisplay(boolean translateCodesOnReadOnlyDisplay)
KualiCode
translateCodesOnReadOnlyDisplay
- indicates whether KualiCode
's name should be included.public boolean isTranslateCodesOnReadOnlyDisplay()
KualiCode
's name as additional display valuepublic 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)
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)
disableNativeAutocomplete
- 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)
disableBrowserCache
- public String getPreLoadScript()
Many used to set server variables client side
public void setPreLoadScript(String preLoadScript)
preLoadScript
- public ViewTheme getTheme()
public void setTheme(ViewTheme theme)
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)
stateMapping
- protected <T> void copyProperties(T component)
ComponentBase
copyProperties
in class ContainerBase
component
- base beanComponentBase.copy()
public void completeValidation(ValidationTrace tracer)
Component
completeValidation
in interface Component
completeValidation
in class ContainerBase
tracer
- Record of component's locationComponent.completeValidation(org.kuali.rice.krad.datadictionary.validator.ValidationTrace)
Copyright © 2005–2016 The Kuali Foundation. All rights reserved.