com.ibm.xsp.component
Class UIInclude

java.lang.Object
  javax.faces.component.UIComponent
      javax.faces.component.UIComponentBase
          javax.faces.component.UIPanel
              com.ibm.xsp.component.UIDataPanelBase
                  com.ibm.xsp.component.UIPanelEx
                      com.ibm.xsp.component.UIInclude

All Implemented Interfaces:

FacesComponent, FacesDataProvider, FacesPageIncluder, FacesPageProvider, FacesDojoComponent, ThemeControl, javax.faces.component.NamingContainer, javax.faces.component.StateHolder

public class UIInclude
extends UIPanelEx
implements javax.faces.component.NamingContainer, FacesComponent, FacesPageProvider, FacesPageIncluder

XPages Container Controls - Include Page. The xp:include tag in the XPage source.

Nested Class Summary

Nested classes/interfaces inherited from class javax.faces.component.UIComponentBase

javax.faces.component.UIComponentBase.AggregatedIterator, javax.faces.component.UIComponentBase.UnmodifiableIterator

Nested classes/interfaces inherited from class javax.faces.component.UIComponent

javax.faces.component.UIComponent.StateMap, javax.faces.component.UIComponent.StateMapEntry

Field Summary

static java.lang.String	COMPONENT_FAMILY
static java.lang.String	COMPONENT_TYPE

Fields inherited from class com.ibm.xsp.component.UIPanelEx

RENDERER_TYPE

Fields inherited from class javax.faces.component.UIComponentBase

EMPTY_ITERATOR

Fields inherited from class javax.faces.component.UIComponent

_xspStateId

Fields inherited from interface javax.faces.component.NamingContainer

SEPARATOR_CHAR

Fields inherited from interface com.ibm.xsp.component.FacesDataProvider

DATA, DATA_CONTEXTS

Constructor Summary

UIInclude()
Default constructor for an XFInclude

Method Summary

void	addNavigationRule(NavigationRule rule) Add a NavigationRule instance to the set associated with the view.
void	addResource(Resource resource) Add a Resource instance to the set associated with this component.
void	buildContents(javax.faces.context.FacesContext context, FacesComponentBuilder builder) Build the component children and facets, the default implementation is usually: builder.buildAll(context, this, true); // includeFacets=true
void	buildPageContents(javax.faces.context.FacesContext context, FacesComponentBuilder builder)
void	decode(javax.faces.context.FacesContext context)
javax.faces.el.MethodBinding	getAfterPageLoad()
javax.faces.el.MethodBinding	getBeforePageLoad()
java.lang.String	getComponentId()
java.lang.String	getFamily()
java.lang.String	getPageName()
java.lang.String	getStyleKitFamily() The styleKitFamily is basically the default themeId, to use if the "themeId" property is not set on this control instance in the XPage source.
void	initAfterContents(javax.faces.context.FacesContext context) Perform component initialization after it's children and facets are added.
void	initAfterPageContents(javax.faces.context.FacesContext context)
void	initBeforeContents(javax.faces.context.FacesContext context) Perform component initialization before its children and facets are added.
void	initBeforePageContents(javax.faces.context.FacesContext context) Invoked on the including control when it has been initialized with the page root contents (if importing the root control), but the contents (children & facets) from the page have not yet been built.
void	restoreState(javax.faces.context.FacesContext context, java.lang.Object state)
java.lang.Object	saveState(javax.faces.context.FacesContext context)
void	setAcl(ACL acl) Set the ACL
void	setAfterPageLoad(javax.faces.el.MethodBinding afterPageLoad) Triggered after a page is loaded, or where it is set on an included custom control, triggered after the custom control is included.
void	setAfterRenderResponse(javax.faces.el.MethodBinding afterRenderResponse) A server-only event triggered after the render response phase of the JSF lifecycle.
void	setAfterRestoreView(javax.faces.el.MethodBinding afterRestoreView) A server-only event triggered after the restore view phase of the JSF lifecycle.
void	setBeforePageLoad(javax.faces.el.MethodBinding beforePageLoad) Triggered before a page is loaded, or where it is set on an included custom control, triggered before the custom control is included.
void	setBeforeRenderResponse(javax.faces.el.MethodBinding beforeRenderResponse) A server-only event triggered before the render response phase of the JSF lifecycle.
void	setComponentId(java.lang.String tagid)
void	setDojoForm(boolean dojoForm)
void	setDojoParseOnLoad(boolean dojoParseOnLoad) Flag to indicate whether or not a dojo theme is being used.
void	setDojoTheme(boolean dojoTheme) Flag to indicate whether or not a dojo theme is being used.
void	setEnableModifiedFlag(boolean enableModifiedFlag) Flag to indicate whether or not the modified flag is being used.
void	setModifiedControl(java.lang.String modifiedControl)
void	setModifiedMessage(java.lang.String modifiedMessage)
void	setOnClientLoad(java.lang.String onClientLoad) Sets the client JavaScript that was set for the onClientLoad event in the All Properties tab of the XPages Editor's Properties view, which is unusual because events are normally handled in the Events view.
void	setPageBaseUrl(ViewRootBaseUrl pageBaseUrl)
void	setPageDriver(FacesPageDriver pageDriver) Deprecated. On 8.5.0 servers, the compiled .java XPage must invoke this method with the current page driver. On 8.5.2 or later servers, it is not required, as the control looks to the current context for the pageDriver. However, the Designer 8.5.2 install still generates the call to this set method, so that include controls from an 8.5.2 Designer will run on an 8.5.0 server.
void	setPageManifest(java.lang.String pageManifest)
void	setPageName(java.lang.String pagename)

Methods inherited from class com.ibm.xsp.component.UIPanelEx

_xspCleanTransientData, addDojoAttribute, getDir, getDojoAttributes, getDojoType, getOnClientLoad, getOuterStyleClass, getRole, getStyle, getStyleClass, getTitle, setDir, setDojoAttributes, setDojoType, setOuterStyleClass, setRole, setStyle, setStyleClass, setTitle

Methods inherited from class com.ibm.xsp.component.UIDataPanelBase

addData, addDataContext, afterEncoding, beforeEncoding, broadcast, encodeBegin, encodeEnd, getAcl, getData, getDataContexts, hasUserAccess, invokeOnComponent, isAllowCreateViewPublish, isReadonly, isRendered, processDecodes, processUpdates, processValidators, publishControlData, queueEvent, revokeControlData, setReadonly, visitTree

Methods inherited from class javax.faces.component.UIComponentBase

_xspGetReadOnlyObj, _xspGetRendererData, _xspRemoveReadOnlyObj, _xspRemoveRendererData, _xspSetIdUnchecked, _xspSetReadOnlyObj, _xspSetRendererData, addFacesListener, encodeChildren, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, isTransient, processRestoreState, processSaveState, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding

Methods inherited from class javax.faces.component.UIComponent

_xspGetStateId, _xspGetStateMap, _xspRestoreAttribute, _xspRestoreState, _xspSaveState, isVisitable, markInitialState, setControlState

Methods inherited from class java.lang.Object

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

Field Detail

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE

See Also:

Constant Field Values

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY

See Also:

Constant Field Values

Constructor Detail

UIInclude

public UIInclude()

Default constructor for an XFInclude

Method Detail

getStyleKitFamily

public java.lang.String getStyleKitFamily()

Description copied from interface: ThemeControl

The styleKitFamily is basically the default themeId, to use if the "themeId" property is not set on this control instance in the XPage source. For example, "InputField.EditBox" is used for most Edit Box controls. See Domino/xsp/nsf/themes/webstandard.theme for more examples.

The implementation may return different values depending on the configuration of the current control, for example the Button control returns a different value and looks different when it is configured as a cancel button.

Specified by:

getStyleKitFamily in interface ThemeControl

Overrides:

getStyleKitFamily in class UIPanelEx

Returns:

a non-null themeId corresponding to the configuration for this type of control in a theme file.

decode

public void decode(javax.faces.context.FacesContext context)

Overrides:

decode in class javax.faces.component.UIComponentBase

getFamily

public java.lang.String getFamily()

Overrides:

getFamily in class javax.faces.component.UIPanel

getPageName

public java.lang.String getPageName()

Returns:

Returns the pagename.

setPageName

public void setPageName(java.lang.String pagename)

