Visualizar información dinámica en páginas web con JavaServer Faces > Módulo 2: Añadir características avanzadas >
< Anterior | Siguiente >

Lección 2.3: Utilizar reglas de navegación

En esta lección, aprenderá a configurar reglas de navegación para redireccionar un usuario de sitio a páginas Web específicas.

Con la forma en que está configurada la página new_record.jsp, los usuarios debe tener cuidado de no entrar un número de ID que ya esté en uso, porque cada registro de la base de datos debe tener un número de ID exclusivo. Esto se explicó con más detalle bajo la nota "Evitar duplicación de claves" en Lección 1.5: Programar el botón Someter. En esta lección, se comprobará si el ID entrado es único y, si no lo fuera, redirigirá a una página de error que explique el problema y le diga al usuario cómo solucionarlo.

Las Reglas de navegación permiten dirigir a los usuarios a la página de error o a la página all_records.jsp tras comprobar si los usuarios han entrado o no un número de ID duplicado. Asignaremos alias a estos dos resultados posibles y luego enlazaremos los alias a las páginas de destino correctas. En este ejemplo, a un error en la página create_record.jsp le pondremos el alias ERROR_CREATE (ERROR EN LA CREACIÓN), el cual enviará a los usuarios a la página de error. Si los usuarios rellenan correctamente la página create_record.jsp, asignaremos el alias MAIN (PÁGINA PRINCIPAL), que accederá a la página all_records.jsp, como hacía antes.

Configurar las reglas

  1. Realice una doble pulsación sobre la página new_record.jsp en la vista Navegador de proyectos.
  2. Pulse el botón Publicar listado nuevo de la página.
  3. En la vista Propiedades, pulse Añadir regla. Se abre la ventana Añadir regla de navegación. La primera regla enviará al usuario a la página de error create_error.jsp en caso de que algo vaya mal en la creación y confirmación del registro nuevo en la base de datos.
  4. En el campo Página, escriba error_create.jsp. Esta página no existe pero en esta guía de aprendizaje simplemente supondremos que existe.
  5. Pulse el botón de selección La salida denominada.
  6. Entre ERROR_CREATE en el campo de texto tras el botón de selección La salida denominada.
  7. Pulse el botón de selección Sólo esta página, ya que no hay otra página en el sitio que pueda desencadenar este error concreto mediante la entrada de un ID duplicado. Pulse Aceptar. Si el usuario ha entrado un número de ID válido, la regla siguiente llevará a la página all_records.jsp.
  8. Pulse el botón Añadir regla para abrir nuevamente la ventana Añadir regla de navegación.
  9. Utilice el recuadro desplegable Página para seleccionar all_records.jsp.
  10. Pulse el recuadro de selección El resultado denominado y luego entre MAIN en el campo de texto que hay a continuación.
  11. Como es posible que quiera reutilizar esta regla en otra página (por ejemplo, en la página update_record.jsp), pulse el botón de selección Todas las páginas bajo Esta regla se utiliza para. Pulse Aceptar. Ahora se visualizan las dos reglas en la vista Propiedades.

Alias de vuelta para la acción del botón

Todo lo que resta es hacer utilizar las reglas nuevas de navegación. Añadiremos dos sentencias return al código del botón Publicar listado nuevo. Estas sentencias return invocan el alias correspondiente de forma que el usuario verá la página que se haya configurado en la regla de navegación.
  1. Pulse el botón Publicar listado nuevo.
  2. Abra la vista Edición rápida.
  3. En la vista Edición rápida, busque la línea en que aparece } catch (Throwable e) {. Esta función catch se ejecuta si el usuario ha entrado un número de ID duplicado.
  4. Elimine todo el código entre la apertura de llave { al final de esta línea y el cierre de llave } algunas líneas más abajo. No suprima las llaves.
  5. En el lugar del código entre las llaves, teclee este texto: return "ERROR_CREATE";
  6. A continuación, elimine todo el código posterior a la última llave de cierre } y ponga en su lugar este texto: return "MAIN";

    Este paso elimina la acción gotoPage añadida en el ejercicio 1.4. Ya no necesita este código porque las reglas de navegación hacen lo mismo.

    El código del botón debería tener ahora el aspecto siguiente:

    Vista Edición rápida.

  7. Guarde la página y, si quiere ver el resultado, pruébela.
También puede crear una página de error sencilla denominada create_error.jsp que explique al usuario que se ha producido un error en la creación del listado y que intente entrar un valor distinto para el ID. Podrá entonces probar estas reglas de navegación intentando añadir un listado nuevo que utilice un valor de ID existente (como por ejemplo 1).

Punto de comprobación de lección

Ha terminado la Lección 2.3. En esta lección ha aprendido a utilizar las reglas de navegación para crear un error si un usuario intenta entrar un valor de ID no válido o a enviar al usuario a all_recordlist.jsp si el usuario especifica un ID válido.

< Anterior | Siguiente >