org.apache.myfaces.lifecycle
Interface RestoreViewSupport

All Known Implementing Classes:

DefaultRestoreViewSupport

public interface RestoreViewSupport

Support class for restore view phase

Version:

$Revision: 887436 $ $Date: 2009-12-04 18:11:25 -0500 (Fri, 04 Dec 2009) $

Author:

Mathias Broekelmann (latest modification by $Author: lu4242 $)

Method Summary

java.lang.String	calculateViewId(javax.faces.context.FacesContext facesContext) Calculates the view id from the given faces context by the following algorithm
java.lang.String	deriveViewId(javax.faces.context.FacesContext context, java.lang.String viewId) Derive a view id retrieved from calling calculateViewId(FacesContext), but do not check if a resource with this name exists.
boolean	isPostback(javax.faces.context.FacesContext facesContext) Determine if the current request is a post back by the following algorithm.
void	processComponentBinding(javax.faces.context.FacesContext facesContext, javax.faces.component.UIComponent component) Processes the component tree.

Method Detail

calculateViewId

java.lang.String calculateViewId(javax.faces.context.FacesContext facesContext)

Calculates the view id from the given faces context by the following algorithm

• lookup the viewid from the request attribute "javax.servlet.include.path_info"
• if null lookup the value for viewid by ExternalContext.getRequestPathInfo()
• if null lookup the value for viewid from the request attribute "javax.servlet.include.servlet_path"
• if null lookup the value for viewid by ExternalContext.getRequestServletPath()
• if null throw a FacesException

deriveViewId

java.lang.String deriveViewId(javax.faces.context.FacesContext context,
                              java.lang.String viewId)

Derive a view id retrieved from calling calculateViewId(FacesContext), but do not check if a resource with this name exists. This method is useful to retrieve a VDL instance, but note there are some cases (TCK test) where it is expected in Restore View algorithm a null or dummy viewId is passed.

Parameters:

context -

viewId -

Returns:

processComponentBinding

void processComponentBinding(javax.faces.context.FacesContext facesContext,
                             javax.faces.component.UIComponent component)

Processes the component tree. For each component (including the given one) in the tree determine if a value expression for the attribute "binding" is defined. If the expression is not null set the component instance to the value of this expression

Parameters:

facesContext -

component - the root component

isPostback

boolean isPostback(javax.faces.context.FacesContext facesContext)

Determine if the current request is a post back by the following algorithm.

Find the render-kit-id for the current request by calling calculateRenderKitId() on the Application’s ViewHandler. Get that RenderKit’s ResponseStateManager and call its isPostback() method, passing the given FacesContext.

Parameters:

facesContext -

Returns: