javax.faces.application

Class StateManagerWrapper

java.lang.Object

javax.faces.application.StateManager

javax.faces.application.StateManagerWrapper

public abstract class StateManagerWrapper
extends StateManager

see Javadoc of JSF Specification

Author:

Stan Silvert

Nested Class Summary

Nested classes/interfaces inherited from class javax.faces.application.StateManager

StateManager.SerializedView

Field Summary

Fields inherited from class javax.faces.application.StateManager

STATE_SAVING_METHOD_CLIENT, STATE_SAVING_METHOD_PARAM_NAME, STATE_SAVING_METHOD_SERVER

Constructor Summary

Constructors

Constructor and Description
StateManagerWrapper()

Method Summary

Methods

Modifier and Type	Method and Description
protected Object	getComponentStateToSave(FacesContext context) Return data that can be applied to a component tree created using the "getTreeStructureToSave" method.
protected Object	getTreeStructureToSave(FacesContext context) Return data that is sufficient to recreate the component tree that is the viewroot of the specified context, but without restoring the state in the components.
protected abstract StateManager	getWrapped()
boolean	isSavingStateInClient(FacesContext context)
protected void	restoreComponentState(FacesContext context, UIViewRoot viewRoot, String renderKitId)
protected UIViewRoot	restoreTreeStructure(FacesContext context, String viewId, String renderKitId)
UIViewRoot	restoreView(FacesContext context, String viewId, String renderKitId)
StateManager.SerializedView	saveSerializedView(FacesContext context) Invokes getTreeStructureToSave and getComponentStateToSave, then return an object that wraps the two resulting objects.
Object	saveView(FacesContext context) Returns an object that is sufficient to recreate the component tree that is the viewroot of the specified context.
void	writeState(FacesContext context, Object state) Associate the provided state object with the current response being generated.
void	writeState(FacesContext context, StateManager.SerializedView state) Associate the provided state object with the current response being generated.

Methods inherited from class java.lang.Object

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

Constructor Detail

StateManagerWrapper

public StateManagerWrapper()

Method Detail

getWrapped

protected abstract StateManager getWrapped()

saveSerializedView

public StateManager.SerializedView saveSerializedView(FacesContext context)

Description copied from class: StateManager

Invokes getTreeStructureToSave and getComponentStateToSave, then return an object that wraps the two resulting objects. This object can then be passed to method writeState.

Deprecated; use saveView instead.

Overrides:

saveSerializedView in class StateManager

saveView

public Object saveView(FacesContext context)

Description copied from class: StateManager

Returns an object that is sufficient to recreate the component tree that is the viewroot of the specified context.

The return value is suitable for passing to method writeState.

Overrides:

saveView in class StateManager

isSavingStateInClient

public boolean isSavingStateInClient(FacesContext context)

Overrides:

isSavingStateInClient in class StateManager

getTreeStructureToSave

protected Object getTreeStructureToSave(FacesContext context)

Description copied from class: StateManager

Return data that is sufficient to recreate the component tree that is the viewroot of the specified context, but without restoring the state in the components.

Using this data, a tree of components which has the same "shape" as the original component tree can be recreated. However the component instances themselves will have only their default values, ie their member fields will not have been set to the original values.

Deprecated; use saveView instead.

Overrides:

getTreeStructureToSave in class StateManager

getComponentStateToSave

protected Object getComponentStateToSave(FacesContext context)

Description copied from class: StateManager

Return data that can be applied to a component tree created using the "getTreeStructureToSave" method.

Deprecated; use saveView instead.

Overrides:

getComponentStateToSave in class StateManager

writeState

public void writeState(FacesContext context,
              StateManager.SerializedView state)
                throws IOException

Description copied from class: StateManager

Associate the provided state object with the current response being generated.

When client-side state is enabled, it is expected that method writes the data contained in the state parameter to the response somehow.

When server-side state is enabled, at most a "token" is expected to be written.

Deprecated; use writeState(FacesContext, Object) instead. This method was abstract in JSF1.1, but is now an empty non-abstract method so that old classes that implement this method continue to work, while new classes can just override the new writeState method rather than this one.

Overrides:

writeState in class StateManager

Throws:

IOException

writeState

public void writeState(FacesContext context,
              Object state)
                throws IOException

Description copied from class: StateManager

Associate the provided state object with the current response being generated.

When client-side state is enabled, it is expected that method writes the data contained in the state parameter to the response somehow.

When server-side state is enabled, at most a "token" is expected to be written.

This method should be overridden by subclasses. It is not abstract because a default implementation is provided that forwards to the old writeState method; this allows subclasses of StateManager written using the JSF1.1 API to continue to work.

Overrides:

writeState in class StateManager

Throws:

IOException

restoreView

public UIViewRoot restoreView(FacesContext context,
                     String viewId,
                     String renderKitId)

Specified by:

restoreView in class StateManager

restoreTreeStructure

protected UIViewRoot restoreTreeStructure(FacesContext context,
                              String viewId,
                              String renderKitId)

Overrides:

restoreTreeStructure in class StateManager

restoreComponentState

protected void restoreComponentState(FacesContext context,
                         UIViewRoot viewRoot,
                         String renderKitId)

Overrides:

restoreComponentState in class StateManager