Parameters:

pagename - The pagename to set.

getComponentId

public java.lang.String getComponentId()

Returns:

Returns the tagid.

setComponentId

public void setComponentId(java.lang.String tagid)

Parameters:

tagid - The tagid to set.

addResource

public void addResource(Resource resource)

Add a Resource instance to the set associated with this component.

Specified by:

addResource in interface FacesPageProvider

Parameters:

rule -

setOnClientLoad

public void setOnClientLoad(java.lang.String onClientLoad)

Description copied from interface: FacesPageProvider

Sets the client JavaScript that was set for the onClientLoad event in the All Properties tab of the XPages Editor's Properties view, which is unusual because events are normally handled in the Events view.

Specified by:

setOnClientLoad in interface FacesPageProvider

Overrides:

setOnClientLoad in class UIPanelEx

Parameters:

onClientLoad - client JavaScript to execute when the page loads in the client or browser

setAcl

public void setAcl(ACL acl)

Description copied from class: UIDataPanelBase

Set the ACL

Specified by:

setAcl in interface FacesPageProvider

Overrides:

setAcl in class UIDataPanelBase

addNavigationRule

public void addNavigationRule(NavigationRule rule)

Add a NavigationRule instance to the set associated with the view.

Specified by:

addNavigationRule in interface FacesPageProvider

Parameters:

rule -

setAfterRenderResponse

public void setAfterRenderResponse(javax.faces.el.MethodBinding afterRenderResponse)

Description copied from interface: FacesPageProvider

A server-only event triggered after the render response phase of the JSF lifecycle. Since it does not occur during processing of the control tree for the phase, the event will not have access to data published by controls in the XPage.

Specified by:

setAfterRenderResponse in interface FacesPageProvider

Parameters:

afterRenderResponse - The afterRenderResponse to set.

setAfterRestoreView

public void setAfterRestoreView(javax.faces.el.MethodBinding afterRestoreView)

Description copied from interface: FacesPageProvider

A server-only event triggered after the restore view phase of the JSF lifecycle. Since it does not occur during processing of the control tree for the phase, the event will not have access to data published by controls in the XPage. There is no "before restore view" phase because these event actions are saved in the view control tree, so the action would not be available before the control tree is restored.

Specified by:

setAfterRestoreView in interface FacesPageProvider

Parameters:

afterRestoreView - The afterRestoreView to set.

setBeforeRenderResponse

public void setBeforeRenderResponse(javax.faces.el.MethodBinding beforeRenderResponse)

Description copied from interface: FacesPageProvider

A server-only event triggered before the render response phase of the JSF lifecycle. Since it does not occur during processing of the control tree for the phase, the event will not have access to data published by controls in the XPage.

Specified by:

setBeforeRenderResponse in interface FacesPageProvider

Parameters:

beforeRenderResponse - The beforeRenderResponse to set.

getAfterPageLoad

public javax.faces.el.MethodBinding getAfterPageLoad()

Returns:

the afterPageLoad

setAfterPageLoad

public void setAfterPageLoad(javax.faces.el.MethodBinding afterPageLoad)

Description copied from interface: FacesPageProvider

Triggered after a page is loaded, or where it is set on an included custom control, triggered after the custom control is included.

Specified by:

setAfterPageLoad in interface FacesPageProvider

Parameters:

afterPageLoad - the afterPageLoad to set

getBeforePageLoad

public javax.faces.el.MethodBinding getBeforePageLoad()

Returns:

the beforePageLoad

setBeforePageLoad

public void setBeforePageLoad(javax.faces.el.MethodBinding beforePageLoad)

Description copied from interface: FacesPageProvider

Triggered before a page is loaded, or where it is set on an included custom control, triggered before the custom control is included.

Specified by:

setBeforePageLoad in interface FacesPageProvider

Parameters:

beforePageLoad - the beforePageLoad to set

setDojoTheme

public void setDojoTheme(boolean dojoTheme)

Flag to indicate whether or not a dojo theme is being used.

Specified by:

setDojoTheme in interface FacesPageProvider

Parameters:

dojoTheme - true is the dojo theme should be used

setDojoParseOnLoad

public void setDojoParseOnLoad(boolean dojoParseOnLoad)

