NavigationCase

java.lang.Object
- jakarta.faces.application.NavigationCase

Direct Known Subclasses:

NavigationCaseWrapper
```
public class NavigationCase
extends java.lang.Object
```
NavigationCase represents a <navigation-case> in the navigation rule base, as well as the <from-view-id> with which this <navigation-case> is a sibling.

Since:

2.0

Constructor Summary

Constructors
Constructor and Description
`NavigationCase(java.lang.String fromViewId, java.lang.String fromAction, java.lang.String fromOutcome, java.lang.String condition, java.lang.String toViewId, java.util.Map<java.lang.String,java.util.List<java.lang.String>> parameters, boolean redirect, boolean includeViewParams)` Construct a new `NavigationCase` based on the provided arguments.
`NavigationCase(java.lang.String fromViewId, java.lang.String fromAction, java.lang.String fromOutcome, java.lang.String condition, java.lang.String toViewId, java.lang.String toFlowDocumentId, java.util.Map<java.lang.String,java.util.List<java.lang.String>> parameters, boolean redirect, boolean includeViewParams)` Construct a new `NavigationCase` based on the provided arguments.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object o)`
`java.net.URL`	`getActionURL(FacesContext context)` Construct an absolute URL to this `NavigationCase` instance using `ViewHandler.getActionURL(jakarta.faces.context.FacesContext, java.lang.String)` on the path portion of the url.
`java.net.URL`	`getBookmarkableURL(FacesContext context)` Construct an absolute URL suitable for a bookmarkable link to this `NavigationCase` instance using `ViewHandler.getBookmarkableURL(jakarta.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.Boolean`	`getCondition(FacesContext context)` Evaluates the `<if>` for this `<navigation-case>`, if any.
`java.lang.String`	`getFromAction()` Return the `<from-action>` for this `<navigation-case>`
`java.lang.String`	`getFromOutcome()` Return the `<from-outcome>` for this `<navigation-case>`
`java.lang.String`	`getFromViewId()` 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.URL`	`getRedirectURL(FacesContext context)` Construct an absolute URL suitable for a "redirect" to this `NavigationCase` instance using `ViewHandler.getRedirectURL(jakarta.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.URL`	`getResourceURL(FacesContext context)` Construct an absolute URL to this `NavigationCase` instance using `ViewHandler.getResourceURL(jakarta.faces.context.FacesContext, java.lang.String)` on the path portion of the url.
`java.lang.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 `getFromOutcome()` is defined.
`java.lang.String`	`getToViewId(FacesContext context)` Evaluates the `<to-view-id>` for this `<navigation-case>`
`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>`.
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - NavigationCase
```
public NavigationCase(java.lang.String fromViewId,
                      java.lang.String fromAction,
                      java.lang.String fromOutcome,
                      java.lang.String condition,
                      java.lang.String toViewId,
                      java.util.Map<java.lang.String,java.util.List<java.lang.String>> parameters,
                      boolean redirect,
                      boolean includeViewParams)
```
    Construct a new NavigationCase based on the provided arguments. See section 7.4.2 "Default NavigationHandler Algorithm" of the Jakarta Faces Specification Document for how a NavigationCase is used by the standard ConfigurableNavigationHandler
    
    Parameters:
    
    fromViewId - return from getFromViewId()
    
    fromAction - return from getFromAction()
    
    fromOutcome - return from getFromOutcome()
    
    condition - A string to be interpreted as a ValueExpression by a call to getCondition(jakarta.faces.context.FacesContext)
    
    toViewId - return from getToViewId(jakarta.faces.context.FacesContext)
    
    parameters - return from getParameters()
    
    redirect - return from isRedirect()
    
    includeViewParams - return isIncludeViewParams()
  - NavigationCase
```
public NavigationCase(java.lang.String fromViewId,
                      java.lang.String fromAction,
                      java.lang.String fromOutcome,
                      java.lang.String condition,
                      java.lang.String toViewId,
                      java.lang.String toFlowDocumentId,
                      java.util.Map<java.lang.String,java.util.List<java.lang.String>> parameters,
                      boolean redirect,
                      boolean includeViewParams)
```
    Construct a new NavigationCase based on the provided arguments. See section 7.4.2 "Default NavigationHandler Algorithm" of the Jakarta Faces Specification Document for how a NavigationCase is used by the standard ConfigurableNavigationHandler
    
    Parameters:
    
    fromViewId - return from getFromViewId()
    
    fromAction - return from getFromAction()
    
    fromOutcome - return from getFromOutcome()
    
    condition - A string to be interpreted as a ValueExpression by a call to getCondition(jakarta.faces.context.FacesContext)
    
    toViewId - return from getToViewId(jakarta.faces.context.FacesContext)
    
    toFlowDocumentId - the toFlow documentId.
    
    parameters - return from getParameters()
    
    redirect - return from isRedirect()
    
    includeViewParams - return isIncludeViewParams()
- Method Detail
  - getActionURL
```
public java.net.URL getActionURL(FacesContext context)
                          throws java.net.MalformedURLException
```
    Construct an absolute URL to this NavigationCase instance using ViewHandler.getActionURL(jakarta.faces.context.FacesContext, java.lang.String) on the path portion of the url.
    
    Parameters:
    
    context - the FacesContext for the current request
    
    Returns:
    
    the action URL.
    
    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
```
    Construct an absolute URL to this NavigationCase instance using ViewHandler.getResourceURL(jakarta.faces.context.FacesContext, java.lang.String) on the path portion of the url.
    
    Parameters:
    
    context - the FacesContext for the current request
    
    Returns:
    
    the resource URL.
    
    Throws:
    
    java.net.MalformedURLException - if the process of constructing the URL causes this exception to be thrown.
  - getRedirectURL
```
public java.net.URL getRedirectURL(FacesContext context)
                            throws java.net.MalformedURLException
```
    Construct an absolute URL suitable for a "redirect" to this NavigationCase instance using ViewHandler.getRedirectURL(jakarta.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.
    
    Parameters:
    
    context - the FacesContext for the current request
    
    Returns:
    
    the redirect URL.
    
    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
```
    Construct an absolute URL suitable for a bookmarkable link to this NavigationCase instance using ViewHandler.getBookmarkableURL(jakarta.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.
    
    Parameters:
    
    context - the FacesContext for the current request
    
    Returns:
    
    the bookmarkable URL.
    
    Throws:
    
    java.net.MalformedURLException - if the process of constructing the URL causes this exception to be thrown.
  - getFromViewId
```
public java.lang.String getFromViewId()
```
    Return the <from-view-id> of the <navigation-rule> inside which this <navigation-case> is nested.
    
    Returns:
    
    the from viedId.
  - getFromAction
```
public java.lang.String getFromAction()
```
    Return the <from-action> for this <navigation-case>
    
    Returns:
    
    the from action.
  - getFromOutcome
```
public java.lang.String getFromOutcome()
```
    Return the <from-outcome> for this <navigation-case>
    
    Returns:
    
    the from outcome.
  - getToViewId
```
public java.lang.String getToViewId(FacesContext context)
```
    Evaluates the <to-view-id> for this <navigation-case>
    
    Parameters:
    
    context - the FacesContext for the current request
    
    Returns:
    
    the view ID that should be navigated to
  - getToFlowDocumentId
```
public java.lang.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 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.
    
    Returns:
    
    the toFlow documentId.
    
    Since:
    
    2.2
  - hasCondition
```
public boolean hasCondition()
```
    Test if this navigation case has an associated <if> element.
    
    Returns:
    
    true if there's an <if> element associated with this <navigation-case>, otherwise false
  - getCondition
```
public java.lang.Boolean getCondition(FacesContext context)
```
    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 a boolean per the normal Jakarta Expression Language coercion rules.
    Note throws any exceptions encountered during the process of evaluating the expression or obtaining its value.
    
    Parameters:
    
    context - the FacesContext 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
  - getParameters
```
public 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. If no parameters are defined, null will be returned. The keys in the Map are parameter names. For each key, the corresponding value is a List of unconverted values.
    
    Returns:
    
    the list of parameters, or null
  - isRedirect
```
public boolean isRedirect()
```
    Return the <redirect> value for this <navigation-case>. This will be true if the new view should be navigated to via a ExternalContext.redirect(String)
    
    Returns:
    
    true if this is a redirect, false otherwise.
  - isIncludeViewParams
```
public boolean isIncludeViewParams()
```
    Return the <redirect> value for this <navigation-case>. This will be true if the view parametets should be encoded into the redirect URL (only applies to redirect case)
    
    Returns:
    
    true if view parameters are to be included, false otherwise.
  - equals
```
public boolean equals(java.lang.Object o)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class NavigationCase

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

NavigationCase

NavigationCase

Method Detail

getActionURL

getResourceURL

getRedirectURL

getBookmarkableURL

getFromViewId

getFromAction

getFromOutcome

getToViewId

getToFlowDocumentId

hasCondition

getCondition

getParameters

isRedirect

isIncludeViewParams

equals

hashCode

toString