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
ConstructorsConstructorDescriptionDeprecated.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 TypeMethodDescriptionvoidaddPhaseListener(PhaseListener listener) Register a newPhaseListenerinstance that is interested in being notified before and after the processing for standard phases of the request processing lifecycle.voidattachWindow(FacesContext context) Create or restore theClientWindowto be used to display theUIViewRootfor this run through the lifecycle.voidexecute(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 registeredPhaseListeners for thisLifecycleinstance.A class that implements this interface uses this method to return an instance of the class being wrapped.voidremovePhaseListener(PhaseListener listener) Deregister an existingPhaseListenerinstance that is no longer interested in being notified before and after the processing for standard phases of the request processing lifecycle.voidrender(FacesContext context) Execute the Render Response phase of the request processing lifecycle, unless theresponseComplete()method has been called on theFacesContextinstance 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:FacesWrapperA class that implements this interface uses this method to return an instance of the class being wrapped.
- Specified by:
getWrappedin interfaceFacesWrapper<Lifecycle>- Returns:
- the wrapped instance.
-
addPhaseListener
Description copied from class:LifecycleRegister a new
PhaseListenerinstance that is interested in being notified before and after the processing for standard phases of the request processing lifecycle.- Specified by:
addPhaseListenerin classLifecycle- Parameters:
listener- ThePhaseListenerto be registered
-
execute
Description copied from class:LifecycleExecute 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 theFacesContextinstance associated with the current request.- Specified by:
executein 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:LifecycleReturn the set of registered
PhaseListeners for thisLifecycleinstance. If there are no registered listeners, a zero-length array is returned.- Specified by:
getPhaseListenersin classLifecycle- Returns:
- the set of registered
PhaseListeners
-
removePhaseListener
Description copied from class:LifecycleDeregister an existing
PhaseListenerinstance 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:
removePhaseListenerin classLifecycle- Parameters:
listener- ThePhaseListenerto be deregistered
-
render
Description copied from class:LifecycleExecute the Render Response phase of the request processing lifecycle, unless the
responseComplete()method has been called on theFacesContextinstance associated with the current request.- Specified by:
renderin 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:LifecycleCreate or restore the
ClientWindowto be used to display theUIViewRootfor this run through the lifecycle. See the class documentation forClientWindowfor an overview of the feature. IfExternalContext.getClientWindow()returns null, create a new instance ofClientWindowusing theClientWindowFactory. If the result is non-null, callClientWindow.decode(jakarta.faces.context.FacesContext)on it. Store the newClientWindowby callingExternalContext.setClientWindow(jakarta.faces.lifecycle.ClientWindow).- Overrides:
attachWindowin classLifecycle- Parameters:
context- theFacesContextfor this request.
-