JSP 2

Java pour le dveloppement dapplications Web : Java EE
JSP 2.0
Mickal BARON - 2006 (Rev. Aot 2009) mailto:baron.mickael@gmail.com ou mailto:baron@ensma.fr
Licence
Creative Commons
Contrat Paternit Partage des Conditions Initiales l'Identique
2.0 France
keulkeul.blogspot.com
http://creativecommons.org/licenses/by-sa/2.0/fr
JSP2 - M. Baron - Page 2
Conception dun tag personnalis (2.0) volutions vers la 2.0 depuis la 1.2
Descripteur de balises personnalises (TLD) Implmentation diffrente pour le handler des balises personnalises
Les principales classes des balises personnalises

SimpleTag qui est linterface de base pour crire un tag
Le traitement du corps se fait par la mme interface
TagExtraInfo apporte des informations complmentaires sur les tags

Besoins de conception de deux familles dlment

La classe handler qui implmente linterface SimpleTag Le descripteur de la bibliothque de tag (*.tld)
Peu de modification depuis la version 1.2
Conception dun tag personnalis (2.0) : SimpleTag Linterface SimpleTag permet une implmentation diffrente de tag JSP ralise partir de La classe TagExtraInfo ne
TagSupport BodyTagSupport
change pas. Cependant, nous tudierons les mmes exemples mais avec SimpleTag
Les classes des balises personnalises concernes (version 2)

SimpleTag qui est linterface de base pour crire une balise
personnalise
SimpleTagSupport qui est la classe dimplmentation par dfaut de SimpleTag
Prsentation avec linterface SimpleTag

Reprise du mme plan quavec TagSupport et BodyTagSupport Le fichier de description des balises (TLD) volue lgrement
Conception dun tag personnalis par lexemple (2.0) Exemple : HelloWorld un classique
package monpackage; ... public class HelloTag extends SimpleTagSupport { public void doTag() throws JspException, IOException { this.getJspContext().getOut().println("Hello World !"); } }
La classe handler
<?xml version="1.0" encoding="ISO-8859-1" ?> <taglib ...> <tlib-version>1.0</tlib-version> <jsp-version>2.0</jsp-version> <description> Bibliothque de taglibs </description> <tag> <name>hellotag</name> <tag-class>monpackage.HelloTag</tag-class> <description> Tag qui affiche bonjour </description> <body-content>empty</body-content> </tag> </taglib>
Le fichier TLD
Conception dun tag personnalis par lexemple (2.0) Exemple (suite) : HelloWorld un classique
<?xml version="1.0" encoding="UTF-8"?> <web-app ...> <display-name>Permet de grer des Tags personnaliss</displayname> <taglib> <taglib-uri>monTag</taglib-uri> <taglib-location>/WEB-INF/tld/montaglib.tld</taglib-location> </taglib> </web-app>
Le fichier de description du projet
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:hellotag /> Tout le monde
La JSP avec le nouveau Tag
Le rsultat final !!!

Conception dun tag personnalis (2.0) : interface Tag Chaque balise est associe une classe qui va contenir les traitements excuter lors de leur utilisation Lutilisation de cette classe impose dimplmenter linterface
SimpleTag
Prfrez la classe SimpleTagSupport qui implmente directement SimpleTag
SimpleTag << Interface >>
+ doTag() ... keulkeul.blogspot.com
Une classe handler par tag personnalis et pas une de plus !!!
SimpleTagSupport
# getJspContext() : JspContext # getJspBody() : JspFragment + getParent() : JspTag ...
Avec la version 2, le corps de la balise personnalise est trait dans une mme classe
Conception dun tag personnalis (2.0) : cycle de vie Lvaluation dun tag JSP aboutit aux appels suivants
Initialisation de proprits (JspContext, parent) Initialisation des attributs sils existent Si la balise possde un corps non vide, initialisation de JspFragment La mthode doTag() est appele
La version 2.0 supprime les mthodes doStartTag(), doInitBody(), doAfterBody(), doEndTag() qui taient prsente dans la version 1.2
SimpleTagSupport
+ doTag() # getJspBody() : JspFragment # getJspContext() : JspContext + getParent() : JspTag ...
Conception dun tag personnalis (2.0) : TLD Le fichier de description de la bibliothque de tags dcrit une bibliothque de balises Les informations quil contient concerne la bibliothque de tags et concerne galement chacune des balises qui la compose Doit toujours avoir lextension .tld Le format des descripteurs de balises personnalises est dfini par un fichier XSD (XML Schema Description) En-tte du fichier TLD. Balise ouvrante <taglib ...>
<?xml version="1.0" encoding="ISO-8859-1" ?> <taglib xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd" version="2.0"> ... </taglib>
Dfini par un fichier XSD
Conception dun tag personnalis (2.0) : TLD La premire partie du document TLD concerne la bibliothque
<tlib-version> : version de la bibliothque (obligatoire) <jsp-version> : version des spcifications JSP (obligatoire) <short-name> : nom de la bibliothque (obligatoire) <description> : description de la bibliothque (optionnelle) <tag> : il en faut autant que de balises qui composent la bibliothque
<?xml version="1.0" encoding="ISO-8859-1" ?> <taglib ...> <tlib-version>1.0</tlib-version> <jsp-version>2.0</jsp-version> <description>Bibliothque de taglibs</description> <short-name>TagLibTest</short-name> <tag> ... </tag> <tag> Seconde balise ... </tag> personnalise </taglib>
Premire balise personnalise
Conception dun tag personnalis (2.0) : TLD Chaque balise personnalise est dfinie dans la balise <tag> La balise <tag> peut contenir les balises suivantes
<name> : nom du tag, doit tre unique (obligatoire) <tag-class> : nom de la classe du handler du tag (obligatoire) <body-content> : type du corps du tag (obligatoire)
tagdependent : linterprtation du corps est faite par le tag empty : le corps doit obligatoirement tre vide scriptless : expressions EL mais pas de code JSP
<attribute> : dcrit les attributs. Autant quil y a dattributs

<tag> <name>hellotag</name> <tag-class>monpackage.HelloTag</tag-class> <description>Tag qui affiche bonjour</description> <body-content>empty</body-content> </tag> </taglib>
Chaque tag personnalis est dfini dans une balise <tag>

Conception dun tag personnalis (2.0) : attributs de tag Un tag peut contenir des attributs
<prefixe:nomDuTag attribut1="valeur" />
Tag sans corps avec un attribut appel attribut1
La classe handler doit dfinir des modifieurs et des attributs pour chaque attribut du tag
Les attributs ne sont pas obligatoirement de type chanes de caractres
Les modifieurs doivent suivre une logique dcriture identique celle lie aux Java Beans
public class NomDuTag extends SimpleTagSupport { private Object attribut1; public void setAttribut1(Object p_attribut) { this.attribut1 = p_attribut; } ... }
Des modifieurs prdfinis sont utiliss pour initialiser des proprits du tag (jspContext, parent et jspBody)
setJspContext(JspContext) setParent(Tag) et setJspBody(JspFragment)
Conception dun tag personnalis (2.0) : attributs de tag Les attributs dune balise personnalise doivent tre dclars dans le fichier TLD Chaque attribut est dfini dans une balise <attribut> qui sont contenus dans la balise mre <tag> La balise <attribute> peut contenir les tags suivants :
<name> : nom de lattribut utilis dans les JSP (obligatoire) <required> : indique si lattribut est requis (true/false ou yes/no) <rtexprvalue> : prcise si lattribut peut contenir le rsultat dun tag
expression
<type> : indique le type Java de lattribut (dfaut : java.lang.String)

