java.lang.Object
- javax.faces.component.UIComponent
- - javax.faces.component.UIComponentBase
  - - javax.faces.component.UIViewRoot

All Implemented Interfaces:

EventListener, PartialStateHolder, StateHolder, TransientStateHolder, UniqueIdVendor, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder
```
public class UIViewRoot
extends UIComponentBase
implements UniqueIdVendor
```
UIViewRoot is the UIComponent that represents the root of the UIComponent tree. This component renders markup as the response to Ajax requests. It also serves as the root of the component tree, and as a place to hang per-view PhaseListeners.

For each of the following lifecycle phase methods:
Take the following action regarding PhaseListeners.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`COMPONENT_FAMILY` The standard component family for this component.
`static String`	`COMPONENT_TYPE` The standard component type for this component.
`static String`	`METADATA_FACET_NAME`
`static String`	`UNIQUE_ID_PREFIX` The prefix that will be used for identifiers generated by the `createUniqueId()` method.
`static String`	`VIEW_PARAMETERS_KEY` The key in the value set of the view metadata BeanDescriptor, the value of which is a `List<UIViewParameter.Reference>`.

Retour à la première page de API Java Table des matières Haut

Fields inherited from class javax.faces.component.UIComponent
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY

Constructor Summary

Constructors
Constructor and Description

UIViewRoot()
Create a new UIViewRoot instance with default property values.

