Wicket est un framework novateur en fournissant une navigation de page entièrement en langage Java. Il s’agit d’une d’approche différente des framewoks classiques comme Struts qui fournissent des fichiers XML de mapping URL/Classe d’action.

En réponse à des événements de type onClick() ou onSubmit(), Wicket traite l’événement côté serveur et spécifie la page de l’application Wicket en retour. Cette redirection est basée sur la méthode "setResponsePage()", définit dans la classe "org.apache.wicket.Component". Tous les composants Wicket (Form, Link, …) étendent cette classe et c’est pourquoi cette méthode est toujours disponible. En réalité, nous utilisons la méthode setResponsePage() uniquement quand nous souhaitons naviguer vers une autre page que la page courante.

Quelques détails sous le capot

Côté serveur une requête est traitée en deux phases

• Phase de l'appel du listener de la requête pour traiter la requête
• Phase du render qui renvoie la réponse vers la page courante, vers une nouvelle page, vers une image, vers un document PDF, …

C’est durant la première phase de traitement qu’il est nécessaire de spécifier à Wicket sur quelle page sera retournée la réponse. Et si aucune réponse n’est spécifiée, Wicket renvoie versla page courante.

Il existe deux types de méthodes setReponsePage

1. La première utilisation crée une instance de la page de retour
2. La deuxième instrumente Wicket pour créer la page et générer une URL bookmarkable

Première forme

La signature de la méthode utilisée est "setResponsePage(final Page page)".

Link linkMesContatcs= new Link("contactlink"){
      public void onClick(){
         setResponsePage(new ListContactPage());
      }
   };
linkMesContatcs.add(new Label("labelLink", "Mes contacts"));
add(linkMesContatcs);

Nous obtenons une url générée comme ceci

http://localhost:8080/zencontact/?wicket:interface=:3::::

Cette URL est complètement relative à la session utilisateur. Et elle ne contient aucune information sur la page sélectionnée. Plus précisément, l’état de la page est stocké en session côté serveur. Elle ne peut donc pas être partagée entre plusieurs utilisateurs ou être mise dans les favoris. Nous dirons donc qu’elle n’est pas "bookmarkable".

Si nous avions voulu passer des paramètres, ceux-ci auraient été passés au constructeur de l’objet de la page.

Deuxième forme

Dans cette deuxième forme, deux signatures de la méthode sont disponibles

• setResponsePage(final Class cls)
• setResponsePage(final Class cls, PageParameters parameters)

Avec cette utilisation, à la réception par le navigateur de la redirection, celui-ci va soumettre une requête sur la page. Wicket créera alors une classe de la page.

Link linkMesContatcs= new Link("contactlink"){
  public void onClick(){
     setResponsePage(ListContactPage.class);
  }
};
linkMesContatcs.add(new Label("labelLink", "Mes contacts"));
add(linkMesContatcs);

Voici l’url générée

http://localhost:8080/zencontact/?wicket:bookmarkablePage=:com.zenika.wicket.ui.ListContactPage

Nous avons une URL indépendante de l’utilisateur et bookmarkable.

Note: des mécanismes existes pour personnaliser l’url.

Néanmoins, cette forme est peu employée. A la pace, il est couramment utiliser un BookmarkablePageLink

BookmarkablePageLink pageLink = new  BookmarkablePageLink("contactlink", ListContactPage.class);
pageLink.add(new Label("labelLink", "Mes contacts"));
add(pageLink);

Voici l’url générée identique au cas précédent

http://localhost:8080/zencontact/?wicket:bookmarkablePage=:com.zenika.wicket.ui.ListContactPage