Flag to indicate whether or not a dojo theme is being used.

Specified by:

setDojoParseOnLoad in interface FacesPageProvider

Parameters:

dojoParseOnLoad - true is the dojo parser should be triggered on load

setEnableModifiedFlag

public void setEnableModifiedFlag(boolean enableModifiedFlag)

Flag to indicate whether or not the modified flag is being used.

Specified by:

setEnableModifiedFlag in interface FacesPageProvider

Parameters:

enableModifiedFlag - true if the modified flag should be used.

setModifiedMessage

public void setModifiedMessage(java.lang.String modifiedMessage)

Specified by:

setModifiedMessage in interface FacesPageProvider

setModifiedControl

public void setModifiedControl(java.lang.String modifiedControl)

Specified by:

setModifiedControl in interface FacesPageProvider

setDojoForm

public void setDojoForm(boolean dojoForm)

Specified by:

setDojoForm in interface FacesPageProvider

setPageBaseUrl

public void setPageBaseUrl(ViewRootBaseUrl pageBaseUrl)

Specified by:

setPageBaseUrl in interface FacesPageProvider

setPageManifest

public void setPageManifest(java.lang.String pageManifest)

Specified by:

setPageManifest in interface FacesPageProvider

buildContents

public void buildContents(javax.faces.context.FacesContext context,
                          FacesComponentBuilder builder)
                   throws javax.faces.FacesException

Description copied from interface: FacesComponent

Build the component children and facets, the default implementation is usually:
builder.buildAll(context, this, true); // includeFacets=true

Specified by:

buildContents in interface FacesComponent

Overrides:

buildContents in class UIDataPanelBase

Throws:

javax.faces.FacesException

initBeforePageContents

public void initBeforePageContents(javax.faces.context.FacesContext context)
                            throws javax.faces.FacesException

Description copied from interface: FacesPageIncluder

Invoked on the including control when it has been initialized with the page root contents (if importing the root control), but the contents (children & facets) from the page have not yet been built.

Specified by:

initBeforePageContents in interface FacesPageIncluder

Throws:

javax.faces.FacesException

buildPageContents

public void buildPageContents(javax.faces.context.FacesContext context,
                              FacesComponentBuilder builder)
                       throws javax.faces.FacesException

Specified by:

buildPageContents in interface FacesPageIncluder

Throws:

javax.faces.FacesException

initAfterPageContents

public void initAfterPageContents(javax.faces.context.FacesContext context)
                           throws javax.faces.FacesException

Specified by:

initAfterPageContents in interface FacesPageIncluder

Throws:

javax.faces.FacesException

setPageDriver

public void setPageDriver(FacesPageDriver pageDriver)

Deprecated. On 8.5.0 servers, the compiled .java XPage must invoke this method with the current page driver. On 8.5.2 or later servers, it is not required, as the control looks to the current context for the pageDriver. However, the Designer 8.5.2 install still generates the call to this set method, so that include controls from an 8.5.2 Designer will run on an 8.5.0 server.

Parameters:

pageDriver - the current application's pageDriver

initBeforeContents

public void initBeforeContents(javax.faces.context.FacesContext context)
                        throws javax.faces.FacesException

Description copied from interface: FacesComponent

Perform component initialization before its children and facets are added.

Specified by:

initBeforeContents in interface FacesComponent

Overrides:

initBeforeContents in class UIDataPanelBase

Throws:

javax.faces.FacesException

initAfterContents

public void initAfterContents(javax.faces.context.FacesContext context)
                       throws javax.faces.FacesException

Description copied from interface: FacesComponent

Perform component initialization after it's children and facets are added.

Specified by:

initAfterContents in interface FacesComponent

Overrides:

initAfterContents in class UIDataPanelBase

Throws:

javax.faces.FacesException

saveState

public java.lang.Object saveState(javax.faces.context.FacesContext context)

Specified by:

saveState in interface javax.faces.component.StateHolder

Overrides:

saveState in class UIPanelEx

restoreState

public void restoreState(javax.faces.context.FacesContext context,
                         java.lang.Object state)

Specified by:

restoreState in interface javax.faces.component.StateHolder

Overrides:

restoreState in class UIPanelEx