Ir al contenido principal

JSF 2.0: Navegación (I)

En este post vamos a ver los conceptos básicos sobre la navegación de una aplicación JSF.

La navegación más sencilla en JSF consiste en asociar un String al action de un botón o link:
<h:commandButton label="Aceptar" action="login"/>
<h:commandLink action="login">
    <h:outputText value="Aceptar"/>
</h:commandLink>

En este ejemplo, pinchar en el botón o el link nos llevará a la página JSF asociada al String "login".

Si queremos poder elegir la página a mostrar en tiempo de ejecución, asociamos el action a un método que nos devuelva el String correspondiente:
<h:commandButton label="Aceptar" action"#{userBean.login}"/>

En este ejemplo, al pinchar el botón se ejecuta el método login() del bean userBean, devolviendo éste un String que indicará la siguiente página a mostrar. Estos métodos tienen que ser públicos, sin argumentos y devolver un String.
public String login() {
    return "login";
}
¿Cómo asociamos el String del action con una página JSF?
Creando reglas de navegación en el fichero faces-config.xml:
<navigation-rule>
    <from-view-id>/index.xhtml</from-view-id>
    <navigation-case>
          <from-outcome>login</from-outcome>
          <to-view-id>/login.xhtml</to-view-id>
    </navigation-case>
    <navigation-case>
          <from-outcome>register</from-outcome>
          <to-view-id>/register.xhtml</to-view-id>
    </navigation-case>
</navigation-rule>

En este ejemplo podemos ver que desde la página index.xhtml podemos ir a login.xhtml o a register.xhtml dependiendo si el action devuelve "login" o "register" respectivamente.

Omitir <from-view-id> o ponerlo como <from-view-id>*</from-view-id> es equivalente. El wildcard '*' se puede utilizar una sola vez y siempre al final (ej. <from-view-id>/pages/*</from-view-id>).

También podemos utilizar el mismo <from-outcome> y diferenciarlos según la acción que se realice:
<navigation-case>
    <from-action>#{userBean.login}</from-action>
    <from-outcome>success</from-outcome>
    <to-view-id>/login.xhtml</to-view-id>
</navigation-case>
<navigation-case>
    <from-action>#{userBean.registerUser}</from-action>
    <from-outcome>success</from-outcome>
    <to-view-id>/register.xhtml</to-view-id>
</navigation-case>

En este ejemplo no se llama al método que está entre #{}, ya que esto se realiza dinámicamente desde una página, simplemente se asocia al action correspondiente.

¿Tenemos que utilizar obligatoriamente faces-config.xml?
No. Desde JSF 2.0 podemos utilizar navegación implícita, es decir, nos basta con poner en el action el nombre de nuestra página JSF sin la extensión correspondiente.

<h:commandButton action="login"/> nos llevaría a la página login.xhtml

¿Se puede navegar a una página dependiendo de si se cumple una condición?
Desde JSF 2.0 sí.
<navigation-case>
    <from-outcome>login</from-outcome>
<if>#{userBean.profile != 1}</if>
    <to-view-id>/login.xhtml</to-view-id>
</navigation-case>

En el siguiente post veremos conceptos más avanzados sobre la navegación en JSF.

Etiquetas:

Comentarios

Publicar un comentario

Entradas populares de este blog

Leer un fichero properties con java.util.Properties

Los ficheros .properties son simples ficheros de texto que se suelen utilizar para guardar parámetros de configuración, en forma de pares clave-valor. Ejemplo de fichero: configuration.properties #User parameters user.name=Ana user.language=spanish Si estamos usando Java, podemos utilizar la clase java.util.Properties para leer los parámetros de este fichero: private static final String USER_NAME = "user.name"; private static final String USER_LANGUAGE = "user.language"; public void showProperties() throws Exception { Properties p = new Properties(); InputStream is = App.class.getResourceAsStream("/configuration.properties"); p.load(is); is.close(); String userName = p.getProperty(USER_NAME); String userCountry = p.getProperty(USER_LANGUAGE); System.out.println("userName: "+userName); System.out.println("userLanguage: "+userCountry); } Después de ejecutar este método, obtendríamos la siguiente salida: ...
Leer más

JSF 2.0: Managed Beans (III)

Anteriormente ya hemos visto que cuando se declara un bean, tenemos que darle un scope: application, session, view, request, none. Un scope es un mapeo entre nombres y objetos que se almacena durante un determinado periodo de tiempo. En este post vamos a explicar cada uno de ellos. Si declaramos el bean desde el fichero faces-config.xml, indicamos el scope en <managed-bean-scope> y si queremos hacerlo con anotaciones, utilizaremos @{Application,Session,View,Request,None}Scoped Application Con este scope, se guarda la información durante toda la vida de la aplicación web, independientemente de todas las peticiones y sesiones que se realicen. Este bean se instancia con la primera petición a la aplicación y desaparece cuando la aplicación web se elimina del servidor. Si queremos que el bean se instancie antes de que se muestre la primera página de la aplicación, usamos la propiedad eager a true. @ManagedBean(eager=true) ó <managed-bean eager="true"> Session...
Publicar un comentario
Leer más

JSF 2.0: Message bundles

Los message bundles son ficheros .properties que guardan mensajes del tipo clave=valor. Si centralizamos todos los mensajes de nuestra aplicación en estos ficheros, es más fácil poder localizarlos si queremos realizar algún cambio y también nos ayuda para la internacionalización de la aplicación. Ejemplo: messages.properties (en src/java/com/examples) con dos mensajes name=Tu nombre: age=Tu edad: ¿Cómo los declaramos? 1) En cada página JSF donde lo necesitemos <f:loadBundle basename="com.examples.messages" var="msgs"/> 2) De manera global en faces-config.xml <application>      <resource-bundle>           <base-name>com.examples.messages</base-name>           <var>msg</var>      </resource-bundle> </application> Esta opción es más eficiente ya que sólo crea el bundle una v...
3 comentarios
Leer más