public abstract class NavigationHandlerWrapper extends NavigationHandler implements FacesWrapper<NavigationHandler>
NavigationHandlerWrapper provides a simple implementation of
NavigationHandler
that can be subclassed by developers wishing to provide specialized behavior to an existing
NavigationHandler
instance. The default implementation of all methods is to call through to the wrapped
NavigationHandler
instance.
Usage: extend this class and push the implementation being wrapped to the constructor and use getWrapped()
to
access the instance being wrapped.
Constructor and Description |
---|
NavigationHandlerWrapper()
Deprecated.
Use the other constructor taking the implementation being wrapped.
|
NavigationHandlerWrapper(NavigationHandler wrapped)
If this navigation handler has been decorated, the implementation doing the decorating should push the implementation being wrapped to this constructor. |
Modifier and Type | Method and Description |
---|---|
NavigationHandler |
getWrapped()
A class that implements this interface uses this method to return an instance of the class being wrapped. |
void |
handleNavigation(FacesContext context,
java.lang.String fromAction,
java.lang.String outcome)
Perform navigation processing based on the state information in the
specified
FacesContext , plus the outcome string returned by an executed application action. |
void |
handleNavigation(FacesContext context,
java.lang.String fromAction,
java.lang.String outcome,
java.lang.String toFlowDocumentId)
Overloaded variant of
|
@Deprecated public NavigationHandlerWrapper()
public NavigationHandlerWrapper(NavigationHandler wrapped)
If this navigation handler 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.
wrapped
- The implementation being wrapped.public NavigationHandler getWrapped()
FacesWrapper
A class that implements this interface uses this method to return an instance of the class being wrapped.
getWrapped
in interface FacesWrapper<NavigationHandler>
public void handleNavigation(FacesContext context, java.lang.String fromAction, java.lang.String outcome)
NavigationHandler
Perform navigation processing based on the state information in the
specified FacesContext
, plus the outcome string returned by an executed application action.
If the implementation class also extends ConfigurableNavigationHandler
, the implementation must guarantee
that the logic used in a call to ConfigurableNavigationHandler.getNavigationCase(jakarta.faces.context.FacesContext, java.lang.String, java.lang.String)
is used in this method to
determine the correct navigation.
This method must set the render targets (used in partial rendering) to render all
invoking
PartialViewContext.setRenderAll(boolean)
) if the view identifier has changed as the result of an
application action (to take into account Ajax requests
).
handleNavigation
in class NavigationHandler
context
- The FacesContext
for the current requestfromAction
- The action binding expression that was evaluated to retrieve the specified outcome, or
null
if the outcome was acquired by some other meansoutcome
- The logical outcome returned by a previous invoked application action (which may be null
)public void handleNavigation(FacesContext context, java.lang.String fromAction, java.lang.String outcome, java.lang.String toFlowDocumentId)
NavigationHandler
Overloaded variant of
NavigationHandler.handleNavigation(jakarta.faces.context.FacesContext, java.lang.String, java.lang.String)
that allows the
caller to provide the defining document id for a flow to be entered by this navigation. For backward compatibility
with decorated NavigationHandler
implementations that conform to an earlier version of the specification, an
implementation is provided that calls through to
NavigationHandler.handleNavigation(jakarta.faces.context.FacesContext, java.lang.String, java.lang.String)
, ignoring the
toFlowDocumentId
parameter.
handleNavigation
in class NavigationHandler
context
- The FacesContext
for the current requestfromAction
- The action binding expression that was evaluated to retrieve the specified outcome, or
null
if the outcome was acquired by some other meansoutcome
- The logical outcome returned by a previous invoked application action (which may be null
)toFlowDocumentId
- The defining document id of the flow into which this navigation will cause entry.