Retour à la première page de API Java Table des matières Haut

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addComponentResource(FacesContext context, UIComponent componentResource)` Add argument `component`, which is assumed to represent a resource instance, as a resource to this view.
`void`	`addComponentResource(FacesContext context, UIComponent componentResource, String target)` Add argument `component`, which is assumed to represent a resource instance, as a resource to this view.
`void`	`addPhaseListener(PhaseListener newPhaseListener)` Add the argument `newPhaseListener` to the list of `PhaseListener`s on this `UIViewRoot`.
`void`	`broadcastEvents(FacesContext context, PhaseId phaseId)` Broadcast any events that have been queued.
`String`	`createUniqueId()` Generate an identifier for a component.
`String`	`createUniqueId(FacesContext context, String seed)` Generate an identifier for a component.
`void`	`encodeBegin(FacesContext context)` Override the default `UIComponentBase.encodeBegin(javax.faces.context.FacesContext)` behavior.
`void`	`encodeChildren(FacesContext context)` If `PartialViewContext.isAjaxRequest()` returns `true`, perform partial rendering by calling `PartialViewContext.processPartial(javax.faces.event.PhaseId)` with `PhaseId.RENDER_RESPONSE`.
`void`	`encodeEnd(FacesContext context)` If `getAfterPhaseListener()` returns non-`null`, invoke it, passing a `PhaseEvent` for the `PhaseId.RENDER_RESPONSE` phase.
`MethodExpression`	`getAfterPhaseListener()` Return the `MethodExpression` that will be invoked after this view is rendered.
`MethodExpression`	`getBeforePhaseListener()` Return the `MethodExpression` that will be invoked before this view is rendered.
`List<UIComponent>`	`getComponentResources(FacesContext context, String target)` Return an unmodifiable `List` of `UIComponent`s for the provided `target` agrument.
`String`	`getFamily()` Return the identifier of the component family to which this component belongs.
`Locale`	`getLocale()` Return the `Locale` to be used in localizing the response being created for this view.
`List<PhaseListener>`	`getPhaseListeners()` Return an unmodifiable list of the `PhaseListener` instances attached to this `UIViewRoot` instance.
`String`	`getRenderKitId()` Return the render kit identifier of the `RenderKit` associated with this view.
`boolean`	`getRendersChildren()` Call `UIComponentBase.getRendersChildren()` If `PartialViewContext.isAjaxRequest()` returns `true` this method must return `true`.
`String`	`getViewId()` Return the view identifier for this view.
`List<SystemEventListener>`	`getViewListenersForEventClass(Class<? extends SystemEvent> systemEvent)` Return the `SystemEventListener` instances registered on this `UIComponent` instance that are interested in events of type `eventClass`.
`Map<String,Object>`	`getViewMap()` This implementation simply calls through to `getViewMap(boolean)`, passing `true` as the argument, and returns the result.
`Map<String,Object>`	`getViewMap(boolean create)` Returns a `Map` that acts as the interface to the data store that is the "view scope", or, if this instance does not have such a `Map` and the `create` argument is `true`, creates one and returns it.
`boolean`	`isInView()` Override superclass method to always return `true` because a `UIViewRoot` is defined to always be in a view.
`void`	`processApplication(FacesContext context)` Broadcast any events that have been queued for the Invoke Application phase of the request processing lifecycle and to clear out any events for later phases if the event processing for this phase caused `FacesContext.renderResponse()` or `FacesContext.responseComplete()` to be called.
`void`	`processDecodes(FacesContext context)`
`void`	`processRestoreState(FacesContext context, Object state)` The default implementation must call `UIComponentBase.processRestoreState(javax.faces.context.FacesContext, java.lang.Object)` from within a `try` block.
`void`	`processUpdates(FacesContext context)`
`void`	`processValidators(FacesContext context)`
`void`	`queueEvent(FacesEvent event)` Override the default `UIComponentBase.queueEvent(javax.faces.event.FacesEvent)` behavior to accumulate the queued events for later broadcasting.
`void`	`removeComponentResource(FacesContext context, UIComponent componentResource)` Remove argument `component`, which is assumed to represent a resource instance, as a resource to this view.
`void`	`removeComponentResource(FacesContext context, UIComponent componentResource, String target)` Remove argument `component`, which is assumed to represent a resource instance, as a resource to this view.
`void`	`removePhaseListener(PhaseListener toRemove)` If the argument `toRemove` is in the list of `PhaseListener`s for this instance, it must be removed.
`void`	`resetValues(FacesContext context, Collection<String> clientIds)` Visit the clientIds and, if the component is an instance of `EditableValueHolder`, call its `EditableValueHolder.resetValue()` method.
`void`	`restoreState(FacesContext context, Object state)` Perform any processing required to restore the state from the entries in the state Object.
`void`	`restoreViewScopeState(FacesContext context, Object state)` Restore ViewScope state.
`Object`	`saveState(FacesContext context)` Gets the state of the instance as a `Serializable` Object.
`void`	`setAfterPhaseListener(MethodExpression newAfterPhase)` Allow an arbitrary method to be called for the "afterPhase" event as the UIViewRoot runs through its lifecycle.
`void`	`setBeforePhaseListener(MethodExpression newBeforePhase)` Allow an arbitrary method to be called for the "beforePhase" event as the UIViewRoot runs through its lifecycle.
`void`	`setInView(boolean isInView)` Overridden to take no action.
`void`	`setLocale(Locale locale)` Set the `Locale` to be used in localizing the response being created for this view.
`void`	`setRenderKitId(String renderKitId)` Set the render kit identifier of the `RenderKit` associated with this view.
`void`	`setViewId(String viewId)` Set the view identifier for this view.
`void`	`subscribeToViewEvent(Class<? extends SystemEvent> systemEvent, SystemEventListener listener)` Install the listener instance referenced by argument `listener` into the `UIViewRoot` as a listener for events of type `systemEventClass`.
`void`	`unsubscribeFromViewEvent(Class<? extends SystemEvent> systemEvent, SystemEventListener listener)` Remove the listener instance referenced by argument `listener` from the `UIViewRoot` as a listener for events of type `systemEventClass`.

Retour à la première page de API Java Table des matières Haut

Methods inherited from class javax.faces.component.UIComponentBase
addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getValueBinding, invokeOnComponent, isRendered, isTransient, markInitialState, processSaveState, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class javax.faces.component.UIComponent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setValueExpression, visitTree

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - METADATA_FACET_NAME
```
public static final String METADATA_FACET_NAME
```
    See Also:
    
    Constant Field Values
  - VIEW_PARAMETERS_KEY
```
public static final String VIEW_PARAMETERS_KEY
```
    The key in the value set of the view metadata BeanDescriptor, the value of which is a List<UIViewParameter.Reference>.
    
    Since:
    
    2.0
    
    See Also:
    
    Constant Field Values
  - COMPONENT_TYPE
```
public static final String COMPONENT_TYPE
```
    The standard component type for this component.
    
    See Also:
    
    Constant Field Values
  - COMPONENT_FAMILY
```
public static final String COMPONENT_FAMILY
```
    The standard component family for this component.
    
    See Also:
    
    Constant Field Values
  - UNIQUE_ID_PREFIX
```
public static final String UNIQUE_ID_PREFIX
```
    The prefix that will be used for identifiers generated by the createUniqueId() method.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - UIViewRoot
```
public UIViewRoot()
```
    Create a new UIViewRoot instance with default property values.
- Method Detail
  - isInView
```
public boolean isInView()
```
    Override superclass method to always return true because a UIViewRoot is defined to always be in a view.
    
    Overrides:
    
    isInView in class UIComponent
    
    Since:
    
    2.0
  - setInView
```
public void setInView(boolean isInView)
```
    Overridden to take no action.
    
    Overrides:
    
    setInView in class UIComponent
    
    Parameters:
    
    isInView -
    
    Since:
    
    2.0
  - getFamily
```
public String getFamily()
```
    Description copied from class: UIComponent
    
    Return the identifier of the component family to which this component belongs. This identifier, in conjunction with the value of the rendererType property, may be used to select the appropriate Renderer for this component instance.
    
    Specified by:
    
    getFamily in class UIComponent
    
    See Also:
    
    UIComponent.getFamily()
  - getRenderKitId
```
public String getRenderKitId()
```
    Return the render kit identifier of the RenderKit associated with this view. Unless explicitly set, as in ViewHandler.createView(javax.faces.context.FacesContext, java.lang.String), the returned value will be null.
  - setRenderKitId
```
public void setRenderKitId(String renderKitId)
```
    Set the render kit identifier of the RenderKit associated with this view. This method may be called at any time between the end of Apply Request Values phase of the request processing lifecycle (i.e. when events are being broadcast) and the beginning of the Render Response phase.
    
    Parameters:
    
    renderKitId - The new RenderKit identifier, or null to disassociate this view with any specific RenderKit instance
  - getViewId
```
public String getViewId()
```
    Return the view identifier for this view.
  - setViewId
```
public void setViewId(String viewId)
```
    Set the view identifier for this view.
    
    Parameters:
    
    viewId - The new view identifier
  - getBeforePhaseListener
```
public MethodExpression getBeforePhaseListener()
```
    Return the MethodExpression that will be invoked before this view is rendered.
    
    Returns:
    
    the MethodExpression that will be invoked before this view is rendered.
    
    Since:
    
    1.2
  - setBeforePhaseListener
```
public void setBeforePhaseListener(MethodExpression newBeforePhase)
```
    Allow an arbitrary method to be called for the "beforePhase" event as the UIViewRoot runs through its lifecycle. This method will be called for all phases except PhaseId.RESTORE_VIEW. Unlike a true PhaseListener, this approach doesn't allow for only receiving PhaseEvents for a given phase.
    
    The method must conform to the signature of PhaseListener.beforePhase(javax.faces.event.PhaseEvent).
    
    Parameters:
    
    newBeforePhase - the MethodExpression that will be invoked before this view is rendered.
    
    Since:
    
    1.2
  - getAfterPhaseListener
```
public MethodExpression getAfterPhaseListener()
```
    Return the MethodExpression that will be invoked after this view is rendered.
    
    Returns:
    
    the MethodExpression that will be invoked after this view is rendered.
    
    Since:
    
    1.2
  - setAfterPhaseListener
```
public void setAfterPhaseListener(MethodExpression newAfterPhase)
```
    Allow an arbitrary method to be called for the "afterPhase" event as the UIViewRoot runs through its lifecycle. This method will be called for all phases including PhaseId.RESTORE_VIEW. Unlike a true PhaseListener, this approach doesn't allow for only receiving PhaseEvents for a given phase.
    
    The method must conform to the signature of PhaseListener.afterPhase(javax.faces.event.PhaseEvent).
    
    Parameters:
    
    newAfterPhase - the MethodExpression that will be invoked after this view is rendered.
    
    Since:
    
    1.2
  - removePhaseListener
```
public void removePhaseListener(PhaseListener toRemove)
```
    If the argument toRemove is in the list of PhaseListeners for this instance, it must be removed.
    
    Parameters:
    
    toRemove - the PhaseListener to remove.
    
    Since:
    
    1.2
  - addPhaseListener
```
public void addPhaseListener(PhaseListener newPhaseListener)
```
    Add the argument newPhaseListener to the list of PhaseListeners on this UIViewRoot.
    
    Parameters:
    
    newPhaseListener - the PhaseListener to add
    
    Since:
    
    1.2
  - getPhaseListeners
```
public List<PhaseListener> getPhaseListeners()
```
    Return an unmodifiable list of the PhaseListener instances attached to this UIViewRoot instance.
    
    Since:
    
    2.0
  - addComponentResource
```
public void addComponentResource(FacesContext context,
                                 UIComponent componentResource)
