|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.faces.application.NavigationHandler org.springframework.web.jsf.DecoratingNavigationHandler
public abstract class DecoratingNavigationHandler
Base class for JSF NavigationHandler implementations that want to be capable of decorating an original NavigationHandler.
Supports the standard JSF style of decoration (through a constructor argument)
as well as an overloaded handleNavigation
method with explicit
NavigationHandler argument (passing in the original NavigationHandler). Subclasses
are forced to implement this overloaded handleNavigation
method.
Standard JSF invocations will automatically delegate to the overloaded method,
with the constructor-injected NavigationHandler as argument.
DelegatingNavigationHandlerProxy
Constructor Summary | |
---|---|
protected |
DecoratingNavigationHandler()
Create a DecoratingNavigationHandler without fixed original NavigationHandler. |
protected |
DecoratingNavigationHandler(javax.faces.application.NavigationHandler originalNavigationHandler)
Create a DecoratingNavigationHandler with fixed original NavigationHandler. |
Method Summary | |
---|---|
protected void |
callNextHandlerInChain(javax.faces.context.FacesContext facesContext,
String fromAction,
String outcome,
javax.faces.application.NavigationHandler originalNavigationHandler)
Method to be called by subclasses when intending to delegate to the next handler in the NavigationHandler chain. |
javax.faces.application.NavigationHandler |
getDecoratedNavigationHandler()
Return the fixed original NavigationHandler decorated by this handler, if any (that is, if passed in through the constructor). |
void |
handleNavigation(javax.faces.context.FacesContext facesContext,
String fromAction,
String outcome)
This implementation of the standard JSF handleNavigation method
delegates to the overloaded variant, passing in constructor-injected
NavigationHandler as argument. |
abstract void |
handleNavigation(javax.faces.context.FacesContext facesContext,
String fromAction,
String outcome,
javax.faces.application.NavigationHandler originalNavigationHandler)
Special handleNavigation variant with explicit NavigationHandler
argument. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected DecoratingNavigationHandler()
protected DecoratingNavigationHandler(javax.faces.application.NavigationHandler originalNavigationHandler)
originalNavigationHandler
- the original NavigationHandler to decorateMethod Detail |
---|
public final javax.faces.application.NavigationHandler getDecoratedNavigationHandler()
public final void handleNavigation(javax.faces.context.FacesContext facesContext, String fromAction, String outcome)
handleNavigation
method
delegates to the overloaded variant, passing in constructor-injected
NavigationHandler as argument.
handleNavigation
in class javax.faces.application.NavigationHandler
handleNavigation(javax.faces.context.FacesContext, String, String, javax.faces.application.NavigationHandler)
public abstract void handleNavigation(javax.faces.context.FacesContext facesContext, String fromAction, String outcome, javax.faces.application.NavigationHandler originalNavigationHandler)
handleNavigation
variant with explicit NavigationHandler
argument. Either called directly, by code with an explicit original handler,
or called from the standard handleNavigation
method, as
plain JSF-defined NavigationHandler.
Implementations should invoke callNextHandlerInChain
to
delegate to the next handler in the chain. This will always call the most
appropriate next handler (see callNextHandlerInChain
javadoc).
Alternatively, the decorated NavigationHandler or the passed-in original
NavigationHandler can also be called directly; however, this is not as
flexible in terms of reacting to potential positions in the chain.
facesContext
- the current JSF contextfromAction
- 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
)originalNavigationHandler
- the original NavigationHandler,
or null
if nonecallNextHandlerInChain(javax.faces.context.FacesContext, java.lang.String, java.lang.String, javax.faces.application.NavigationHandler)
protected final void callNextHandlerInChain(javax.faces.context.FacesContext facesContext, String fromAction, String outcome, javax.faces.application.NavigationHandler originalNavigationHandler)
Will call the decorated NavigationHandler specified as constructor argument, if any. In case of a DecoratingNavigationHandler as target, the original NavigationHandler as passed into this method will be passed on to the next element in the chain: This ensures propagation of the original handler that the last element in the handler chain might delegate back to. In case of a standard NavigationHandler as target, the original handler will simply not get passed on; no delegating back to the original is possible further down the chain in that scenario.
If no decorated NavigationHandler specified as constructor argument, this instance is the last element in the chain. Hence, this method will call the original NavigationHandler as passed into this method. If no original NavigantionHandler has been passed in (for example if this instance is the last element in a chain with standard NavigationHandlers as earlier elements), this method corresponds to a no-op.
facesContext
- the current JSF contextfromAction
- 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
)originalNavigationHandler
- the original NavigationHandler,
or null
if none
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |