Afficher des informations dynamiques sur les pages Web à l'aide de composants JSF > Module 2 : Ajouter des fonctions avancées >
< Précédent | Suivant >

Leçon 2.3 : Utiliser des règles de navigation

Dans cette leçon, vous allez apprendre à définir des règles de navigation pour rediriger un utilisateur du site vers des pages Web spécifiques.

Pour l'instant, la page new_record.jsp est conçue de manière telle que l'utilisateur doit entrer lui-même un ID lorsqu'il crée une nouvelle annonce. Or, comme nous l'avons vu dans la remarque "Eviter les clés en double" de la Leçon 1.5 : Programmer le bouton de soumission du formulaire, chaque enregistrement stocké dans la base de données doit avoir un ID différent. Dans la présente leçon, vous allez créer un mécanisme qui vérifiera si l'ID spécifié est unique et, dans la négative, dirigera l'utilisateur vers une page d'erreur décrivant le problème et comment y remédier.

Les règles de navigation que vous allez définir aiguilleront l'utilisateur vers la page all_records.jsp ou vers une page d'erreur, selon que l'ID spécifié est unique ou en double. Vous affecterez des alias à ces deux résultats possibles et associerez ensuite ces alias aux pages cible correctes. Dans cet exemple, une erreur sur la page create_record.jsp activera l'alias ERROR_CREATE, qui dirigera l'utilisateur vers la page d'erreur. Si l'utilisateur renseigne correctement la page create_record.jsp, l'alias MAIN sera activé et l'utilisateur sera alors dirigé normalement vers la page all_records.jsp.

Définir les règles

  1. Faites un double clic sur la page new_record.jsp dans l'Explorateur de projets.
  2. Cliquez sur le bouton Post New Listing de la page.
  3. Dans la vue Propriétés, cliquez sur Ajouter une règle. La fenêtre Ajout d'une règle de navigation s'ouvre. La première règle dirigera l'utilisateur vers une page d'erreur nommée create_error.jsp si un problème survient lors de la création et de la validation du nouvel enregistrement dans la base de données.
  4. Dans la zone Page, tapez error_create.jsp. Cette page n'existe pas, mais pour les besoins de ce tutoriel, faisons comme si elle existait.
  5. Sélectionnez l'option Le résultat intitulé.
  6. Tapez ERROR_CREATE dans la zone de texte à droite de l'option Le résultat intitulé.
  7. Sélectionnez l'option A cette page uniquement. En effet, le site ne comporte pas d'autre page sur laquelle l'utilisateur pourrait provoquer cette erreur particulière en entrant un ID en double. Cliquez sur OK. L'autre règle que vous allez maintenant créer redirigera l'utilisateur vers la page all_records.jsp s'il a spécifié un ID valide.
  8. Cliquez à nouveau sur le bouton Ajouter une règle pour rouvrir la fenêtre Ajout d'une règle de navigation.
  9. Sélectionnez all_records.jsp dans la liste Page.
  10. Sélectionnez l'option Le résultat intitulé et tapez MAIN dans la zone correspondante.
  11. Comme vous êtes susceptible de réutiliser cette règle sur une autre page (par exemple, update_record.jsp), sélectionnez l'option Toutes les pages sous la rubrique Cette règle est utilisée pour. Cliquez sur OK. Les deux règles apparaissent maintenant dans la vue Propriétés.

Renvoyer les alias à partir du code d'action du bouton

Les nouvelles règles de navigation étant définie, il ne vous reste plus qu'à les mettre en pratique. Vous allez pour cela ajouter deux instructions return dans le code du bouton Post New Listing. Elles renverront l'alias approprié afin que l'utilisateur soit dirigé vers la page appropriée conformément à la règle de navigation.
  1. Cliquez sur le bouton Post New Listing.
  2. Ouvrez la vue Edition rapide.
  3. Dans la vue Edition rapide, localisez la ligne } catch (Throwable e) {. Cette fonction catch est exécutée si l'utilisateur a entré un ID en double.
  4. Supprimez tout le code situé entre l'accolade ouvrante { à la fin de cette ligne et l'accolade fermante } suivante, quelques lignes plus bas. Ne supprimez pas les accolades elles-mêmes.
  5. Tapez l'instruction suivante à la place du code entre accolades : return "ERROR_CREATE";
  6. Supprimez maintenant tout le code situé après la dernière accolade fermante et tapez à la place l'instruction return "MAIN";

    Cette étape supprime l'action gotoPage que vous avez ajoutée au cours de l'exercice 1.4. Ce code n'est plus nécessaire car les règles de navigation remplissent la même fonction.

    Le code du bouton doit maintenant se présenter comme suit :

    Vue Edition rapide

  7. Enregistrez la page et testez-la si vous le souhaitez.
En option, vous pouvez créer une page d'erreur simple, appelée create_error.jsp, expliquant à l'utilisateur qu'une erreur s'est produite lors de la création de son annonce et l'invitant à entrer un ID différent. Vous pouvez ensuite tester ces règles de navigation en essayant d'ajouter une nouvelle annonce avec un ID existant (tel que 1).

Etat des connaissances

Vous avez terminé la leçon 2.3. Vous avez appris à créer des règles de navigation orientant l'utilisateur vers une page d'erreur s'il entre un ID non valide ou le faisant retourner à la page all_records.jsp s'il entre un ID valide.

< Précédent | Suivant >