```
    Add argument component, which is assumed to represent a resource instance, as a resource to this view. A resource instance is rendered by a resource Renderer, as described in the Standard HTML RenderKit. The default implementation must call through to addComponentResource(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.String).
    
    Parameters:
    
    context - FacesContext for the current request
    
    componentResource - The UIComponent representing a Resource instance
    
    Since:
    
    2.0
  - addComponentResource
```
public void addComponentResource(FacesContext context,
                                 UIComponent componentResource,
                                 String target)
```
    Add argument component, which is assumed to represent a resource instance, as a resource to this view. A resource instance is rendered by a resource Renderer, as described in the Standard HTML RenderKit.
    The component must be added using the following algorithm:
    
    If the target argument is null, look for a target attribute on the component. If there is no target attribute, set target to be the default value head
    
    Call getComponentResources(javax.faces.context.FacesContext, java.lang.String) to obtain the child list for the given target.
    
    If the component ID of componentResource matches the the ID of a resource that has allready been added, remove the old resource.
    
    Add the component resource to the list.
    Parameters:
    
    context - FacesContext for the current request
    
    componentResource - The UIComponent representing a Resource instance
    
    target - The name of the facet for which the UIComponent will be added
    
    Since:
    
    2.0
  - getComponentResources
```
public List<UIComponent> getComponentResources(FacesContext context,
                                               String target)
