javax.faces.application

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 NavigationCase that can be subclassed by developers wishing to provide specialized behavior to an existing NavigationCase instance. The default implementation of all methods is to call through to the wrapped NavigationCase 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

Modifier and Type	Method and Description
boolean	equals(Object o)
URL	getActionURL(FacesContext context) Construct an absolute URL to this NavigationCase instance using ViewHandler.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 using ViewHandler.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 using ViewHandler.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 using ViewHandler.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()

Methods inherited from class java.lang.Object

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

Constructor Detail

NavigationCaseWrapper

public NavigationCaseWrapper()

Method Detail

equals

public boolean equals(Object o)

Overrides:

equals in class NavigationCase

hashCode

public int hashCode()

Overrides:

hashCode in class NavigationCase

toString

public String toString()

Overrides:

toString in class NavigationCase

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 interface FacesWrapper<NavigationCase>

getActionURL

public URL getActionURL(FacesContext context)
                 throws MalformedURLException

Description copied from class: NavigationCase

Construct an absolute URL to this NavigationCase instance using ViewHandler.getActionURL(javax.faces.context.FacesContext, java.lang.String) on the path portion of the url.

Overrides:

getActionURL in class NavigationCase

Parameters:

context - the FacesContext 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 using ViewHandler.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 class NavigationCase

Parameters:

context - the FacesContext 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 a boolean per the normal EL coercion rules.

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

getFromAction

public String getFromAction()

Description copied from class: NavigationCase

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

Overrides:

getFromAction in class NavigationCase

getFromOutcome

public String getFromOutcome()

Description copied from class: NavigationCase

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

Overrides:

getFromOutcome in class NavigationCase

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

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

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 using ViewHandler.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 class NavigationCase

Parameters:

context - the FacesContext 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 using ViewHandler.getResourceURL(javax.faces.context.FacesContext, java.lang.String) on the path portion of the url.

Overrides:

getResourceURL in class NavigationCase

Parameters:

context - the FacesContext 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 class NavigationCase

Parameters:

context - the FacesContext 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 class NavigationCase

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

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

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