<attribute> <name>moment</name> <required>false</required> <rtexprvalue>false</rtexprvalue> <type>java.lang.String</type> </attribute>
Conception dun tag personnalis (2.0) : attributs de tag Exemple 1 : HelloWorld avec des attributs
package monpackage; ... public class HelloTagAttributs extends SimpleTagSupport { private String moment; public void setMoment(String p_moment) { this.moment = p_moment; } public int doTag() throws JspException, IOException { getJspContext().getOut().println ("Hello World ! " + moment); } }
Nouvelle classe pour ce nouveau tag de la mme bibliothque
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:hellotag/> Tout le monde <montagamoi:hellotagattributs moment=" toi"/>
Ajout dun attribut au tag
Conception dun tag personnalis (2.0) : attributs de tag Exemple 1 (suite) : HelloWorld avec des attributs
<?xml version="1.0" encoding="ISO-8859-1" ?> <taglib ...> <tlibversion>1.0</tlibversion> <jspversion>2.0</jspversion> <info>Bibliothque de test des taglibs</info> <tag> <name>hellotag</name> <tag-class>monpackage.HelloTag</tag-class> <description>Tag qui affiche bonjour</description> <body-content>empty</body-content> </tag> <tag> <name>hellotagattributs</name> <tag-class>monpackage.HelloTagAttributs</tag-class> <description>Bonjour et un attribut</description> <attribute> <name>moment</name> <required>false</required> <rtexprvalue>false</rtexprvalue> </attribute> <body-content>empty</body-content> </tag> </taglib>
Deux tags sont dfinis dans cette bibliothque
Un seul attribut est dfini
Conception dun tag personnalis (2.0) : attributs de tag Exemple 1 (suite bis) : omission dun attribut obligatoire ...
<tag> ... <attribute> <name>moment</name> <required>true</required> <rtexprvalue>false</rtexprvalue> </attribute> </tag> <%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:hellotag/> Tout le monde <montagamoi:hellotagattributs />
Utilisation dans une JSP dun tag avec attribut obligatoire
Une exception se lve quand un attribut obligatoire est omis

