com.ibm.xsp.component
Class UIInclude

java.lang.Object
  extended by javax.faces.component.UIComponent
      extended by javax.faces.component.UIComponentBase
          extended by javax.faces.component.UIPanel
              extended by com.ibm.xsp.component.UIDataPanelBase
                  extended by com.ibm.xsp.component.UIPanelEx
                      extended by 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