Module jakarta.faces

Package com.sun.faces.flow.builder

Class MutableNavigationCase

java.lang.Object

jakarta.faces.application.NavigationCase

com.sun.faces.flow.builder.MutableNavigationCase

public class MutableNavigationCase
extends NavigationCase

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	Description
MutableNavigationCase()
MutableNavigationCase(String fromViewId, String fromAction, String fromOutcome, String condition, String toViewId, String toFlowDocumentId, boolean redirect, boolean includeViewParams)
MutableNavigationCase(String fromViewId, String fromAction, String fromOutcome, String condition, String toViewId, String toFlowDocumentId, Map<String,List<String>> parameters, boolean redirect, boolean includeViewParams)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
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.
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>
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>.
void	setCondition(String condition)
void	setConditionExpression(ValueExpression conditionExpression)
void	setFromAction(String fromAction)
void	setFromOutcome(String fromOutcome)
void	setFromViewId(String fromViewId)
void	setIncludeViewParams(boolean includeViewParams)
void	setRedirect(boolean redirect)
void	setToFlowDocumentId(String toFlowDocumentId)
void	setToViewId(String toViewId)
String	toString()

Methods inherited from class jakarta.faces.application.NavigationCase

getActionURL, getBookmarkableURL, getRedirectURL, getResourceURL

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

MutableNavigationCase

public MutableNavigationCase()

MutableNavigationCase

public MutableNavigationCase(String fromViewId,
 String fromAction,
 String fromOutcome,
 String condition,
 String toViewId,
 String toFlowDocumentId,
 Map<String,List<String>> parameters,
 boolean redirect,
 boolean includeViewParams)

MutableNavigationCase

public MutableNavigationCase(String fromViewId,
 String fromAction,
 String fromOutcome,
 String condition,
 String toViewId,
 String toFlowDocumentId,
 boolean redirect,
 boolean includeViewParams)

Method Details

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 class NavigationCase

Returns:

the from viedId.

setFromViewId

public void setFromViewId(String fromViewId)

getFromAction

public String getFromAction()

Description copied from class: NavigationCase

Return the <from-action> for this <navigation-case>

Overrides:

getFromAction in class NavigationCase

Returns:

the from action.

setFromAction

public void setFromAction(String fromAction)

getFromOutcome

public String getFromOutcome()

Description copied from class: NavigationCase

Return the <from-outcome> for this <navigation-case>

Overrides:

getFromOutcome in class NavigationCase

Returns:

the from outcome.

setFromOutcome

public void setFromOutcome(String fromOutcome)

getToViewId

public String getToViewId(FacesContext context)

Description copied from class: NavigationCase

Evaluates the <to-view-id> for this <navigation-case>

Overrides:

getToViewId in class NavigationCase

Parameters:

context - the FacesContext for the current request

Returns:

the view ID that should be navigated to

setToViewId

public void setToViewId(String toViewId)

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 class NavigationCase

Returns:

the toFlow documentId.

setToFlowDocumentId

public void setToFlowDocumentId(String toFlowDocumentId)

hasCondition

public boolean hasCondition()

Description copied from class: NavigationCase

Test if this navigation case has an associated <if> element.

Overrides:

hasCondition in class NavigationCase

Returns:

true if there's an <if> element associated with this <navigation-case>, otherwise false

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 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.

Overrides:

getCondition in class NavigationCase

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

setCondition

public void setCondition(String condition)

setConditionExpression

public void setConditionExpression(ValueExpression conditionExpression)

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 the Map are parameter names. For each key, the corresponding value is a List of unconverted values.

Overrides:

getParameters in class NavigationCase

Returns:

the list of parameters, or null

isRedirect

public boolean isRedirect()

Description copied from class: NavigationCase

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)

Overrides:

isRedirect in class NavigationCase

Returns:

true if this is a redirect, false otherwise.

setRedirect

public void setRedirect(boolean redirect)

isIncludeViewParams

public boolean isIncludeViewParams()

Description copied from class: NavigationCase

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)

Overrides:

isIncludeViewParams in class NavigationCase

Returns:

true if view parameters are to be included, false otherwise.

setIncludeViewParams

public void setIncludeViewParams(boolean includeViewParams)

equals

public boolean equals(Object obj)

Overrides:

equals in class NavigationCase

hashCode

public int hashCode()

Overrides:

hashCode in class NavigationCase

toString

public String toString()

Overrides:

toString in class NavigationCase