Class NavigationCaseWrapper
- java.lang.Object
-
- javax.faces.application.NavigationCase
-
- javax.faces.application.NavigationCaseWrapper
-
- All Implemented Interfaces:
FacesWrapper<NavigationCase>
public abstract class NavigationCaseWrapper extends NavigationCase implements FacesWrapper<NavigationCase>
Provides a simple implementation of
NavigationCasethat can be subclassed by developers wishing to provide specialized behavior to an existingNavigationCaseinstance. The default implementation of all methods is to call through to the wrappedNavigationCaseinstance.Usage: extend this class and override
getWrapped()to return the instance being wrapping.- Since:
- 2.2
-
-
Constructor Summary
Constructors Constructor Description NavigationCaseWrapper()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description booleanequals(java.lang.Object o)java.net.URLgetActionURL(FacesContext context)Construct an absolute URL to thisNavigationCaseinstance usingViewHandler.getActionURL(javax.faces.context.FacesContext, java.lang.String)on the path portion of the url.java.net.URLgetBookmarkableURL(FacesContext context)Construct an absolute URL suitable for a bookmarkable link to thisNavigationCaseinstance usingViewHandler.getBookmarkableURL(javax.faces.context.FacesContext, java.lang.String, java.util.Map<java.lang.String, java.util.List<java.lang.String>>, boolean)on the path portion of the url.java.lang.BooleangetCondition(FacesContext context)Evaluates the<if>for this<navigation-case>, if any.java.lang.StringgetFromAction()Return the<from-action> for this<navigation-case>java.lang.StringgetFromOutcome()Return the<from-outcome> for this<navigation-case>java.lang.StringgetFromViewId()Return the<from-view-id>of the<navigation-rule>inside which this<navigation-case>is nested.java.util.Map<java.lang.String,java.util.List<java.lang.String>>getParameters()Return the parameters to be included for navigation cases requiring a redirect.java.net.URLgetRedirectURL(FacesContext context)Construct an absolute URL suitable for a "redirect" to thisNavigationCaseinstance usingViewHandler.getRedirectURL(javax.faces.context.FacesContext, java.lang.String, java.util.Map<java.lang.String, java.util.List<java.lang.String>>, boolean)on the path portion of the url.java.net.URLgetResourceURL(FacesContext context)Construct an absolute URL to thisNavigationCaseinstance usingViewHandler.getResourceURL(javax.faces.context.FacesContext, java.lang.String)on the path portion of the url.java.lang.StringgetToFlowDocumentId()If this navigation case represents a flow invocation, this property is the documentId in which the flow whose id is given by the return fromNavigationCase.getFromOutcome()is defined.java.lang.StringgetToViewId(FacesContext context)Evaluates the<to-view-id>for this<navigation-case>abstract NavigationCasegetWrapped()A class that implements this interface uses this method to return an instance of the class being wrapped.booleanhasCondition()Test if this navigation case has an associated<if>element.inthashCode()booleanisIncludeViewParams()Return the<redirect>value for this<navigation-case>.booleanisRedirect()Return the<redirect>value for this<navigation-case>.java.lang.StringtoString()
-
-
-
Method Detail
-
equals
public boolean equals(java.lang.Object o)
- Overrides:
equalsin classNavigationCase
-
hashCode
public int hashCode()
- Overrides:
hashCodein classNavigationCase
-
toString
public java.lang.String toString()
- Overrides:
toStringin classNavigationCase
-
getWrapped
public abstract NavigationCase 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<NavigationCase>
-
getActionURL
public java.net.URL getActionURL(FacesContext context) throws java.net.MalformedURLException
Description copied from class:NavigationCaseConstruct an absolute URL to this
NavigationCaseinstance usingViewHandler.getActionURL(javax.faces.context.FacesContext, java.lang.String)on the path portion of the url.- Overrides:
getActionURLin classNavigationCase- Parameters:
context- theFacesContextfor the current request- Throws:
java.net.MalformedURLException- if the process of constructing the URL causes this exception to be thrown.
-
getBookmarkableURL
public java.net.URL getBookmarkableURL(FacesContext context) throws java.net.MalformedURLException
Description copied from class:NavigationCaseConstruct an absolute URL suitable for a bookmarkable link to this
NavigationCaseinstance usingViewHandler.getBookmarkableURL(javax.faces.context.FacesContext, java.lang.String, java.util.Map<java.lang.String, java.util.List<java.lang.String>>, boolean)on the path portion of the url. This URL may include view parameters specified as metadata within the view.- Overrides:
getBookmarkableURLin classNavigationCase- Parameters:
context- theFacesContextfor the current request- Throws:
java.net.MalformedURLException- if the process of constructing the URL causes this exception to be thrown.
-
getCondition
public java.lang.Boolean getCondition(FacesContext context)
Description copied from class:NavigationCaseEvaluates the
<if>for this<navigation-case>, if any. The expression to be evaluated is passed into the constructor as a string. When the expression is evaluated, its value must be coerced into abooleanper the normal EL coercion rules.- Overrides:
getConditionin classNavigationCase- Parameters:
context- theFacesContextfor the current request- Returns:
nullif there is no<if>element associated with this<navigation-case>, otherwise return the evaluation result of the condition
-
getFromAction
public java.lang.String getFromAction()
Description copied from class:NavigationCaseReturn the
<from-action> for this<navigation-case>- Overrides:
getFromActionin classNavigationCase
-
getFromOutcome
public java.lang.String getFromOutcome()
Description copied from class:NavigationCaseReturn the
<from-outcome> for this<navigation-case>- Overrides:
getFromOutcomein classNavigationCase
-
getFromViewId
public java.lang.String getFromViewId()
Description copied from class:NavigationCaseReturn the
<from-view-id>of the<navigation-rule>inside which this<navigation-case>is nested.- Overrides:
getFromViewIdin classNavigationCase
-
getParameters
public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getParameters()
Description copied from class:NavigationCaseReturn the parameters to be included for navigation cases requiring a redirect. If no parameters are defined,
nullwill be returned. The keys in theMapare parameter names. For each key, the corresponding value is aListof unconverted values.- Overrides:
getParametersin classNavigationCase
-
getRedirectURL
public java.net.URL getRedirectURL(FacesContext context) throws java.net.MalformedURLException
Description copied from class:NavigationCaseConstruct an absolute URL suitable for a "redirect" to this
NavigationCaseinstance usingViewHandler.getRedirectURL(javax.faces.context.FacesContext, java.lang.String, java.util.Map<java.lang.String, java.util.List<java.lang.String>>, boolean)on the path portion of the url.- Overrides:
getRedirectURLin classNavigationCase- Parameters:
context- theFacesContextfor the current request- Throws:
java.net.MalformedURLException- if the process of constructing the URL causes this exception to be thrown.
-
getResourceURL
public java.net.URL getResourceURL(FacesContext context) throws java.net.MalformedURLException
Description copied from class:NavigationCaseConstruct an absolute URL to this
NavigationCaseinstance usingViewHandler.getResourceURL(javax.faces.context.FacesContext, java.lang.String)on the path portion of the url.- Overrides:
getResourceURLin classNavigationCase- Parameters:
context- theFacesContextfor the current request- Throws:
java.net.MalformedURLException- if the process of constructing the URL causes this exception to be thrown.
-
getToViewId
public java.lang.String getToViewId(FacesContext context)
Description copied from class:NavigationCaseEvaluates the
<to-view-id>for this<navigation-case>- Overrides:
getToViewIdin classNavigationCase- Parameters:
context- theFacesContextfor the current request- Returns:
- the view ID that should be navigated to
-
getToFlowDocumentId
public java.lang.String getToFlowDocumentId()
Description copied from class:NavigationCaseIf this navigation case represents a flow invocation, this property is the documentId in which the flow whose id is given by the return from
NavigationCase.getFromOutcome()is defined. Implementations must override this method to return the value defined in the corresponding application configuration resources element. The base implementation returns the empty string.- Overrides:
getToFlowDocumentIdin classNavigationCase
-
hasCondition
public boolean hasCondition()
Description copied from class:NavigationCaseTest if this navigation case has an associated
<if>element.- Overrides:
hasConditionin classNavigationCase- Returns:
trueif there's an<if>element associated with this<navigation-case>, otherwisefalse
-
isIncludeViewParams
public boolean isIncludeViewParams()
Description copied from class:NavigationCaseReturn the
<redirect>value for this<navigation-case>. This will betrueif the view parametets should be encoded into the redirect URL (only applies to redirect case)- Overrides:
isIncludeViewParamsin classNavigationCase
-
isRedirect
public boolean isRedirect()
Description copied from class:NavigationCaseReturn the
<redirect>value for this<navigation-case>. This will betrueif the new view should be navigated to via aExternalContext.redirect(String)- Overrides:
isRedirectin classNavigationCase
-
-