```
    Return an unmodifiable List of UIComponents for the provided target agrument. Each component in the List is assumed to represent a resource instance.
    The default implementation must use an algorithm equivalent to the the following.
    
    Locate the facet for the component by calling getFacet() using target as the argument.
    
    If the facet is not found, create the facet by calling context.getApplication().createComponent(). The argument to this method must refer to a component that extends UIPanel and overrides the encodeAll() method to take no action. This is necessary to prevent component resources from being inadvertently rendered.
    
    Set the id of the facet to be a string created by prepending the literal string “javax_faces_location_” (without the quotes) to the value of the target argument
    
    Add the facet to the facets Map using target as the key
    
    return the children of the facet
    Parameters:
    
    target - The name of the facet for which the components will be returned.
    
    Returns:
    
    A List of UIComponent children of the facet with the name target. If no children are found for the facet, return Collections.emptyList().
    
    Throws:
    
    NullPointerException - if target or context is null
    
    Since:
    
    2.0
  - removeComponentResource
```
public void removeComponentResource(FacesContext context,
                                    UIComponent componentResource)
```
    Remove argument component, which is assumed to represent a resource instance, as a resource to this view.
    
    Parameters:
    
    context - FacesContext for the current request
    
    componentResource - The UIComponent representing a Resource instance
    
    Since:
    
    2.0
  - removeComponentResource
```
public void removeComponentResource(FacesContext context,
                                    UIComponent componentResource,
                                    String target)
