Navigation Rules

• A navigation rule tells JSF which page to send back to the browser after a form has been submitted

• In login example, when user clicks Login, we want to navigate from index.jsp to welcome.jsp

• Specify this in faces-config.xml with this navigation rule:

     <navigation-rule>
        <from-view-id>/index.jsp</from-view-id>
        <navigation-case>
           <from-outcome>login</from-outcome>
           <to-view-id>/welcome.jsp</to-view-id>
        </navigation-case>
     </navigation-rule>
  

• Note the action attribute given to the h:commandButton tag:

       <h:commandButton value="Login" action="login"/>      

• The action attribute value matches the value of the from-outcome tag in the navigation rule

• The rule says: If the current page is index.jsp and the requested action is login, then go to the welcome.jsp page