Class LifecycleWrapper
- All Implemented Interfaces:
FacesWrapper<Lifecycle>
Provides a simple implementation of Lifecycle
that can be
subclassed by developers wishing to provide specialized behavior to an existing Lifecycle
instance. The
default implementation of all methods is to call through to the wrapped Lifecycle
.
Usage: extend this class and push the implementation being wrapped to the constructor and use getWrapped()
to
access the instance being wrapped.
- Since:
- 2.2
-
Constructor Summary
ConstructorDescriptionDeprecated.Use the other constructor taking the implementation being wrapped.LifecycleWrapper
(Lifecycle wrapped) If this lifecycle has been decorated, the implementation doing the decorating should push the implementation being wrapped to this constructor. -
Method Summary
Modifier and TypeMethodDescriptionvoid
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 Jakarta Server Faces Specification, in the specified order.Return the set of registeredPhaseListener
s for thisLifecycle
instance.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.
-
Constructor Details
-
LifecycleWrapper
Deprecated.Use the other constructor taking the implementation being wrapped. -
LifecycleWrapper
If this lifecycle 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 Details
-
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>
- Returns:
- the wrapped instance.
-
addPhaseListener
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
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 Jakarta Server 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
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
- Returns:
- the set of registered
PhaseListener
s
-
removePhaseListener
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
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
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(jakarta.faces.context.FacesContext)
on it. Store the newClientWindow
by callingExternalContext.setClientWindow(jakarta.faces.lifecycle.ClientWindow)
.- Overrides:
attachWindow
in classLifecycle
- Parameters:
context
- theFacesContext
for this request.
-