```
    Remove argument component, which is assumed to represent a resource instance, as a resource to this view. A resource instance is rendered by a resource Renderer, as described in the Standard HTML RenderKit.
    The component must be removed using the following algorithm:
    
    If the target argument is null, look for a target attribute on the component.
    If there is no target attribute, set target to be the default value head
    
    Call getComponentResources(javax.faces.context.FacesContext, java.lang.String) to obtain the child list for the given target.
    
    Remove the component resource from the child list.
    Parameters:
    
    context - FacesContext for the current request
    
    componentResource - The UIComponent representing a Resource instance
    
    target - The name of the facet for which the UIComponent will be added
    
    Since:
    
    2.0
  - queueEvent
```
public void queueEvent(FacesEvent event)
```
    Override the default UIComponentBase.queueEvent(javax.faces.event.FacesEvent) behavior to accumulate the queued events for later broadcasting.
    
    Overrides:
    
    queueEvent in class UIComponentBase
    
    Parameters:
    
    event - FacesEvent to be queued
    
    Throws:
    
    IllegalStateException - if this component is not a descendant of a UIViewRoot
    
    NullPointerException - if event is null
  - broadcastEvents
```
public void broadcastEvents(FacesContext context,
                            PhaseId phaseId)
```
    Broadcast any events that have been queued. First broadcast events that have been queued for PhaseId.ANY_PHASE. Then broadcast ane events that have been queued for the current phase. In both cases, UIComponent.pushComponentToEL(javax.faces.context.FacesContext, javax.faces.component.UIComponent) must be called before the event is broadcast, and UIComponent.popComponentFromEL(javax.faces.context.FacesContext) must be called after the return from the broadcast, even in the case of an exception.
    
    Parameters:
    
    context - FacesContext for the current request
    
    phaseId - PhaseId of the current phase
    
    Since:
    
    2.0
  - processRestoreState
```
public void processRestoreState(FacesContext context,
                                Object state)
```
    The default implementation must call UIComponentBase.processRestoreState(javax.faces.context.FacesContext, java.lang.Object) from within a try block. The try block must have a finally block that ensures that no FacesEvents remain in the event queue.
    
    Overrides:
    
    processRestoreState in class UIComponentBase
    
    Parameters:
    
    context - the FacesContext for this requets
    
    state - the opaque state object obtained from the StateManager
  - processDecodes
```
public void processDecodes(FacesContext context)
```
    Perform partial processing by calling PartialViewContext.processPartial(javax.faces.event.PhaseId) with PhaseId.APPLY_REQUEST_VALUES if:
    
    PartialViewContext.isPartialRequest() returns true and we don't have a request to process all components in the view (PartialViewContext.isExecuteAll() returns false)
    
    Perform full processing by calling UIComponentBase.processDecodes(javax.faces.context.FacesContext) if one of the following conditions are met:
    
    PartialViewContext.isPartialRequest() returns true and we have a request to process all components in the view (PartialViewContext.isExecuteAll() returns true)
    
    PartialViewContext.isPartialRequest() returns false
    Override the default UIComponentBase.processDecodes(javax.faces.context.FacesContext) behavior to broadcast any queued events after the default processing or partial processing has been completed and to clear out any events for later phases if the event processing for this phase caused FacesContext.renderResponse() or FacesContext.responseComplete() to be called.
    Overrides:
    
    processDecodes in class UIComponentBase
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    Throws:
    
    NullPointerException - if context is null
  - resetValues
```
public void resetValues(FacesContext context,
                        Collection<String> clientIds)
```
    Visit the clientIds and, if the component is an instance of EditableValueHolder, call its EditableValueHolder.resetValue() method. Use UIComponent.visitTree(javax.faces.component.visit.VisitContext, javax.faces.component.visit.VisitCallback) to do the visiting.
    
    Parameters:
    
    context - the FacesContext for the request we are processing.
    
    clientIds - The client ids to be visited, on which the described action will be taken.
    
    Since:
    
    2.2
  - encodeBegin
```
public void encodeBegin(FacesContext context)
                 throws IOException
