Class LifecycleWrapper
- java.lang.Object
-
- javax.faces.lifecycle.Lifecycle
-
- javax.faces.lifecycle.LifecycleWrapper
-
- All Implemented Interfaces:
FacesWrapper<Lifecycle>
public abstract class LifecycleWrapper extends Lifecycle implements FacesWrapper<Lifecycle>
Provides a simple implementation of
Lifecycle
that can be subclassed by developers wishing to provide specialized behavior to an existingLifecycle
instance. The default implementation of all methods is to call through to the wrappedLifecycle
.Usage: extend this class and override getWrapped() to return the instance we are wrapping.
- Since:
- 2.2
-
-
Constructor Summary
Constructors Constructor Description LifecycleWrapper()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description void
addPhaseListener(PhaseListener listener)
Register a newPhaseListener
instance that is interested in being notified before and after the processing for standard phases of the request processing lifecycle.void
attachWindow(FacesContext context)
Create or restore theClientWindow
to be used to display theUIViewRoot
for this run through the lifecycle.void
execute(FacesContext context)
Execute all of the phases of the request processing lifecycle, up to but not including the Render Response phase, as described in the JavaServer Faces Specification, in the specified order.PhaseListener[]
getPhaseListeners()
Return the set of registeredPhaseListener
s for thisLifecycle
instance.abstract Lifecycle
getWrapped()
A class that implements this interface uses this method to return an instance of the class being wrapped.void
removePhaseListener(PhaseListener listener)
Deregister an existingPhaseListener
instance that is no longer interested in being notified before and after the processing for standard phases of the request processing lifecycle.void
render(FacesContext context)
Execute the Render Response phase of the request processing lifecycle, unless theresponseComplete()
method has been called on theFacesContext
instance associated with the current request.
-
-
-
Method Detail
-
getWrapped
public abstract Lifecycle 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<Lifecycle>
-
addPhaseListener
public void addPhaseListener(PhaseListener listener)
Description copied from class:Lifecycle
Register a new
PhaseListener
instance that is interested in being notified before and after the processing for standard phases of the request processing lifecycle.- Specified by:
addPhaseListener
in classLifecycle
- Parameters:
listener
- ThePhaseListener
to be registered
-
execute
public void execute(FacesContext context) throws FacesException
Description copied from class:Lifecycle
Execute all of the phases of the request processing lifecycle, up to but not including the Render Response phase, as described in the JavaServer Faces Specification, in the specified order. The processing flow can be affected (by the application, by components, or by event listeners) by calls to the
renderResponse()
orresponseComplete()
methods of theFacesContext
instance associated with the current request.- Specified by:
execute
in classLifecycle
- Parameters:
context
- FacesContext for the request to be processed- Throws:
FacesException
- if thrown during the execution of the request processing lifecycle
-
getPhaseListeners
public PhaseListener[] getPhaseListeners()
Description copied from class:Lifecycle
Return the set of registered
PhaseListener
s for thisLifecycle
instance. If there are no registered listeners, a zero-length array is returned.- Specified by:
getPhaseListeners
in classLifecycle
-
removePhaseListener
public void removePhaseListener(PhaseListener listener)
Description copied from class:Lifecycle
Deregister an existing
PhaseListener
instance that is no longer interested in being notified before and after the processing for standard phases of the request processing lifecycle. If no such listener instance has been registered, no action is taken.- Specified by:
removePhaseListener
in classLifecycle
- Parameters:
listener
- ThePhaseListener
to be deregistered
-
render
public void render(FacesContext context) throws FacesException
Description copied from class:Lifecycle
Execute the Render Response phase of the request processing lifecycle, unless the
responseComplete()
method has been called on theFacesContext
instance associated with the current request.- Specified by:
render
in classLifecycle
- Parameters:
context
- FacesContext for the request being processed- Throws:
FacesException
- if an exception is thrown during the execution of the request processing lifecycle
-
attachWindow
public void attachWindow(FacesContext context)
Description copied from class:Lifecycle
Create or restore the
ClientWindow
to be used to display theUIViewRoot
for this run through the lifecycle. See the class documentation forClientWindow
for an overview of the feature. IfExternalContext.getClientWindow()
returns null, create a new instance ofClientWindow
using theClientWindowFactory
. If the result is non-null, callClientWindow.decode(javax.faces.context.FacesContext)
on it. Store the newClientWindow
by callingExternalContext.setClientWindow(javax.faces.lifecycle.ClientWindow)
.- Overrides:
attachWindow
in classLifecycle
-
-