- 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
NavigationCase
that can be subclassed by developers wishing to provide specialized behavior to an existingNavigationCase
instance. The default implementation of all methods is to call through to the wrappedNavigationCase
instance.Usage: extend this class and override
getWrapped()
to return the instance being wrapping.- Since:
- 2.2
-
-
Constructor Summary
Constructors Constructor and Description NavigationCaseWrapper()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method and Description boolean
equals(Object o)
URL
getActionURL(FacesContext context)
Construct an absolute URL to this
NavigationCase
instance usingViewHandler.getActionURL(javax.faces.context.FacesContext, java.lang.String)
on the path portion of the url.URL
getBookmarkableURL(FacesContext context)
Construct an absolute URL suitable for a bookmarkable link to this
NavigationCase
instance 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.Boolean
getCondition(FacesContext context)
Evaluates the
<if>
for this<navigation-case>
, if any.String
getFromAction()
Return the
<from-action> for this
<navigation-case>
String
getFromOutcome()
Return the
<from-outcome> for this
<navigation-case>
String
getFromViewId()
Return the
<from-view-id>
of the<navigation-rule>
inside which this<navigation-case>
is nested.Map<String,List<String>>
getParameters()
Return the parameters to be included for navigation cases requiring a redirect.
URL
getRedirectURL(FacesContext context)
Construct an absolute URL suitable for a "redirect" to this
NavigationCase
instance 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.URL
getResourceURL(FacesContext context)
Construct an absolute URL to this
NavigationCase
instance usingViewHandler.getResourceURL(javax.faces.context.FacesContext, java.lang.String)
on the path portion of the url.String
getToFlowDocumentId()
If 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.String
getToViewId(FacesContext context)
Evaluates the
<to-view-id>
for this<navigation-case>
abstract NavigationCase
getWrapped()
A class that implements this interface uses this method to return an instance of the class being wrapped.
boolean
hasCondition()
Test if this navigation case has an associated
<if>
element.int
hashCode()
boolean
isIncludeViewParams()
Return the
<redirect>
value for this<navigation-case>
.boolean
isRedirect()
Return the
<redirect>
value for this<navigation-case>
.String
toString()
-
-
-
Method Detail
-
equals
public boolean equals(Object o)
- Overrides:
equals
in classNavigationCase
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classNavigationCase
-
toString
public String toString()
- Overrides:
toString
in classNavigationCase
-
getWrapped
public abstract NavigationCase getWrapped()
Description copied from interface:FacesWrapper
A class that implements this interface uses this method to return an instance of the class being wrapped.
- Specified by:
getWrapped
in interfaceFacesWrapper<NavigationCase>
-
getActionURL
public URL getActionURL(FacesContext context) throws MalformedURLException
Description copied from class:NavigationCase
Construct an absolute URL to this
NavigationCase
instance usingViewHandler.getActionURL(javax.faces.context.FacesContext, java.lang.String)
on the path portion of the url.- Overrides:
getActionURL
in classNavigationCase
- Parameters:
context
- theFacesContext
for the current request- Throws:
MalformedURLException
- if the process of constructing the URL causes this exception to be thrown.
-
getBookmarkableURL
public URL getBookmarkableURL(FacesContext context) throws MalformedURLException
Description copied from class:NavigationCase
Construct an absolute URL suitable for a bookmarkable link to this
NavigationCase
instance 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:
getBookmarkableURL
in classNavigationCase
- Parameters:
context
- theFacesContext
for the current request- Throws:
MalformedURLException
- if the process of constructing the URL causes this exception to be thrown.
-
getCondition
public Boolean getCondition(FacesContext context)
Description copied from class:NavigationCase
Evaluates 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 aboolean
per the normal EL coercion rules.- Overrides:
getCondition
in classNavigationCase
- Parameters:
context
- theFacesContext
for the current request- Returns:
null
if there is no<if>
element associated with this<navigation-case>
, otherwise return the evaluation result of the condition
-
getFromAction
public String getFromAction()
Description copied from class:NavigationCase
Return the
<from-action> for this
<navigation-case>
- Overrides:
getFromAction
in classNavigationCase
-
getFromOutcome
public String getFromOutcome()
Description copied from class:NavigationCase
Return the
<from-outcome> for this
<navigation-case>
- Overrides:
getFromOutcome
in classNavigationCase
-
getFromViewId
public String getFromViewId()
Description copied from class:NavigationCase
Return the
<from-view-id>
of the<navigation-rule>
inside which this<navigation-case>
is nested.- Overrides:
getFromViewId
in classNavigationCase
-
getParameters
public Map<String,List<String>> getParameters()
Description copied from class:NavigationCase
Return the parameters to be included for navigation cases requiring a redirect. If no parameters are defined,
null
will be returned. The keys in theMap
are parameter names. For each key, the corresponding value is aList
of unconverted values.- Overrides:
getParameters
in classNavigationCase
-
getRedirectURL
public URL getRedirectURL(FacesContext context) throws MalformedURLException
Description copied from class:NavigationCase
Construct an absolute URL suitable for a "redirect" to this
NavigationCase
instance 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:
getRedirectURL
in classNavigationCase
- Parameters:
context
- theFacesContext
for the current request- Throws:
MalformedURLException
- if the process of constructing the URL causes this exception to be thrown.
-
getResourceURL
public URL getResourceURL(FacesContext context) throws MalformedURLException
Description copied from class:NavigationCase
Construct an absolute URL to this
NavigationCase
instance usingViewHandler.getResourceURL(javax.faces.context.FacesContext, java.lang.String)
on the path portion of the url.- Overrides:
getResourceURL
in classNavigationCase
- Parameters:
context
- theFacesContext
for the current request- Throws:
MalformedURLException
- if the process of constructing the URL causes this exception to be thrown.
-
getToViewId
public String getToViewId(FacesContext context)
Description copied from class:NavigationCase
Evaluates the
<to-view-id>
for this<navigation-case>
- Overrides:
getToViewId
in classNavigationCase
- Parameters:
context
- theFacesContext
for the current request- Returns:
- the view ID that should be navigated to
-
getToFlowDocumentId
public String getToFlowDocumentId()
Description copied from class:NavigationCase
If 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:
getToFlowDocumentId
in classNavigationCase
-
hasCondition
public boolean hasCondition()
Description copied from class:NavigationCase
Test if this navigation case has an associated
<if>
element.- Overrides:
hasCondition
in classNavigationCase
- Returns:
true
if there's an<if>
element associated with this<navigation-case>
, otherwisefalse
-
isIncludeViewParams
public boolean isIncludeViewParams()
Description copied from class:NavigationCase
Return the
<redirect>
value for this<navigation-case>
. This will betrue
if the view parametets should be encoded into the redirect URL (only applies to redirect case)- Overrides:
isIncludeViewParams
in classNavigationCase
-
isRedirect
public boolean isRedirect()
Description copied from class:NavigationCase
Return the
<redirect>
value for this<navigation-case>
. This will betrue
if the new view should be navigated to via aExternalContext.redirect(String)
- Overrides:
isRedirect
in classNavigationCase
-
-
Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/faces/application/NavigationCaseWrapper.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.