```
    Override the default UIComponentBase.encodeBegin(javax.faces.context.FacesContext) behavior. If getBeforePhaseListener() returns non-null, invoke it, passing a PhaseEvent for the PhaseId.RENDER_RESPONSE phase. If the internal list populated by calls to addPhaseListener(javax.faces.event.PhaseListener) is non-empty, any listeners in that list must have their PhaseListener.beforePhase(javax.faces.event.PhaseEvent) method called, passing the PhaseEvent. Any errors that occur during invocation of any of the the beforePhase listeners must be logged and swallowed. After listeners are invoked call superclass processing.
    
    Overrides:
    
    encodeBegin in class UIComponentBase
    
    Parameters:
    
    context - FacesContext for the response we are creating
    
    Throws:
    
    IOException - if an input/output error occurs while rendering
  - encodeChildren
```
public void encodeChildren(FacesContext context)
                    throws IOException
```
    If PartialViewContext.isAjaxRequest() returns true, perform partial rendering by calling PartialViewContext.processPartial(javax.faces.event.PhaseId) with PhaseId.RENDER_RESPONSE. If PartialViewContext.isAjaxRequest() returns false, delegate to the parent UIComponentBase.encodeChildren(javax.faces.context.FacesContext) method.
    
    Overrides:
    
    encodeChildren in class UIComponentBase
    
    Parameters:
    
    context - FacesContext for the response we are creating
    
    Throws:
    
    IOException - if an input/output error occurs while rendering
    
    Since:
    
    2.0
  - encodeEnd
```
public void encodeEnd(FacesContext context)
               throws IOException
```
    If getAfterPhaseListener() returns non-null, invoke it, passing a PhaseEvent for the PhaseId.RENDER_RESPONSE phase. Any errors that occur during invocation of the afterPhase listener must be logged and swallowed. If the current view has view parameters, as indicated by a non-empty and non-UnsupportedOperationException throwing return from ViewDeclarationLanguage.getViewMetadata(javax.faces.context.FacesContext, String), call UIViewParameter.encodeAll(javax.faces.context.FacesContext) on each parameter. If calling getViewParameters() causes UnsupportedOperationException to be thrown, the exception must be silently swallowed.
    
    Overrides:
    
    encodeEnd in class UIComponentBase
    
    Parameters:
    
    context - FacesContext for the response we are creating
    
    Throws:
    
    IOException - if an input/output error occurs while rendering
  - getRendersChildren
```
public boolean getRendersChildren()
```
    Call UIComponentBase.getRendersChildren() If PartialViewContext.isAjaxRequest() returns true this method must return true.
    
    Overrides:
    
    getRendersChildren in class UIComponentBase
    
    Since:
    
    2.0
  - processValidators
```
public void processValidators(FacesContext context)
```
    Perform partial processing by calling PartialViewContext.processPartial(javax.faces.event.PhaseId) with PhaseId.PROCESS_VALIDATIONS if:
    
    PartialViewContext.isPartialRequest() returns true and we don't have a request to process all components in the view (PartialViewContext.isExecuteAll() returns false)
    
    Perform full processing by calling UIComponentBase.processValidators(javax.faces.context.FacesContext) if one of the following conditions are met:
    
    PartialViewContext.isPartialRequest() returns true and we have a request to process all components in the view (PartialViewContext.isExecuteAll() returns true)
    
    PartialViewContext.isPartialRequest() returns false
    Override the default UIComponentBase.processValidators(javax.faces.context.FacesContext) behavior to broadcast any queued events after the default processing or partial processing has been completed and to clear out any events for later phases if the event processing for this phase caused FacesContext.renderResponse() or FacesContext.responseComplete() to be called.
    Overrides:
    
    processValidators in class UIComponentBase
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    Throws:
    
    NullPointerException - if context is null
  - processUpdates
```
public void processUpdates(FacesContext context)
```
    Perform partial processing by calling PartialViewContext.processPartial(javax.faces.event.PhaseId) with PhaseId.UPDATE_MODEL_VALUES if:
    
    PartialViewContext.isPartialRequest() returns true and we don't have a request to process all components in the view (PartialViewContext.isExecuteAll() returns false)
    
    Perform full processing by calling UIComponentBase.processUpdates(javax.faces.context.FacesContext) if one of the following conditions are met:
    
    PartialViewContext.isPartialRequest() returns true and we have a request to process all components in the view (PartialViewContext.isExecuteAll() returns true)
    
    PartialViewContext.isPartialRequest() returns false
    Override the default UIComponentBase behavior to broadcast any queued events after the default processing or partial processing has been completed and to clear out any events for later phases if the event processing for this phase caused FacesContext.renderResponse() or FacesContext.responseComplete() to be called.
    Overrides:
    
    processUpdates in class UIComponentBase
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    Throws:
    
    NullPointerException - if context is null
  - processApplication
```
public void processApplication(FacesContext context)
```
    Broadcast any events that have been queued for the Invoke Application phase of the request processing lifecycle and to clear out any events for later phases if the event processing for this phase caused FacesContext.renderResponse() or FacesContext.responseComplete() to be called.
    
    Parameters:
    
    context - FacesContext for the request we are processing
    
    Throws:
    
    NullPointerException - if context is null
  - createUniqueId
```
public String createUniqueId()
```
    Generate an identifier for a component. The identifier will be prefixed with UNIQUE_ID_PREFIX, and will be unique within the non-NamingContainer child sub-trees of this UIViewRoot.
  - createUniqueId
```
public String createUniqueId(FacesContext context,
                             String seed)
```
    Generate an identifier for a component. The identifier will be prefixed with UNIQUE_ID_PREFIX, and will be unique within this UIViewRoot. Optionally, a unique seed value can be supplied by component creators which should be included in the generated unique id.
    
    Specified by:
    
    createUniqueId in interface UniqueIdVendor
    
    Parameters:
    
    context - FacesContext
    
    seed - an optional seed value - e.g. based on the position of the component in the VDL-template
    
    Returns:
    
    a unique-id in this component-container
  - getLocale
```
public Locale getLocale()
```
    Return the Locale to be used in localizing the response being created for this view.
    
    Algorithm:
    
    If we have a locale ivar, return it. If we have a value expression for "locale", get its value. If the value is null, return the result of calling ViewHandler.calculateLocale(javax.faces.context.FacesContext). If the value is an instance of java.util.Locale return it. If the value is a String, convert it to a java.util.Locale and return it. If there is no value expression for "locale", return the result of calling ViewHandler.calculateLocale(javax.faces.context.FacesContext).
    
    Returns:
    
    The current Locale obtained by executing the above algorithm.
  - setLocale
```
public void setLocale(Locale locale)
```
    Set the Locale to be used in localizing the response being created for this view.
    
    Parameters:
    
    locale - The new localization Locale
  - getViewMap
```
public Map<String,Object> getViewMap()
```
    This implementation simply calls through to getViewMap(boolean), passing true as the argument, and returns the result.
    
    Since:
    
    2.0
  - getViewMap
```
public Map<String,Object> getViewMap(boolean create)
```
    Returns a Map that acts as the interface to the data store that is the "view scope", or, if this instance does not have such a Map and the create argument is true, creates one and returns it. This map must be instantiated lazily and cached for return from subsequent calls to this method on this UIViewRoot instance. Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object) must be called, passing PostConstructViewMapEvent.class as the first argument and this UIViewRoot instance as the second argument.
    
    The returned Map must be implemented such that calling clear() on the Map causes Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object) to be called, passing PreDestroyViewMapEvent.class as the first argument and this UIViewRoot instance as the second argument.
    
    Depending upon application configuration, objects stored in the view map may need to be Serializable. In general, it is a good idea to ensure that any objects stored in the view map are Serializable.
    
    For reasons made clear in ViewScoped, this map must ultimately be stored in the session. For this reason, a true value for the create argument will force the session to be created with a call to ExternalContext.getSession(boolean).
    
    See FacesContext.setViewRoot(javax.faces.component.UIViewRoot) for the specification of when the clear() method must be called.

Parameters:: create - true to create a new Map for this instance if necessary; false to return null if there's no current Map.
Since:: 2.0

subscribeToViewEvent
```
public void subscribeToViewEvent(Class<? extends SystemEvent> systemEvent,
                                 SystemEventListener listener)