Conception dun tag personnalis (2.0) : attributs de tag Exemple 2 : valuation corps et arrt de lvaluation de la page
public class ExplainWorkingTag extends SimpleTagSupport { private String test; private String apoca; public void setTest(String param) { test = param; } public void setApoca(String param) { apoca = param; }
Affiche le contenu du corps. tudi dans la suite Peut-tre quivalent EVAL_BODY_INCLUDE de la version 1.2
public void doTag() throws JspException, IOException { if (test.equals("body")) { <%@ taglib uri="monTag" prefix="montagamoi" %> this.getJspBody().invoke(null); } else { <montagamoi:explainworkingtag test="body" apoca="fin"> if (apoca.equals("fin")) { Le texte doit normalement s'afficher!!! // Ne rien faire </montagamoi:explainworkingtag> } else { throw new SkipPageException(); <montagamoi:explainworkingtag test="autre" apoca="fin"> } Le texte ne doit pas s'afficher!!! } </montagamoi:explainworkingtag> } }
<montagamoi:explainworkingtag test="autre" apoca="autre"> Le texte ne doit pas s'afficher!!! </montagamoi:explainworkingtag> Le reste de la page ne doit pas tre vu.
Conception dun tag personnalis (2.0) : attributs de tag Exemple 3 : valuation de code JSP depuis un attribut
<attribute> <name>value</name> <required>true</required> public class EvalExpressionAttribut extends SimpleTagSupport { <rtexprvalue>true</rtexprvalue> private Object value; </attribute>
public void setValue(Object p_value) { value = p_value; }
public void doTag() throws JspException, IOException { if (value instanceof Date) { this.getJspContext().getOut().println((Date)value); } else { this.getJspContext().getOut().println("N'est pas un objet Date"); } } }
Lattribut peut recevoir une expression JSP
<%@ taglib uri="monTag" prefix="montagamoi" %>
<montagamoi:evalexpressattribut value="<%= new java.util.Date() %>" />
Un objet autre que String peut-tre envoy

Conception dun tag personnalis (2.0) : variables implicites Les balises personnalises ont accs aux variables implicites de la JSP dans laquelle elles sexcutent via un objet de type JspContext Utilisation de la mthode JspContext getJspContext() La classe JspContext dfinit plusieurs mthodes
JspWriter getOut() : accs la variable out de la JSP Object getAttribute(String) : retourne un objet associ au paramtre (scope page) Object getAttribute(String, int) : retourne objet avec un scope prcis setAttribute(String, Object) : associe un nom un objet (scope page) setAttribute(String, Object, int) : associe un nom un objet avec un
scope
Object findAttribute(String) : cherche lattribut dans les diffrents

scopes
removeAttribute(String) : supprime un attribut, ...
Conception dun tag personnalis (2.0) : variables implicites Les valeurs du scope sont dfinies dans PageContext
PAGE_SCOPE : attribut dans le scope page REQUEST_SCOPE : attribut dans le scope request SESSION_SCOPE : attribut dans le scope session APPLICATION_SCOPE : attribut dans le scope application
Exemples dutilisation des mthodes de PageContext

getJspContext().setAttribute("toto", new Date(), PageContext.PAGE_SCOPE);
Cration d un attribut toto avec la valeur dune Date dans le scope page
getJspContext().findAttribute("toto");
Cette mthode cherche lattribut toto dans tous les scopes en commenant par page, request, session et
application
getJspContext().getAttribute("toto", PageContext.PAGE_SCOPE);
Rcupre lattribut toto dans le scope page
Conception dun tag personnalis (2.0) : variables implicites Possibilit de rcuprer la valeur dun attribut selon son scope et ainsi de communiquer entre une JSP un tag et une Servlet
Communication entre JSP et le handler du tag Communications htrognes Attribut selon la valeur du scope Attribut avec scope application Partage de contrle (inclusion et renvoie)
@ tag:amoi @ tag:amoi
JSP 11 JSP
Scope = page
@ tag:amoi @ tag:amoi
JSP 22 JSP
Scope = page
Une application WEB
Servlet 11 Servlet Servlet 22 Servlet

ServletContext (scope = application)
Conception dun tag personnalis (2.0) : variables implicites Exemple 1 : communication entre Bean et Taglib
<jsp:useBean id="mon_bean" class="java.util.ArrayList" scope="application" /> <%@ taglib uri="monTag" prefix="montagamoi" %> <% mon_bean.add(new java.util.Date()); %> <montagamoi:hellotagarraylist name="mon_bean" /> public class HelloTagArrayList extends SimpleTagSupport { private String mon_bean; public void setName(String p_bean) { this.mon_bean = p_bean; } public void doTag() throws JspException, IOException { Object my_object = findAttribute(mon_bean); if (my_object != null ) { ArrayList my_array_list = (ArrayList)my_object; for (int i = 0; i < my_array_list.size(); i++) { getJspContext().getOut().println(my_array_list.get(i)); } } else { getJspContext().getOut().println("Y a rien"); } } }
Dfinition dun Java Bean dans le contexte de lapplication WEB Lattribut name permet dindiquer lidentifiant du Bean Sachant que linstance du Java Bean est dfini dans le scope application
Conception dun tag personnalis (2.0) : variables implicites Exemple 1 (suite) : plusieurs solutions pour y arriver ...
<jsp:useBean id="mon_bean" class="java.util.ArrayList" scope="application" /> <%@ taglib uri="monTag" prefix="montagamoi" %> <% mon_bean.add(new java.util.Date()); %> <montagamoi:hellotagarraylist name=<%= mon_bean %> />
public class HelloTagArrayList2 extends TagSupport { valuation private Object bean; public void setBean(Object my_bean) { dexpression JSP this.bean = my_bean; } public void doTag() throws JspException, IOException { if (bean instanceof ArrayList) { if (bean != null ) { ArrayList my_array_list = (ArrayList)bean; for (int i = 0; i < my_array_list.size(); i++) { getJspContext().getOut().println(my_array_list.get(i)); } } else { getJspContext().getOut().println("Y a rien"); } } } Prfrez cette solution la }
Il faut sassurer que lobjet envoy en attribut est du type ArrayList
premire, elle est moins dpendante que la premire version
Conception dun tag personnalis (2.0) : variables implicites Exemple 2 : collaboration de taglib switch case
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:switchtag test="3"> <montagamoi:casetag value="0">Zro</montagamoi:casetag> <montagamoi:casetag value="1">Un</montagamoi:casetag> <montagamoi:casetag value="2">Deux</montagamoi:casetag> <montagamoi:casetag value="3">Trois</montagamoi:casetag> </montagamoi:switchtag>
Simulation de switch case par lintermdiaire de balises
Le corps du tag est valu

public class SwitchTag extends SimpleTagSupport { private String test; public void doTag() throws JspException, IOException { getJspBody().invoke(null); } public void setTest(String p_value) { test = p_value; } public boolean isValid(String caseValue) { if (test == null) return false; return(test.equals(caseValue)); }
Initialise lattribut test
Vrifie que test est le mme que celui du tag enfant
Conception dun tag personnalis (2.0) : variables implicites Exemple 2 (suite) : collaboration de balises personnalises ...
public class CaseTag extends TagSupport { public String value; public void setValue(String p_value) { this.value = p_value; }
Vrifie que test du tag parent est le mme que value du tag enfant
public void doTag() throws JspException, IOException { if (getParent() instanceof SwitchTag) { SwitchTag parent = (SwitchTag)getParent(); if (parent.isValid(this.value)) { this.getJspBody().invoke(null); Affiche ou non le corps } la balise enfant } else { throw new JspException("Case doit tre l'intrieur du tag Switch"); } } }
de
Conception dun tag personnalis (2.0) : corps du Tag La mthode doTag() traite son corps via lobjet JspFragment renseign par le serveur dapplication Utilisation de la mthode JspFragment getJspBody() permettant de rcuprer lobjet JspFragment Lobjet JspFragment peut tre valu autant de fois que ncessaire grce la mthode invoke(Writer) qui crit le rsultat dans le Writer spcifi Un Writer peut tre de diffrents types
StringWriter : flux de chanes de caractres OutputStreamWriter PrintWriter

...
Le corps dune balise personnalise ne supporte pas de code scriptlet JSP <% %>
Conception dun tag personnalis (2.0) : corps du Tag A la diffrence de la version 1.2, limplmentation par SimpleTag permet de buffriser le traitement du corps dans un seul appel de la mthode doTag() Plusieurs manires existent pour retourner uniquement le contenu du corps
Utilisation dun Writer null
getJspBody().invoke(null)
Cette criture a dj t aperue dans les exemples prcdents
Utilisation dun Writer de type StringWriter

Cration dun Writer de chanes de caractres
Place le contenu du corps dans le
StringWriter mon_buffer = new StringWriter(); getJspBody().invoke(mon_buffer); getJspContext().getOut().println(mon_buffer);
Writer
Affiche le contenu du Writer dans la rponse
Conception dun tag personnalis (2.0) : itration sur le corps Exemple : itration sur le corps du tag ...
public class IterateSimpleTag extends BodyTagSupport { private int count = 0; public void setCount(int i) { count = i; }
A chaque itration le contenu du corps est crit dans la page JSP
public void doTag() throws JspException, IOException { for (int i = 0; i < count; i++) { getJspBody().invoke(null); } } <%@ taglib uri="monTag" prefix="montagamoi" %> }
<montagamoi:iteratesimpletag count="3"> Coucou </montagamoi:iteratesimpletag>
criture plus simple que limplmentation fournie par
BodyTagSupport
Conception dun tag personnalis (2.0) : itration sur le corps Exemple (bis) : itration sur le corps du tag avec modification
public class IterateSimpleTag extends BodyTagSupport { private int count = 0; public void setCount(int i) { if (i <= 0) { i = 1; Utilisation dun Writer } type StringWriter count = i; }
de
public void doTag() throws JspException, IOException { StringWriter mon_writer = new StringWriter(); this.getJspBody().invoke(mon_writer); String contenu = mon_writer.toString();
Rcupre le contenu du corps
for (int i = 0; i < count - 1 ; i++) { mon_writer.append(contenu); Ajoute le contenu du } mon_writer.append(String.valueOf(count)); corps count - 1 fois getJspContext().getOut().println(mon_writer); } } <%@ taglib uri="monTag" prefix="montagamoi" %>
Affiche le rsultat buffris sur la page JSP
<montagamoi:iteratetag count="3"> Coucou </montagamoi:iteratetag>
Conception dun tag personnalis (2.0) : itration sur le corps Exemple (bis) : itration sur le corps du tag avec modification
public class UpperCaseTag extends SimpleTagSupport { public void doTag() throws JspException, IOException { StringWriter mon_writer = new StringWriter(); Le contenu du Writer est getJspBody().invoke(mon_writer); rcupr puis modifi en String ma_chaine = mon_writer.toString();
majuscule
getJspContext().getOut().println(ma_chaine.toUpperCase()); } }
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:uppercasetag> Bonjour, je suis en minuscule et je vais passer en majuscule La date aujourd'hui est <%= new java.util.Date() %> </montagamoi:uppercasetag>
<tag> <name>uppercasetag</name> <tag-class>monpackage.UpperCaseTag</tag-class> <description>Tag qui effectue des modifs sur le corps d'un Tag</description> <body-content>tagdependent</body-content> </tag>
Non valu puisque le code JSP nest plus interprtable dans le corps (2.0) Solution : EL
Expressions Languages (2.0) : justifications ... Lutilisation de linterface SimpleTag de la version 2.0 des JSP ne permet plus dexploiter du code JSP dans le corps des balises personnalises Les raisons
Limiter la prsence du langage Java (non spcialiste) Meilleure lisibilit, le code se limite au nom des beans et de ses proprits
<%= page.getAttribute("personne").getNom() %>
${page["personne"].nom}
Version (Java) avec tag expression et version (EL) de type script
Les Expressions Languages (EL) permettent de manipuler les donnes dune page JSP (essentiellement les Beans) Une EL permet daccder simplement aux beans des diffrents scopes de lapplication (page, request, session et application) JSP2 - M. Baron - Page 31
Expressions Languages (2.0) : Quest ce que cest ... Forme dune Expression Language
${expression}
Une expression correspond lexpression interprter. Elle peut tre compose de plusieurs termes spars par des oprateurs
${terme1 oprateur terme2} ${oprateur-unaire terme} ${terme1 oprateur terme2 oprateur terme3 ...}
Termes peuvent tre

un type primaire un objet implicite un attribut dun scope de lapplication web une fonction EL
Non tudie dans la suite ...
Expressions Languages (2.0) : comment les utiliser ? Par dfaut les expressions EL sont ignores sil ny a pas de fichier web.xml. Utilisation de la directive page pour les activer (false) <%@ page isELIgnored="false" %> Les expressions EL peuvent tre utilises dans
les attributs des tags personnaliss (existants ou les vtres) le corps des tags personnaliss dans la page JSP (hors tags)
${lebeanalui} <prefix:montagamoi param1="toto" param2="${lebeanalui}" > ${lebeanalui} </prefix:montagamoi>
Les types primaires de Java peuvent tre utiliss dans les EL

null : la valeur null java.lang.Long : 17 java.lang.String : ma chane moi java.lang.Boolean : true ou false, ...
Expressions Languages (2.0) : objet implicites Exemple : EL et balise personnalise ...

<%@ page isELIgnored="false" %> <%@ taglib uri="monTag2" prefix="montagamoi" %> <jsp:useBean id="mon_bean" class="java.util.Date" scope="page" /> <montagamoi:uppercasetag> Bonjour, je suis en minuscule et je vais passer en majuscule La date aujourd'hui est ${pageScope["mon_bean"]} </montagamoi:uppercasetag>
<tag> <name>uppercasetag</name> <tag-class>monpackage.UpperCaseTag</tag-class> <description>Tag qui effectue des modifs sur le corps d'un Tag</description> <body-content>scriptless</body-content> </tag>
Le <body-content> peut maintenant tre scriptless puisque le corps contient une EL ...
Expressions Languages (2.0) : objet implicites Les objets implicites permettent daccder aux diffrents lments dune page JSP
pageContext : accs lobjet PageContext (request, response, ) pageScope[""] : accs aux attributs du scope page requestScope[""] : accs aux attributs du scope request sessionScope[""] : accs aux attributs du scope session applicationScope[""] : accs aux attributs du scope application param[""] : accs aux paramtres de la requte HTTP paramValues : paramtres de la requte sous la forme dun tableau String header[""] : accs aux valeurs dun en-tte HTTP headerValues : accs aux en-ttes de la requte sous forme dun tableau String cookie[""] : accs aux diffrents cookies,
Les expressions avec crochets sont tous de type -Map - Page JSP2 M. Baron
35
Expressions Languages (2.0) : objet implicites Lors de lvaluation dun terme, si celui-ci nest ni un type primaire, ni un objet implicite, le conteneur JSP recherchera un attribut du mme nom dans les diffrents scopes (page,
request, )
${nom} Si nom a t dfini dans un scope ces deux expressions font la mme chose
<%= pageContext.findAttribute("name") %>
Linstruction EL est plus simple est moins langage

Cette seconde instruction recherche uniquement lattribut nom dans le scope session . Sil nexiste pas retourne chane vide
${sessionScope["nom"]}
Expressions Languages (2.0) : objet implicites Exemple : lecture dinformations ...

<%@ page isELIgnored="false" %> <% pageContext.setAttribute("mot1", "BONJOUR", PageContext.SESSION_SCOPE); %> <% pageContext.setAttribute("mot2", "AuRevoir", PageContext.APPLICATION_SCOPE); %> PageScope : ${pageScope["mot1"]} ???Scope : ${mot2} ${pageContext.response.contentType} Paramtre "toto" : ${param["toto"]} Paramtre "tutu" : ${param["tutu"]} ${header["user-agent"]} 
Si le paramtre nexiste pas, pas de renvoie dobjet null mais dune chane de caractres vide
Les expressions EL permettent de grer plus facilement les valeurs null
Expressions Languages (2.0) : accs aux proprits des objets Trois catgories dobjets dfinies par les expressions EL
les objets standards (tout autres objets) les objets indexes (tableau Java, ou objet de type List) les objets mapps (objet de type Map)
Les objets sont construits suivant le modle des Beans Laccs se fait par rflexivit, cest--dire quil ny a pas besoin
de connatre le type de lobjet pour accder ses proprits Selon le type dobjet, les rgles daccs ces proprits divergent malgr une syntaxe similaire
Accs aux proprits des objets (2.0) : objets standards Utilisation dun accesseur spcifique portant le nom de la proprit
Laccs la proprit name se fait par laccesseur getName() Cette mthode est recherche puis appele
Prfrez lusage du point afin dviter les confusions avec les autres types dobjets
Deux approches pour accder la proprit

le point le crochet
<% ${ objet.name }
${ objet["name"] }
ou
${ objet[name] }
MonBeanAMoi mon_bean = (MonBeanAMoi)pageContext.findAttribute("name"); if (mon_bean != null) out.println(bean.getName()); %>
Sil nexiste pas daccesseur pour la proprit, une exception sera lance
Le code qui correspond cette criture

Accs aux proprits des objets (2.0) : objets indexes Accder une proprit indexe dun tableau ou une liste Utilisation dun accesseur spcifique portant en paramtre lindice nom de la proprit (mthode get(int) de linterface
List)
Pour accder la proprit, utilisation des crochets
${ ${ ${ ${ ${ ${ objet[0] } objet[1] } objet[5] } objet["2"] } objet["4"] } objet["5"] }
Si lindex nest pas un nombre entier, il est converti mais peut provoquer une exception
Accs aux proprits des objets (2.0) : objets mapps Accder une proprit dun objet mapp. Laccs se fait par une tiquette Utilisation dun accesseur spcifique portant en paramtre une cl permettant daccder la proprit (mthode
get(Object) de linterface Map)

Pour accder la proprit, utilisation des crochets

${ objet["clef1"] } ${ objet["clef2"] } ${ objet["clef4"] }
Expressions Languages (2.0) : oprateurs Il est galement possible dutiliser des oprateurs dans une expression EL Il sagit des mmes oprateurs que ceux du langage Java, mis part que certains possdent un quivalent textuel afin dviter des conflits Les oprateurs soprent sur deux termes et prennent la forme suivante Terme1 operateur Terme2 Oprateurs arithmtiques : +, -, *, /,
Oprateurs relationnels : ==, !=, <, >, <= Oprateurs logiques : &&, ||, ! Autres : ? :, test
Conception dun tag personnalis (2.0) : TagExtraInfo La classe TagExtraInfo permet de fournir des informations supplmentaires sur la balise au moment de la compilation de la JSP Package et classe javax.servlet.jsp.tagext.TagExtraInfo Elle dfinit principalement trois mthodes
TagInfo getTagInfo() : accder aux informations sur le tag contenu
dans le descripteur de taglib (TLD)
VariableInfo[] getVariableInfo(TagData) : permet de mapper des

lments de scopes vers des variables de script dans la page JSP
boolean isValid(TagData) : permet de valider la balise avant mme

que la classe de la balise ( handler ) soit excute
Conception dun tag personnalis (2.0) : variables de script Exemple : cration de variables de script (sans TagExtraInfo)
public class VariableScript extends TagSupport { private String name = null; public void setName(String p_string) { this.name = p_string; } public void doTag() throws JspException, IOException { getJspContext().setAttribute(name, new Date()); getJspBody().invoke(null); } }
Dfinition dun attribut par lintermdiaire de lobjet implicite (scope = page)
jspContext
Utilisation dune expression EL pour accder lattribut (scope = page)
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:variablescript name="value" > ${value} </montagamoi:variablescript> ${value} <%= pageContext.getAttribute("value") %>
Donne le mme rsultat pour une EL et un tag expression
Conception dun tag personnalis (2.0) : variables de script Exemple (bis) : cration de variables de script
public class VariableScript extends TagSupport { private String name = null; public void setName(String p_string) { this.name = p_string; } public void doTag() throws JspException, IOException { getJspContext().setAttribute(name, new Date()); getJspBody().invoke(null); } }
Dfinition dun attribut par lintermdiaire de lobjet implicite (scope = page)
jspContext
Utilisation dune expression EL pour accder lattribut (scope = page) value est ainsi dfinie comme une variable de script
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:variablescript name="value" > ${value} </montagamoi:variablescript> ${value} <%= value %>
A suivre ...
Conception dun tag personnalis (2.0) : TagExtraInfo des attributs vers des variables de script prsent dans la JSP Retourne un objet de type VariableInfo qui doit contenir
le nom de la variable de script le nom du type de la variable un boolen qui indique si la variable doit tre dclare (vraie) ou si on doit rutiliser une variable dj dclare (faux) La zone de porte de la variable
getVariableInfo(TagData) soccupe de mapper les lments
int AT_BEGIN : de la balise ouvrante la fin de la JSP int AT_END : de la balise fermante la fin de la JSP int NESTED : entre les balises ouvrantes et fermantes
<montagamoi ... > corps de la balise </montagamoi>
AT_BEGIN
AT_END
NESTED
Conception dun tag personnalis (2.0) : TagExtraInfo Un objet TagInfo est utilis pour accder aux informations du descripteur de taglib (TLD) Il dfinit plusieurs mthodes
String getTagName() : nom de la balise personnalise TagAttributeInfo[] getAttributes() : information sur les attributs String getInfoString() : information concernant la balise personnalise
... TagAttributeInfo[] tab_attribute = this.getTagInfo().getAttributes(); for (int i = 0; i < tab_attribute.length; i++) { System.out.println(tab_attribute[i].getName()); } ...
Rcupre par lintermdiaire du TagInfo la liste de tous les attributs
Affiche lintgralit des noms des attributs dun tag
Conception dun tag personnalis (2.0) : TagExtraInfo Un objet TagData est utilis pour accder aux valeurs des attributs dune balise personnalise Rappel : cest un objet paramtre qui se trouve dans les mthodes
VariableInfo[] getVariableInfo(TagData) boolean isValid(TagData)
Dfinit plusieurs mthodes

Object getAttribute(String) : la valeur dun attribut setAttribute(String, Object) : modifie la valeur dun attribut
Conception dun tag personnalis (2.0) : variables de script Exemple (bis) : cration de variables de script
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:variablescript name="value" > ${value} </montagamoi:variablescript> ${value} <%= value %>
Dfinition dun attribut dans le scope page
Rcupre lintgralit des attributs du tag
public class VariableScriptInfo extends TagExtraInfo { public VariableInfo[] getVariableInfo(TagData arg0) { VariableInfo[] vi = new VariableInfo[1]; TagAttributeInfo[] tab_attribute = this.getTagInfo().getAttributes(); vi[0] = new VariableInfo( (String)arg0.getAttribute(tab_attribute[0].getName()),
name
"java.util.Date", true, VariableInfo.AT_BEGIN); return vi; } }
value
Dclaration de la variable de script
La variable a une porte complte du dbut jusqu la fin de la page JSP
Type la variable de script

Conception dun tag personnalis (2.0) : TagExtraInfo Il faut dclarer la classe de type TagExtraInfo dans le descripteur de balise personnalise Elle se fait par lintermdiaire de la balise <teiclass>
<tag> <teiclass>package.ClasseTagExtraInfo</teiclass> ... </tag>
Pour finir lexemple de la cration de variables de script

<tag> <name>variablescript</name> <tag-class>monpackage.VariableScript</tag-class> <teiclass>monpackage.VariableScriptInfo</teiclass> <description>Tag qui montre la dclaration d'une variable de script</description> <attribute> Impossibilit dutiliser du code JSP <name>name</name> dans le corps dun tag avec <required>true</required> </attribute> linterface SimpleTag <body-content>scriptless</body-content> </tag>
Conception dun tag personnalis (2.0) : TagExtraInfo Possibilit de valider dynamiquement les attributs de la balise avant quils ne soient excuts Utilisation de la mthode isValid() qui est appele la compilation de la page JSP Elle ne permet pas de vrifier la valeur des attributs dont la valeur est le rsultat dun tag expression <%= object %> ou dune scriplet
Deux intrts
Validation effectue pour tous les tags la compilation Vrification peut tre longue mais faite uniquement laM. Baron - Page compilation JSP2 51
Conception dun tag personnalis (2.0) : TagExtraInfo Exemple : vrification des attributs
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:variablescript name="value" > ... </montagamoi:variablescript>
Lattribut name contient une chane de caractres
public class VariableScriptInfo extends TagExtraInfo { public boolean isValid(TagData arg0) { if (arg0.getAttributeString("name").equals("")) { System.out.println("Problme dans le tag name"); return false; Affichage dans la console } avant lexcution de la return true; } page JSP
<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:variablescript name="<%= 'coucou' %>" > ... </montagamoi:variablescript>
Impossibilit de vrifier le contenu dun tag expression avec TagExtraInfo

Conception dun tag personnalis (2.0) : attributs dynamiques La version 2.0 vient combler un des principaux dfauts des versions prcdentes : la gestion dattributs dynamiques Il est dj possible de rendre un attribut facultatif ou pas mais les attributs doivent obligatoirement
possder une mthode modifieur setAttribut() tre dclarer dans le fichier TLD
Linterface DynamicAttributes rsout ce problme avec la mthode

void setDynamicAttribute(String uri, String localname, Object value) keulkeul.blogspot.com
Espace de nommage de lattribut
Nom de lattribut
Valeur de lattribut
Les attributs dynamiques peuvent tre utiliss conjointement avec des attributs classiques
Conception dun tag personnalis (2.0) : attributs dynamiques Pour utiliser les attributs dynamiques, il faut que la classe handler implmente linterface DynamicAttributes en plus dune des interfaces JspTag (SimpleTag ou Tag) Il faut par ailleurs modifier le fichier de descripteur de balises personnalises
<dynamic-attributes>true</dynamic-attributes>
Exemple complet montrant lintrt des attributs dynamiques

Un tag personnalis remplaant la balise <input> de type text Associ les valeurs des champs avec des beans
<montagamoi:dynamicattribut type="text" name="nomDuBean" value="valeurDuBean" ... />
<input type='text' name='nomDuBean' value='valeurDuBean' ... />
<input> accepte jusqu 12 attributs et 16 attributs dvnements

Sans les attributs dynamiques il faudrait les dfinir dans le TLD et ajouter les modifieurs dans la classe handler JSP2 - M. Baron - Page
54
Attributs dynamiques (2.0) : exemple Exemple : puissances des attributs dynamiques

<%@ taglib uri="monTag2" prefix="montagamoi" %> <jsp:useBean id="input3" scope="page" class="java.util.Date" /> Input 1 : <montagamoi:dynamicat type="text" name="input1" class="green" readonly="true" value="statique" /> Input 2 : <montagamoi:dynamicat type="text" name="input2" class="red" onfocus="methodeJavaScript" /> Input 3 : <montagamoi:dynamicat type="text" name="input3" class="blue" /> <tag> <name>dynamicattribut</name> <tag-class>monpackage.InputTag</tag-class> <description>Tag qui montre la dclaration d'une variable de script</description> <attribute> <name>name</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> Deux attributs sont <attribute> obligatoires <name>type</name> <required>true</required> <rtexprvalue>true</rtexprvalue> Un attribut est obligatoire </attribute> <attribute> <name>value</name> <rtexprvalue>true</rtexprvalue> <required>false</required> </attribute> <body-content>scriptless</body-content> <dynamic-attributes>true</dynamic-attributes> </tag>
La page JSP
La valeur statique et la valeur du Bean
Nous utilisons explicitement des attributs dynamiques
Attributs dynamiques (2.0) : exemple Exemple (suite) : puissances des attributs dynamiques
Input 1 : <input type='text' name='input1' value='statique' readonly='true' class='green' /> Input 2 : <input type='text' name='input2' value='' class='red' onfocus='methodeJavaScript' /> Input 3 : <input type='text' name='input3' value='Wed Jul 13 14:57:44 CEST 2005' class='blue' /> 
public class private private private private
InputTag extends SimpleTagSupport implements DynamicAttributes { Map attributes = new HashMap(); String type = null; String name = null; String value = null;
Le source html aprs gnration
public void setDynamicAttribute(String uri, String localname, Object value) throws JspException { attributes.put(localname, value); } public void setName(String name) { this.name = name; }
La mthode qui permet de grer dynamiquement les attributs
public void setType(String type) { this.type = type; } public void setValue(String value) { this.value = value; } ...
Les modifieurs des attributs statiques
Attributs dynamiques (2.0) : exemple Exemple (suite) : puissances des attributs dynamiques
Vrifie sil est possible de rcuprer linstance du Bean donne par name et stocke dans value Gre les attributs statiques
... public void doTag() throws JspException, IOException { JspWriter out = getJspContext().getOut(); out.print("<input type='" + type + "' name='" + name + "' "); if (value == null) { Object o = this.getJspContext().findAttribute(name); value = o == null ? "" : o.toString(); } out.print("value='" + value + "' "); Iterator iterator = attributes.entrySet().iterator(); while(iterator.hasNext()) { Map.Entry entry = (Map.Entry)iterator.next(); out.print(entry.getKey() + "='" + entry.getValue() + "' "); } out.print("/>"); } }
Manipulation des attributs dynamiques et mise en forme

Dploiement dans une application WEB Il y a deux types dlments dont il faut sassurer laccs par le conteneur dapplications web (Tomcat en loccurrence)
Les bytecodes des classes handlers des balises personnalises Les fichier de description des bibliothques (TLD)
*.html, *.jsp, ...
WEB-INF
web.xml
Ce rpertoire contient obligatoirement les bytecodes des fichiers handlers
classes
*.class
Ce rpertoire contient lensemble des fichiers de description des bibliothques (TLD)
lib
*.jar, *.class
Les fichiers TLD doivent tre copis dans le rpertoire WEB-INF ou dans un de ces sous rpertoires
tld
*.tld
Dploiement dans une application WEB Possibilit denregistrer les bibliothques dans le fichier de configuration de lapplication web (web.xml) Il faut ajouter dans le fichier web.xml, un tag <taglib> pour chaque bibliothque utilise contenant deux informations
lURI de la bibliothque <taglib-uri> la localisation du fichier de description <taglib-location> relative au rpertoire WEB-INF
... <web-app ...> <display-name> Application WEB qui permet de grer des Tags persos </display-name> <taglib> <taglib-uri>monTag</taglib-uri> <taglib-location>/WEB-INF/tld/montaglib.tld</taglib-location> </taglib> </web-app>
JSTL (Java server page Standard Tag Library) Le but de la JSTL est de simplifier le travail des auteurs de JSP, cest--dire les acteurs responsables de la couche prsentation La JSTL permet de dvelopper des pages JSP en utilisant des balises XML sans connaissances du langage Java Sun a propos une spcification pour la Java Standard Tag Library voir adresse java.sun.com/jsp/jstl
Limplmentation propose vient du projet Jakarta JSTL 1.1 disponible ladresse jakarta.apache.org/taglibs
JSTL : Quest-ce-que cest... Cest un ensemble de balises personnalises qui propose des fonctionnalits souvent rencontres dans les page JSP
Tag de structure (itration, conditionnement) Internationalisation et formatage Excution de requte SQL Utilisation de document XML
Nous ne prsenterons que la partie lie aux structures et linternationalisation
JSTL 1.1 ncessite au minimum un conteneur JSP 2.0

Utilisation conjointe avec les Expressions Languages (EL) Possibilit galement dutiliser des scriplets mais non recommandes
JSTL : la bibliothque Core Cette bibliothque core comporte les actions de base pour la gestion des variables de scope dune application web
Affichage de variable, cration, modification et suppression de variables de scope et de gestion des exceptions Actions conditionnelles et boucles Manipulation dURL et redirection
Utilisation de la bibliothque JSTL:core dans une appli WEB

Copier jstl.jar et standard.jar dans le rpertoire WEB-INF/lib Copier le fichiers c.tld dans un sous rpertoire de WEB-INF Modifier le fichier web.xml de manire enrichir lURI
<taglib> <taglib-uri>cjstl</taglib-uri> <taglib-location>/WEB-INF/tld/c.tld</taglib-location> </taglib>
Dclarer dans la page JSP la balise

<%@ taglib uri="cjstl" prefix= "c" %>
Dans la suite nous utiliserons le prfixe c pour utiliser cette bibliothque

JSTL : la bibliothque Core : variables Laffichage dune expression se fait par la balise <out> Les attributs de cette balise sont
Object value : lexpression qui sera value (obligatoire) Object default : valeur afficher si lexpression value est null
(dfaut : )
boolean escapeXml : dtermines si les caractres <, >, &, et "

doivent tre remplacs par leurs codes respectifs
Le corps du tag peut tre utilis la place de lattribut

default
<c:out value="${header['user-agent']}" default="Inconnu" />
Corps de out
<c:out value="${header['user-agent']}" > default="Inconnu" </c:out>
JSTL : la bibliothque Core : variables La balise personnalise <set> permet de dfinir une variable de scope ou une proprit Les attributs de cette balise sont
Object value : lexpression valuer String var : nom de lattribut qui contiendra lexpression dans le scope String scope : nom du scope qui contiendra lattribut var (page, request, session ou application) Object target : lobjet dont la proprit dfini par property qui sera
modifi
String property : nom de la proprit qui sera modifie

<c:set var="variable" value="34" scope="page" />
Le corps de la balise <set> peut tre utilis la place de lattribut value JSP2 - M. Baron - Page
64
JSTL : la bibliothque Core : variables Exemple : gestion des variables scopes

Fait la mme chose de manire moins programmatique
<%@ taglib uri="montag" prefix="c" %>
return name; package monpackage; public class MonBean { String name; public String getName() {
<c:set var="test1" value="coco1" scope="page"/> <% pageContext.setAttribute("test2","coco2"); %> <c:out value='${test1}' default='rien' /> ${test2} 
}
} public void setName(String p) { name = p; }
Affichage des informations
<jsp:useBean id="monbean" class="monpackage.MonBean" scope="page" /> <c:set target="${monbean}" value="Bonjour" property="name" /> <c:out value="${monbean.name}" /> keulkeul.blogspot.com
Cration dun objet MonBean et modification de sa proprit name
JSTL : la bibliothque Core : variables La balise personnalise <remove> permet de supprimer la variable de scope indique Les attributs de cette balise sont
String var : nom de la variable de scope supprimer (obligatoire) String scope : nom du scope qui contiendra lattribut var (page, request, session ou application)
Le corps de la balise <remove> ne contient aucune information

<c:remove var="test1" scope="page" />
JSTL : la bibliothque Core : variables La balise personnalise <catch> permet dintercepter les exceptions qui peuvent tre lances par son corps Le corps de la balise <catch> contient le code JSP a risque Lattribut de cette balise est
String var : nom de la variable dans le scope page qui contiendra
lexception intercepte
Simple exemple
<%@ taglib uri="montag" prefix="c" %> <c:catch> <c:set target="beans" property="prop" value="1" /> </c:catch> <c:catch var="varName" > <c:set target="beans" property="prop" value="1" /> </c:catch> ${varName.message} ou <c:out value="${varName.message}" default="Rien" />
Le bean beans nexiste pas, lexception est ignore Le bean beans nexiste pas, lexception est stocke dans la variable varName
JSTL : la bibliothque Core : actions conditionnelles Le traitement conditionnel permet deffectuer un traitement de la mme manire que le mot-clef if du langage Java La balise personnalise utilise est <if> Elle dispose dattributs qui sont
boolean test : condition qui dtermine si le corps est valu ou pas
(obligatoire) du test
String var : nom dune variable de type boolean contenant le rsultat String scope : valeur du scope pour lattribut var
<%@ taglib uri="montag" prefix="c" %> keulkeul.blogspot.com <c:if test="${!empty param['page']}" var="valeur" scope="page"> Coucou a fonctionne </c:if> La valeur de la condition prcdente est : ${valeur}
Si pas de paramtre dans la requte le corps nest pas trait
Possibilit dafficher la valeur de la condition
JSTL : la bibliothque Core : actions conditionnelles Le traitement conditionnel exclusif permet deffectuer un traitement de la mme manire que le mot-clef switch du langage Java La balise personnalise utilise est <choose>, elle ne dispose pas dattribut et le corps peut comporter
une ou plusieurs balises de type <when> zro ou une balise <otherwise>
Laction <choose> excute le corps du premier tag <when> dont la condition de test est true
Si aucune des conditions nest vrifie, le corps de laction <otherwise> est excute La balise <when> dispose dun attribut
boolean test : si le corps doit tre valu ou non(obligatoire)
La balise <otherwise> ne dispose pas dattribut - M. Baron - Page JSP2
69
JSTL : la bibliothque Core : actions conditionnelles Exemple : traitement conditionnel exclusif

Dfinition dune variable de script (scope page ) <c:set var="value" value="2" scope="page" /> Traitement conditionnel exclusif <c:choose> <c:when test="${value==1}$">value vaut 1 (Un) </c:when> <c:when test="${value==2}$">value vaut 2 (Un) </c:when> <c:when test="${value==3}$">value vaut 3 (Un) </c:when> <c:when test="${value==4}$">value vaut 4 (Un) </c:when> <c:otherwise> value vaut ${value} Si pas de valeur commune </c:otherwise> message transmis </c:choose> par la balise < otherwise>
Pas dempilage comme le switch du langage Java (utilisation du break)

JSTL : la bibliothque Core : boucles Le traitement des itrations permet deffectuer un traitement itratif de la mme manire que le mot-clef for et while du langage Java Deux balises sont dfinies <forEach> et <forTokens> Elles disposent en commun des attributs suivant
String var : variable qui comporte llment courant de litration String varStatus : variable qui contient des informations sur litration
int begin : spcifie lindex de dpart de litration int end : spcifie lindex de fin de litration int step : litration seffectue sur les step lments de la collection
JSTL : la bibliothque Core : boucles La balise <forEach> permet deffectuer simplement des itrations sur plusieurs types de collection de donnes Elle dispose dun attribut
Object items : collection dlments sur qui contient les lments de
litration
Lattribut items accepte les lments suivant

les tableaux dobjets ou de types primaires les objets de type Collection les objets de type Iterator
les objets de type Enumeration les objets de type Map
Une value null est considre comme une collection vide Si lattribut items est absent, begin et end permettent deffectuer une itration entre deux nombresJSP2 - M. Baron - Page entiers
72
JSTL : la bibliothque Core : boucles Exemple : itrer sur une Collection

<%@ taglib uri="montag" prefix="c" %> <c:forEach var="entry" items="${header}" > ${entry.key} = ${entry.value} </c:forEach>
Affiche tous les lments Affiche uniquement les trois premiers lments
 La mme chose en affichant uniquement les trois premiers <c:forEach var="entry" items="${header}" begin="0" end="2" > ${entry.key} = ${entry.value} </c:forEach> Affiche uniquement des indices <c:forEach var="entry" begin="0" end="2" > ${entry} </c:forEach>
Affiche les nombres de 0 2

JSTL : la bibliothque Core : boucles La balise <forTokens> permet de dcouper des chanes de caractres selon un ou plusieurs dlimiteurs Elle dispose dun attribut
String items : collection dlments sur qui contient les lments de
litration(obligatoire)
String delims : la liste des caractres qui serviront de dlimiteurs

(obligatoire)
Le corps de cette balise contient le code qui sera valu pour chaque marqueur de chane
<%@ taglib uri="montag" prefix="c" %> keulkeul.blogspot.com <c:forTokens var="content" items="Bonjour Tout Le Monde" delims=" "> ${content} </c:forTokens>
JSTL : la bibliothque Core : URL Pour crer des URLs absolues, relatives au contexte, ou relatives un autre contexte utiliser la balise <url> Cette balise contient diffrents attributs
String value : lURL traiter (obligatoire) String context : spcifie le chemin du contexte de lapplication locale String var : le nom de la variable scope qui contiendra lURL String scope : nom du scope
Si var est omis, lURL sera affiche dans la rponse
Le corps de la balise peut contenir nimporte quel code JSP

La balise <param> permet dajouter simplement un paramtre une URL reprsente par la balise parente Cette balise contient diffrents attributs
String name : nom du paramtre de lURL (obligatoire) String value : valeur du paramtre de lURL
Le corps peut-tre utilis la place de valueJSP2
- M. Baron - Page 75
JSTL : la bibliothque Core : URL Exemple : criture dURL

<%@ taglib uri="montag" prefix="c" %> <c:url value="/page.jsp?param=value" /> <c:url var="url" scope="page" value="/page.jsp?param=value" > <c:param name="id" value="1"/> </c:url> <c:url var="url2" scope="page" context="/" value="${url}" > <c:param name="idd" value="1"/> </c:url> ${url2} <a href="${url}">Mon Lien sur cette page</a> keulkeul.blogspot.com
Cration dune URL sans lattribut var donc affichage dans la rponse
Cration dune URL avec ajout de paramtre
Cration/modification dune URL avec ajout dun troisime paramtres Ajoute le contexte lURL
JSTL : la bibliothque Core : URL La balise <redirect> est une commande de redirection HTTP au client Les attributs de cette balise sont
String url : lurl de redirection (obligatoire) String context : spcifie le chemin du contexte de lapplication locale
utiliser (dbute obligatoirement par / )
Le corps de la balise peut contenir nimporte quel code JSP

<%@ taglib uri="montag" prefix="c" %> keulkeul.blogspot.com <c:redirect url="http://www.developpez.com" /> <c:redirect url="/exemple" > <c:param name="from" value="bonjour" /> </c:redirect>
Redirection cette adresse
Cette URL ne sera jamais traite
JSTL : la bibliothque Core : dploiement Tlcharger limplmentation JSTL de Jakarta ladresse suivante jakarta.apache.org/site/downloads Choisir Taglibs->Standard 1.1 Taglib Copier les librairies jstl.jar et standard.jar dans le rpertoire
WEB-INF/lib de votre application web

Copier les fichiers de description (TLD) dans un sous rpertoire WEB-INF/tld
Modifiez le fichier web.xml de manire donner une URI la bibliothque JSTL Pas plus simple que a ...
JSTL : la bibliothque I18n La bibliothque I18n facilite linternationalisation dune JSP

Dfinition dune langue Formatage de messages Formatage de dates et nombres
Utilisation de la bibliothque JSTL:fmt dans une appli WEB

Copier jstl.jar et standard.jar dans le rpertoire WEB-INF/lib Copier le fichier fmt.tld dans un sous rpertoire de WEB-INF Modifier le fichier web.xml de manire enrichir lURI
<taglib> <taglib-uri>fmtjstl</taglib-uri> <taglib-location>/WEB-INF/tld/fmt.tld</taglib-location> </taglib>
Dclarer dans la page JSP la balise

<%@ taglib uri="fmtjstl" prefix= "fmt" %>
Dans la suite nous utiliserons le prfixe fmt pour utiliser cette bibliothque
JSTL : la bibliothque I18n Les fichiers properties contenant les ressources doivent tre placs dans le rpertoire WEB-INF/classes La balise <message> permet de localiser un message
String key : cl du message utiliser String var : nom de la variable qui va recevoir le rsultat String scope : porte de la variable qui va recevoir le rsultat
Cette balise doit dpendre dun fichier ressource (Bundle)

La balise <bundle> permet de prciser un bundle utiliser dans les traitements contenus dans son corps
String basename : nom de base de ressource utiliser (obligatoire)
<fmt:bundle basename="message" > <fmt:message key="message.bonjour" /> </fmt:bundle>
Le message est affich selon le bundle message

JSTL : la bibliothque I18n La balise <bundle> ne permet dassocier uniquement un bundle au traitement de son corps. La balise <setBundle> permet de forcer le bundle utiliser par dfaut
String basename : nom de base de ressource utiliser (obligatoire) String var : nom de la variable qui va stocker le nouveau bundle String scope : porte de la variable qui va recevoir le nouveau bundle
Modification du bundle par dfaut
<fmt:setbundle basename="message" /> ... <fmt:message key="message.bonjour" />
Le message est affich par lintermdiaire du bundle par dfaut
Si le bundle nest pas dfini cest celui par dfaut qui est utilis cd null
JSTL : la bibliothque I18n La balise <setLocale> permet de modifier une nouvelle locale
String ou Locale value : la locale utiliser (obligatoire) String variant : spcifie une variante spcifique un systme ou
navigateur
String scope : nom du scope qui contiendra la locale

<fmt:setLocale value="en" scope="page" /> <fmt:setLocale value="fr" scope="session" />
Modification de la locale pour la page en cours

Modification de la locale pour lutilisateur en cours
Si vous changez la locale dans le scope application cela affectera tous les utilisateurs
Possibilit de modifier plusieurs fois la locale dans une page JSP

JSTL : la bibliothque I18n La balise <param> permet de paramtrer laffichage dun message obtenu avec la balise <message> Cette balise nest donc utilisable que dans la balise
<message>
Object value : lobjet qui sera utilis pour paramtrer le message
Possibilit de mettre plusieurs paramtres pour un message Les paramtres sont utiliss dans le fichier properties en utilisant les accolades
Le fichier properties
<fmt:message key="la_cle"> <fmt:param value="valeur1" /> <fmt:param value="valeur 2" /> </fmt:message>
Ce message possde deux paramtres
la_cle=message {0}{1}
Les paramtres sont identifis dans le fichiers properties par les accolades
JSTL : la bibliothque I18n Exemple : gestion de linternationalisation (message et date)

<%@ taglib uri="montag" prefix="c" %> <%@ taglib uri="fmtjstl" prefix="fmt" %> <fmt:setLocale value="en" scope="session" /> Un message de bienvenue en Anglais. <fmt:bundle basename="informations" > <fmt:message key="bonjour" /> </fmt:bundle> <fmt:setLocale value="fr" scope="session" /> <fmt:setBundle basename="message" /> Ce message ne sera pas traduit. <fmt:message key="message.vide" /> <fmt:message key="autremessage.bonjour"> <fmt:param value="Monsieur Patate" /> <fmt:param value="Madame Patate" /> </fmt:message>.
La locale est fixe en anglais Affichage de message partir de la ressource informations
La locale est maintenant modifie en franais Affichage de messages avec des paramtres
# Des Messages Rien que Des Messages message.vide=Je pense que c'est vide message.plein=Je pense que c'est plein autremessage.bonjour=Bonjour {0} et {1} autremessage.adieu=Bonsoir {0} et {1}
Fichier message_fr.properties

JSP 2

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

JSP 2

Încărcat de

Drepturi de autor:

Formate disponibile

Java pour le dveloppement dapplications Web : Java EE

Mickal BARON - 2006 (Rev. Aot 2009) mailto:baron.mickael@gmail.com ou mailto:baron@ensma.fr

Les principales classes des balises personnalises

Le traitement du corps se fait par la mme interface

TagExtraInfo apporte des informations complmentaires sur les tags

Besoins de conception de deux familles dlment

Peu de modification depuis la version 1.2

JSP2 - M. Baron - Page 3

Les classes des balises personnalises concernes (version 2)

SimpleTagSupport qui est la classe dimplmentation par dfaut de SimpleTag

Prsentation avec linterface SimpleTag

JSP2 - M. Baron - Page 5

Le fichier de description du projet

<%@ taglib uri="monTag" prefix="montagamoi" %> <montagamoi:hellotag /> Tout le monde

La JSP avec le nouveau Tag

Le rsultat final !!!

Dfini par un fichier XSD

JSP2 - M. Baron - Page 9

Premire balise personnalise

JSP2 - M. Baron - Page 10

<attribute> : dcrit les attributs. Autant quil y a dattributs

Chaque tag personnalis est dfini dans une balise <tag>

Tag sans corps avec un attribut appel attribut1

<type> : indique le type Java de lattribut (dfaut : java.lang.String)

JSP2 - M. Baron - Page 13

Nouvelle classe pour ce nouveau tag de la mme bibliothque

Ajout dun attribut au tag

JSP2 - M. Baron - Page 14

Deux tags sont dfinis dans cette bibliothque

Un seul attribut est dfini

JSP2 - M. Baron - Page 15

Utilisation dans une JSP dun tag avec attribut obligatoire

Une exception se lve quand un attribut obligatoire est omis

JSP2 - M. Baron - Page 17

public void setValue(Object p_value) { value = p_value; }

Lattribut peut recevoir une expression JSP

<%@ taglib uri="monTag" prefix="montagamoi" %>

<montagamoi:evalexpressattribut value="<%= new java.util.Date() %>" />

Un objet autre que String peut-tre envoy

Object findAttribute(String) : cherche lattribut dans les diffrents

removeAttribute(String) : supprime un attribut, ...

JSP2 - M. Baron - Page 19

Exemples dutilisation des mthodes de PageContext

Rcupre lattribut toto dans le scope page

JSP2 - M. Baron - Page 20

Une application WEB

Servlet 11 Servlet Servlet 22 Servlet

JSP2 - M. Baron - Page 21

JSP2 - M. Baron - Page 22

Il faut sassurer que lobjet envoy en attribut est du type ArrayList

premire, elle est moins dpendante que la premire version

JSP2 - M. Baron - Page 23

Simulation de switch case par lintermdiaire de balises

Le corps du tag est valu

Initialise lattribut test

Vrifie que test est le mme que celui du tag enfant

JSP2 - M. Baron - Page 24

JSP2 - M. Baron - Page 25

StringWriter : flux de chanes de caractres OutputStreamWriter PrintWriter

Cette criture a dj t aperue dans les exemples prcdents

Utilisation dun Writer de type StringWriter

Cration dun Writer de chanes de caractres

Place le contenu du corps dans le