javax.faces.application
Class NavigationHandler

java.lang.Object
  javax.faces.application.NavigationHandler

public abstract class NavigationHandler

extends java.lang.Object

A NavigationHandler is passed the outcome string returned by an Action invoked for this application, and will use this (along with related state information) to choose the component tree to be displayed next.

The behavior requirements for the default implementation have not yet been defined by the JSR-127 expert group, but will be documented here when completed.

Constructor Summary

NavigationHandler()

Method Summary

abstract void

handleNavigation(FacesContext context, java.lang.String actionRef, java.lang.String outcome) Perform navigation processing based on the state information in the specified FacesContext, plus the outcome string returned by an executed Action.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NavigationHandler

public NavigationHandler()

Method Detail

handleNavigation

public abstract void handleNavigation(FacesContext context,
                                      java.lang.String actionRef,
                                      java.lang.String outcome)

Perform navigation processing based on the state information in the specified FacesContext, plus the outcome string returned by an executed Action.

Parameters:

context - The FacesContext for the current request

actionRef - The action reference expression that was evaluated to retrieve the specified outcome, or null if the outcome was acquired by some other means

outcome - The logical outcome returned by a previous Action

Throws:

java.lang.NullPointerException - if context or outcome is null