```
Install the listener instance referenced by argument listener into the UIViewRoot as a listener for events of type systemEventClass.

Note that installed listeners are not maintained as part of the UIViewRoot's state.

Parameters:

systemEvent - the Class of event for which listener must be fired.

listener - the implementation of SystemEventListener whose SystemEventListener.processEvent(javax.faces.event.SystemEvent) method must be called when events of type systemEventClass are fired.

Throws:

NullPointerException - if systemEventClass or listener are null.

Since:

2.0

unsubscribeFromViewEvent
```
public void unsubscribeFromViewEvent(Class<? extends SystemEvent> systemEvent,
                                     SystemEventListener listener)
```
Remove the listener instance referenced by argument listener from the UIViewRoot as a listener for events of type systemEventClass.

Parameters:

systemEvent - the Class of event for which listener must be fired.

listener - the implementation of SystemEventListener whose SystemEventListener.processEvent(javax.faces.event.SystemEvent) method must be called when events of type systemEventClass are fired.

Throws:

NullPointerException - if systemEventClass or listener are null.

Since:

2.0

getViewListenersForEventClass
```
public List<SystemEventListener> getViewListenersForEventClass(Class<? extends SystemEvent> systemEvent)
```
Return the SystemEventListener instances registered on this UIComponent instance that are interested in events of type eventClass.

Parameters:

systemEvent - the Class of event for which the listeners must be returned.

Throws:

NullPointerException - if argument systemEvent is null.

Since:

2.0

restoreViewScopeState
```
public void restoreViewScopeState(FacesContext context,
                                  Object state)
```
Restore ViewScope state. This is needed to allow the use of view scoped beans for EL-expressions in the template from which the component tree is built. For example: <ui:include src="https://www.gaudry.be/java-api-javaee/#{viewScopedBean.includeFileName}"/>.

Parameters:

context - current FacesContext.

state - the state object.

saveState
```
public Object saveState(FacesContext context)
```
Description copied from interface: StateHolder
Gets the state of the instance as a Serializable Object.

If the class that implements this interface has references to instances that implement StateHolder (such as a UIComponent with event handlers, validators, etc.) this method must call the StateHolder.saveState(javax.faces.context.FacesContext) method on all those instances as well. This method must not save the state of children and facets. That is done via the StateManager

This method must not alter the state of the implementing object. In other words, after executing this code:
Object state = component.saveState(facesContext);
component should be the same as before executing it.

The return from this method must be Serializable
Specified by:

saveState in interface StateHolder

Overrides:

saveState in class UIComponentBase

restoreState
```
public void restoreState(FacesContext context,
                         Object state)
```
Description copied from interface: StateHolder

Perform any processing required to restore the state from the entries in the state Object.

If the class that implements this interface has references to instances that also implement StateHolder (such as a UIComponent with event handlers, validators, etc.) this method must call the StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object) method on all those instances as well.

If the state argument is null, take no action and return.

Specified by:

restoreState in interface StateHolder

Overrides:

restoreState in class UIComponentBase

Class UIViewRoot

Field Summary

Fields inherited from class javax.faces.component.UIComponent

Constructor Summary

Method Summary

Methods inherited from class javax.faces.component.UIComponentBase

Methods inherited from class javax.faces.component.UIComponent

Methods inherited from class java.lang.Object

Field Detail

METADATA_FACET_NAME

VIEW_PARAMETERS_KEY

COMPONENT_TYPE

COMPONENT_FAMILY

UNIQUE_ID_PREFIX

Constructor Detail

UIViewRoot

Method Detail

isInView

setInView

getFamily

getRenderKitId

setRenderKitId

getViewId

setViewId

getBeforePhaseListener

setBeforePhaseListener

getAfterPhaseListener

setAfterPhaseListener

removePhaseListener

addPhaseListener

getPhaseListeners

addComponentResource

addComponentResource

getComponentResources

removeComponentResource

removeComponentResource

queueEvent

broadcastEvents

processRestoreState

processDecodes

resetValues

encodeBegin

encodeChildren

encodeEnd

getRendersChildren

processValidators

processUpdates

processApplication

createUniqueId

createUniqueId

getLocale

setLocale

getViewMap

getViewMap

subscribeToViewEvent

unsubscribeFromViewEvent

getViewListenersForEventClass

restoreViewScopeState

saveState

restoreState

Références