Navegación entre páginas con JSF

De ChuWiki
Revisión del 16:07 9 may 2011 de Chuidiang (Discusión | contribuciones) (Definir rutas de navegación)

Saltar a: navegación, buscar

Introducción

Usando java beans en la parte del servidor podemos decidir cómo se navega entre las páginas del navegador en función de los datos introducidos por el usuario o cualquier circuntancia que podamos programar. La idea básica es que en un bean de java del lado del servidor pongamos un método sin parámetros que devuelva un String. El botón h:commandButton de un formulario (o un h:commandLink) llamarán a este método y será este método el que devuelva en el String cual es la siguiente página a visualizar.

Los componentes de la página

Supongamos el siguiente formulario

<h:form>
   <h:inputText id="idNumero" required="true"
      value="#{holaMundo.numero}">
   </h:inputText>
   <h:commandButton action="#{holaMundo.navega}" value="Enviar">
   </h:commandButton>
</h:form>

Es un formulario con un campo de texto h:inputText asociado al atributo holaMundo.numero (un atributo entero en el bean HolaMundo.java). En el botón de envío hemos puesto una llamada al método navega() ( action="#{holaMundo.navega}" ) que pondremos en ese HolaMundo.java, de forma que al pulsar el botón de "Enviar", se llamará a este método.

El bean

El bean HolaMundo.java puede ser como este

package com.chuidiang.ejemplos.jsf;


import javax.faces.bean.ManagedBean;

@ManagedBean
public class HolaMundo {

   private int numero = 4;

   public int getNumero() {
      return numero;
   }

   public void setNumero(int numero) {
      this.numero = numero;
   }

   public String navega() {
      if (numero % 2 == 0) {
         return "par.xhtml";
      } else {
         return "impar.xhtml";
      }
   }

}

Símplemente comprueba si el número es par o impar, para devolver la página par.xhtml o impar.xhtml. De esta forma, al pulsar el botón, se verá una página u otra según el número introducido por el usuario sea par o impar. Ojo, es importante que las páginas existan, porque JSF es demasiado listo y si no existen, nos dejará en la página actual.

Definir rutas de navegación

No es estrictamente necesario, pero podemos definir rutas de navegación en el fichero WEB-INF/faces-config.xml. Podemos poner, por ejemplo, algo como esto

<?xml version="1.0" encoding="UTF-8"?>

<faces-config xmlns="http://java.sun.com/xml/ns/javaee"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
	version="2.0">

	<navigation-rule>
		<from-view-id>/faces/hola.xml</from-view-id>
		<navigation-case>
			<from-outcome>par</from-outcome>
			<to-view-id>/faces/par.xml</to-view-id>
		</navigation-case>
		<navigation-case>
			<from-outcome>impar</from-outcome>
			<to-view-id>/faces/impar.xml</to-view-id>
		</navigation-case>
	</navigation-rule>

</faces-config>

Creamos una regla de navegación. En ella decidimos cual es la página de origen <from-view-id> (/faces/hola.xml en nuestro ejemplo) y para cada una de las posibles páginas destino ponemos una especie de identificador <from-outcome> y el destino <to-view-id>.

La modificación que debemos hacer en nuestro bean, es que en vez de devolver directamente en el String la página xhtml, nos basta con devolver el <from-outcome> correspondiente, es decir

   public String navega() {
      if (numero % 2 == 0) {
         return "par";
      } else {
         return "impar";
      }
   }