类 DecoratingNavigationHandler
- java.lang.Object
- javax.faces.application.NavigationHandler
- org.springframework.web.jsf.DecoratingNavigationHandler
public abstract class DecoratingNavigationHandler extends NavigationHandler
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 overloadedhandleNavigation
method. Standard JSF invocations will automatically delegate to the overloaded method, with the constructor-injected NavigationHandler as argument.- 从以下版本开始:
- 1.2.7
- 作者:
- Juergen Hoeller
- 另请参阅:
handleNavigation(javax.faces.context.FacesContext, String, String, NavigationHandler)
,DelegatingNavigationHandlerProxy
构造器概要
构造器 限定符 构造器 说明 protected
DecoratingNavigationHandler()
Create a DecoratingNavigationHandler without fixed original NavigationHandler.protected
DecoratingNavigationHandler(NavigationHandler originalNavigationHandler)
Create a DecoratingNavigationHandler with fixed original NavigationHandler.
方法概要
所有方法 实例方法 抽象方法 具体方法 修饰符和类型 方法 说明 protected void
callNextHandlerInChain(FacesContext facesContext, String fromAction, String outcome, NavigationHandler originalNavigationHandler)
Method to be called by subclasses when intending to delegate to the next handler in the NavigationHandler chain.NavigationHandler
getDecoratedNavigationHandler()
Return the fixed original NavigationHandler decorated by this handler, if any (that is, if passed in through the constructor).void
handleNavigation(FacesContext facesContext, String fromAction, String outcome)
This implementation of the standard JSFhandleNavigation
method delegates to the overloaded variant, passing in constructor-injected NavigationHandler as argument.abstract void
handleNavigation(FacesContext facesContext, String fromAction, String outcome, NavigationHandler originalNavigationHandler)
SpecialhandleNavigation
variant with explicit NavigationHandler argument.从类继承的方法 javax.faces.application.NavigationHandler
handleNavigation
构造器详细资料
DecoratingNavigationHandler
protected DecoratingNavigationHandler()
Create a DecoratingNavigationHandler without fixed original NavigationHandler.
DecoratingNavigationHandler
protected DecoratingNavigationHandler(NavigationHandler originalNavigationHandler)
Create a DecoratingNavigationHandler with fixed original NavigationHandler.- 参数:
originalNavigationHandler
- the original NavigationHandler to decorate
方法详细资料
getDecoratedNavigationHandler
public final NavigationHandler getDecoratedNavigationHandler()
Return the fixed original NavigationHandler decorated by this handler, if any (that is, if passed in through the constructor).
handleNavigation
public final void handleNavigation(FacesContext facesContext, String fromAction, String outcome)
This implementation of the standard JSFhandleNavigation
method delegates to the overloaded variant, passing in constructor-injected NavigationHandler as argument.
handleNavigation
public abstract void handleNavigation(FacesContext facesContext, String fromAction, String outcome, NavigationHandler originalNavigationHandler)
SpecialhandleNavigation
variant with explicit NavigationHandler argument. Either called directly, by code with an explicit original handler, or called from the standardhandleNavigation
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 (seecallNextHandlerInChain
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, ornull
if the outcome was acquired by some other meansoutcome
- the logical outcome returned by a previous invoked application action (which may benull
)originalNavigationHandler
- the original NavigationHandler, ornull
if none- 另请参阅:
callNextHandlerInChain(javax.faces.context.FacesContext, java.lang.String, java.lang.String, javax.faces.application.NavigationHandler)
callNextHandlerInChain
protected final void callNextHandlerInChain(FacesContext facesContext, String fromAction, String outcome, NavigationHandler originalNavigationHandler)
Method to be called by subclasses when intending to delegate to the next handler in the NavigationHandler chain. Will always call the most appropriate next handler, either the decorated NavigationHandler passed in as constructor argument or the original NavigationHandler as passed into this method - according to the position of this instance in the chain.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 NavigationHandler 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, ornull
if the outcome was acquired by some other meansoutcome
- the logical outcome returned by a previous invoked application action (which may benull
)originalNavigationHandler
- the original NavigationHandler, ornull
if none