Avant de parler variable, revenons sur leur portée ! La portée (ou visibilité) d'une variable correspond concrètement à l'endroit dans lequel elle est stockée, et par corolaire aux endroits depuis lesquels elle est accessible. Selon la portée affectée à votre variable, elle sera par exemple accessible depuis toute votre application, ou seulement depuis une page particulière, etc. Il y a quatre portées différentes (ou scopes en anglais), que vous connaissez déjà et redécouvrirez au fur et à mesure des exemples de ce chapitre :
la page : les objets créés avec la portée page ne sont accessibles que depuis cette même page, et une fois la réponse retournée au navigateur ces données ne sont plus accessibles.
la requête : les objets créés avec la portée request ne sont accessibles que depuis les pages qui traitent cette même requête. Si la requête est transmise à une autre page, les données sont conservées, mais sont perdues en cas de redirection.
la session : les objets créés avec la portée session ne sont accessibles que depuis les pages traitant les requêtes créées dans cette même session. Concrètement, une session correspond à la durée pendant laquelle un visiteur va utiliser l'application, cette durée se terminant lorsque l'utilisateur ferme son navigateur ou encore lorsque l'application le décide (le développeur, pour être exact), par exemple via un lien de déconnexion ou encore un temps maximum de validité imposé après lequel la session sera automatiquement détruite. Les données ainsi créées ne sont plus accessibles une fois que le visiteur quitte le site.
l'application : les objets créés avec la portée application sont accessibles depuis toutes les pages JSP de l'application web ! C'est en quelque sorte une variable globale, accessible partout.
Création
La balise utilisée pour la création d'une variable est <c:set />. Abordons pour commencer la mise en place d'un attribut dans la requête. En JSP/servlets, vous savez tous faire ça, mais qu'en est-il avec la JSTL ? Il suffit d'utiliser les trois attributs suivants : var, value et scope.
Code : JSP
<%-- Cette balise met l'expression "Salut les zéros !" dans l'attribut "welcomeMessage" de la requête : --%>
<c:set var="welcomeMessage" value="Salut les zéros !"
scope="request" />
<%-- Et est l'équivalent du scriplet Java suivant : --%>
<% request.setAttribute( "welcomeMessage", "Salut les zéros !" ); %>
L'attribut var contient le nom de la variable que l'on veut stocker, value sa valeur, et scope la portée de cette variable. Simple, rapide et efficace ! Voyons maintenant comment récupérer cette valeur pour l'afficher à l'utilisateur, par exemple :
Code : JSP
<%-- Affiche l'expression contenue dans la variable "welcomeMessage" de la requête --%>
<c:out value="${requestScope.welcomeMessage}" />
Vous remarquerez que nous utilisons ici dans l'EL l'objet implicite requestScope, qui permet de rechercher un objet dans la portée requête uniquement. Les plus avertis d'entre vous ont peut-être tenté d'accéder à la valeur fraîchement créée via un simple <c:out value="${ welcomeMessage }"/>. Et effectivement, dans ce cas cela fonctionne également. Pourquoi ?
Nous retrouvons ici une illustration du mécanisme dont je vous ai parlé lorsque nous avons appliqué les EL dans notre code d'exemple : par défaut, si le terme de l'expression n'est ni un type primitif (int, char, boolean, etc.) ni un objet implicite de la technologie EL, l'expression va d'elle-même chercher un attribut correspondant à ce terme dans les différentes portées de votre application : page, puis request, puis session et enfin application.
Souvenez-vous, je vous avais expliqué que c'est grâce à l'objet implicite pageContext que le mécanisme parcourt toutes les portées, et qu'il renvoie alors automatiquement le premier objet trouvé lors de son parcours. Voilà donc pourquoi cela fonctionne avec la seconde écriture : puisque nous ne précisons pas de portée, l'expression EL les parcourt automatiquement une par une jusqu'à ce qu'elle trouve un objet nommé welcomeMessage, et nous le renvoie !
N'oubliez pas : la bonne pratique veut que vous ne donniez pas le même nom à deux variables différentes, présentes dans des portées différentes. Toutefois, afin d'éviter toute confusion si jamais des variables aux noms identiques venaient à coexister, il est également conseillé de n'utiliser la seconde écriture que lorsque que vous souhaitez faire référence à des attributs de portée page, et d'utiliser la première écriture que je vous ai présentée pour le reste (session, request et application).
Modification
"maVariable" si elle n'existe pas déjà, et initialisera son contenu à "12" : Code : JSP
<%-- L'attribut scope n'est pas obligatoire. Rappelez-vous, le scope par défaut est dans ce cas la page,
puisque c'est le premier dans la liste des scopes parcourus --%> <c:set var="maVariable" value="12" />
Pour information, il est également possible d'initialiser une variable en utilisant le corps de la balise, plutôt qu'en utilisant l'attribut value :
Code : JSP
<c:set var="maVariable"> 12 </c:set>
À ce sujet, sachez d'ailleurs qu'il est possible d'imbriquer d'autres balises dans le corps de cette balise, et pas seulement d'utiliser de simples chaînes de caractères ou expressions. Voici par exemple comment vous pourriez initialiser la valeur d'une variable de session depuis une valeur lue dans un paramètre de l'URL :
Code : JSP
<c:set var="locale" scope="session">
<c:out value="${param.lang}" default="FR"/> </c:set>
Plusieurs points importants ici :
vous constatez bien ici l'utilisation de la balise <c:out/> à l'intérieur du corps de la balise <c:set/>.
vous pouvez remarquer l'utilisation de l'objet implicite param, pour récupérer la valeur du paramètre de la requête nommé lang ;
si le paramètre lang n'existe pas ou s'il est vide, c'est la valeur par défaut "FR" spécifiée dans notre balise <c:out/> qui sera utilisée pour initialiser notre variable en session.