Class StateManagerWrapper
- java.lang.Object
-
- javax.faces.application.StateManager
-
- javax.faces.application.StateManagerWrapper
-
- All Implemented Interfaces:
FacesWrapper<StateManager>
public abstract class StateManagerWrapper extends StateManager implements FacesWrapper<StateManager>
Provides a simple implementation of
StateManager
that can be subclassed by developers wishing to provide specialized behavior to an existingStateManager
instance. The default implementation of all methods is to call through to the wrappedStateManager
.Usage: extend this class and push the implementation being wrapped to the constructor and use
getWrapped()
to access the instance being wrapped.- Since:
- 1.2
-
-
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
FULL_STATE_SAVING_VIEW_IDS_PARAM_NAME, IS_BUILDING_INITIAL_STATE, IS_SAVING_STATE, PARTIAL_STATE_SAVING_PARAM_NAME, SERIALIZE_SERVER_STATE_PARAM_NAME, STATE_SAVING_METHOD_CLIENT, STATE_SAVING_METHOD_PARAM_NAME, STATE_SAVING_METHOD_SERVER
-
-
Constructor Summary
Constructors Constructor Description StateManagerWrapper()
Deprecated.Use the other constructor taking the implementation being wrapped.StateManagerWrapper(StateManager wrapped)
If this state manager has been decorated, the implementation doing the decorating should push the implementation being wrapped to this constructor.
-
Method Summary
-
-
-
Constructor Detail
-
StateManagerWrapper
@Deprecated public StateManagerWrapper()
Deprecated. Use the other constructor taking the implementation being wrapped.
-
StateManagerWrapper
public StateManagerWrapper(StateManager wrapped)
If this state manager has been decorated, the implementation doing the decorating should push the implementation being wrapped to this constructor. The
getWrapped()
will then return the implementation being wrapped.- Parameters:
wrapped
- The implementation being wrapped.- Since:
- 2.3
-
-
Method Detail
-
getWrapped
public StateManager getWrapped()
Description copied from interface:FacesWrapper
A class that implements this interface uses this method to return an instance of the class being wrapped.
- Specified by:
getWrapped
in interfaceFacesWrapper<StateManager>
- Returns:
- the wrapped instance.
-
saveSerializedView
public StateManager.SerializedView saveSerializedView(FacesContext context)
The default behavior of this method is to call
StateManager.saveSerializedView(javax.faces.context.FacesContext)
on the wrappedStateManager
object.- Overrides:
saveSerializedView
in classStateManager
- Parameters:
context
-FacesContext
for the current request- Returns:
- the serialized view, or null.
- Since:
- 1.2
- See Also:
StateManager.saveSerializedView(javax.faces.context.FacesContext)
-
saveView
public java.lang.Object saveView(FacesContext context)
The default behavior of this method is to call
StateManager.saveView(javax.faces.context.FacesContext)
on the wrappedStateManager
object.- Overrides:
saveView
in classStateManager
- Parameters:
context
-FacesContext
for the current request- Returns:
- the saved view.
- Since:
- 1.2
- See Also:
StateManager.saveView(javax.faces.context.FacesContext)
-
getTreeStructureToSave
protected java.lang.Object getTreeStructureToSave(FacesContext context)
The default behavior of this method is to call
StateManager.getTreeStructureToSave(javax.faces.context.FacesContext)
on the wrappedStateManager
object.- Overrides:
getTreeStructureToSave
in classStateManager
- Parameters:
context
-FacesContext
for the current request- Returns:
- the tree structure, or null.
- Since:
- 1.2
- See Also:
StateManager.getTreeStructureToSave(javax.faces.context.FacesContext)
-
getComponentStateToSave
protected java.lang.Object getComponentStateToSave(FacesContext context)
The default behavior of this method is to call
StateManager.getComponentStateToSave(javax.faces.context.FacesContext)
on the wrappedStateManager
object.- Overrides:
getComponentStateToSave
in classStateManager
- Parameters:
context
-FacesContext
for the current request- Returns:
- the component state, or null.
- Since:
- 1.2
- See Also:
StateManager.getComponentStateToSave(javax.faces.context.FacesContext)
-
writeState
public void writeState(FacesContext context, java.lang.Object state) throws java.io.IOException
The default behavior of this method is to call
StateManager.writeState(javax.faces.context.FacesContext, java.lang.Object)
on the wrappedStateManager
object.- Overrides:
writeState
in classStateManager
- Parameters:
context
-FacesContext
for the current requeststate
- the Serializable state to be written, as returned byStateManager.saveSerializedView(javax.faces.context.FacesContext)
- Throws:
java.io.IOException
- when an I/O error occurs.- Since:
- 1.2
- See Also:
StateManager.writeState(javax.faces.context.FacesContext, java.lang.Object)
-
writeState
public void writeState(FacesContext context, StateManager.SerializedView state) throws java.io.IOException
The default behavior of this method is to call
StateManager.writeState(javax.faces.context.FacesContext, javax.faces.application.StateManager.SerializedView)
on the wrappedStateManager
object.- Overrides:
writeState
in classStateManager
- Parameters:
context
-FacesContext
for the current requeststate
- the serialized state to be written- Throws:
java.io.IOException
- when an I/O error occurs.- Since:
- 1.2
- See Also:
StateManager.writeState(javax.faces.context.FacesContext, javax.faces.application.StateManager.SerializedView)
-
restoreView
public UIViewRoot restoreView(FacesContext context, java.lang.String viewId, java.lang.String renderKitId)
The default behavior of this method is to call
StateManager.restoreView(javax.faces.context.FacesContext, String, String)
on the wrappedStateManager
object.- Specified by:
restoreView
in classStateManager
- Parameters:
context
-FacesContext
for the current requestviewId
- View identifier of the view to be restoredrenderKitId
- the renderKitId used to render this response. Must not benull
.- Returns:
- the view root, or
null
. - Since:
- 1.2
- See Also:
StateManager.restoreView(javax.faces.context.FacesContext, String, String)
-
restoreTreeStructure
protected UIViewRoot restoreTreeStructure(FacesContext context, java.lang.String viewId, java.lang.String renderKitId)
The default behavior of this method is to call
StateManager.restoreTreeStructure(javax.faces.context.FacesContext, String, String)
on the wrappedStateManager
object.- Overrides:
restoreTreeStructure
in classStateManager
- Parameters:
context
-FacesContext
for the current requestviewId
- View identifier of the view to be restoredrenderKitId
- the renderKitId used to render this response. Must not benull
.- Returns:
- the view root, or
null
. - Since:
- 1.2
- See Also:
StateManager.restoreTreeStructure(javax.faces.context.FacesContext, String, String)
-
restoreComponentState
protected void restoreComponentState(FacesContext context, UIViewRoot viewRoot, java.lang.String renderKitId)
The default behavior of this method is to call
StateManager.restoreComponentState(javax.faces.context.FacesContext, javax.faces.component.UIViewRoot, String)
on the wrappedStateManager
object.- Overrides:
restoreComponentState
in classStateManager
- Parameters:
context
-FacesContext
for the current requestviewRoot
-UIViewRoot
returned by a previous call torestoreTreeStructure()
renderKitId
- the renderKitId used to render this response. Must not benull
.- Since:
- 1.2
- See Also:
StateManager.restoreComponentState(javax.faces.context.FacesContext, javax.faces.component.UIViewRoot, String)
-
isSavingStateInClient
public boolean isSavingStateInClient(FacesContext context)
The default behavior of this method is to call
StateManager.isSavingStateInClient(javax.faces.context.FacesContext)
on the wrappedStateManager
object.- Overrides:
isSavingStateInClient
in classStateManager
- Parameters:
context
- the Faces context.- Returns:
true
if and only if the value of theServletContext
init parameter named by the value of the constantStateManager.STATE_SAVING_METHOD_PARAM_NAME
is equal (ignoring case) to the value of the constantStateManager.STATE_SAVING_METHOD_CLIENT
.false
otherwise.- Since:
- 1.2
- See Also:
StateManager.isSavingStateInClient(javax.faces.context.FacesContext)
-
getViewState
public java.lang.String getViewState(FacesContext context)
The default behavior of this method is to call
StateManager.getViewState(javax.faces.context.FacesContext)
on the wrappedStateManager
object.- Overrides:
getViewState
in classStateManager
- Parameters:
context
-FacesContext
for the current request- Returns:
- the view state.
- Since:
- 2.0
-
-