Java Server Faces 2

JSF 2.0
Framework de présentation de la
plateforme JEE
Présenté par : Nourhène ALAYA
1
Faculté des Sciences de Tunis, Tunisie

Sommaire
I. Le modèle MVC2
II. Architecture du Framework JSF
III. Fonctionnement de JSF
1. Faces-config.xml
2. Les classes Managed Bean
3. Les page Web avec Facelet
4. Les expressions de langage
5. Les règles de navigation
6. Composants graphiques
7. Les Backing Bean
8. Fichier de propriétés et internationalisation
9. Le Templating
2

Rappel MVC
• Le Model-View-Controller (MVC) a été développé à la fin des années 70.
Il a été conçu à l’origine pour permettre de gérer les interactions entre une
interface graphique et un utilisateur sur les premiers ordinateurs possédant
un système à base de fenêtres.
• Il s'appuie essentiellement sur la séparation en 2 couches verticales
regroupant d'un côté les objets métiers (Modèle) et de l'autre les objets IHM,
ces derniers étant eux mêmes regroupés en objets charges de l'acquisition
d'informations, en provenance de l'utilisateur (contrôleur) et en objets
charges de la restitution d'informations vers l'utilisateur (Vue).
• Le Modèle devrait être toujours indépendant : ne Jamais mélanger code du
Modèle avec code GUI!
3

• MVC1
• La séparation en 2 couches verticales.
• Les objets métiers (Modèle)
• Les objets IHM (Contrôleur,
Vue)
• Plusieurs contrôleurs
• Composants séparés. Mais…Problème
de synchronisation et maintenance !
MVC1 vs MVC2
4
• MVC 2
• hérite des propriétés du modèle MVC
• Le navigateur interagit avec un seul
composant, le contrôleur,
l’architecture est simplifiée.
• Il garantit l'unicité du point d'entrée
de l'application

MVC1 vs MVC2
5
• Dans l'architecture MVC 2, il n'existe plus qu'un seul et
unique contrôleur réceptionnant toutes les requêtes Web
du clientes.
• Le contrôleur unique devient le point d'entrée exclusif de
l'application.
• Il devient alors très aisé de centraliser la gestion des
accès, des droits, des statistiques ou de toute autre
fonctionnalité transverse.
=> Simplification de l’architecture de
l’application
=> Meilleur maintenance du code.

 Si vous voulez implémenter le pattern MVC2 correctement, il y aura beaucoup
de code administratif
• Le traitement du Request , la gestion d'erreurs , le mapping de la vue, etc
 Difficile à maintenir, d’où le besoin d’utiliser un Framework.
 Qu’est ce qu’un Framework ? => Framework = squelette d’application.
• Ensemble de classes et mécanismes associés à une architecture logicielle qui
fournissent un ou plusieurs services techniques ou métiers aux applications
qui s’appuient dessus
• Construite sur une infrastructure commune pour fournir un point de départ
• Aide les développeurs à se concentrer sur ce que l'application a besoin de
faire au lieu de comment elle va le fera.
 Plusieurs Framework qui utilisent le pattern MVC2
• Struts , Barracuda , Hammock (disparu ) , Tapestry , Java Server Faces
(le nouveau standard Java)
Framework intégrant MVC2
6

Java Server Faces (JSF)
http://struts.apache.org/1.x/index.html
7

Introduction: Evolution des Framework Web
• Servlet (1997)
• JSP Procédurale (1999)
• Frameworks de composition
▫ Trapestry (2000)
• Frameworks à base d’action
▫ Struts (2001)
• Frameworks à base de composant
▫ JavaServer Faces (2004)
8

Introduction: Java Server Faces
• Java Server Faces est un Framework développé par Sun pour la création des
interfaces utilisateur coté serveur pour les applications web.
• JSF est basé sur l’architecture MVC2.
• JSF est construit sur un modèle de développement orienté événement.
• JSF offre un modèle d’architecture extensible en terme de composants.
• Pourquoi JSF?
▫ JSF permet d'accroître la productivité des développeurs dans la
conception d’interfaces graphiques d’applications Web exécutés
coté serveur grâce à la notion de composants graphiques.
▫ Ressemble aux WebForms de la plateforme .Net de Microsoft.
9

Qu’apporte JSF ?
• Java Server Faces permet
▫ Une séparation de la couche présentation des autres couches
(MVC 2)
▫ Un ensemble de composants graphiques riches et réutilisables
▫ Une liaison simple entre les actions côté client de l’utilisateur
(event listener) et le code Java côté serveur
▫ Création de nouveaux composants graphiques
▫ JSF peut être utilisé pour générer autre chose que du HTML (XUL,
XML, WML, XHTML …)
10

Les implémentations de JSF
Java Server Faces est une
spécification : il est donc
nécessaire d'obtenir une
implémentation de la part
d'un tiers.
Plusieurs implémentations
commerciales ou libres sont
disponibles, notamment:
▫ l'implémentation de référence de
Sun (JSF)
http://www.oracle.com/technetwork/jav
a/javaee/javaserverfaces-139869.html
▫ l'implémentation MyFaces qui
est devenu un projet du groupe
Apache.
http://myfaces.apache.org/
11

Librairies de composants graphiques
pour les pages JSF
• Oracle ADF Faces
• ICEFaces
• JBoss RichFaces
• JBoss Ajax4JSF
• Apache Tomahawk
• Apache Sandbox
• Apache Trinidad
• Primefaces
• And many more …
12
+ +

Outils de développement JSF
• Eclipse JSF Tools (WTP 2.0)
• IBM RAD
• NetBeans
• Sun Java Studio Creator
• RHDS / Exadel
• MyEclipse IDE
• Oracle JDeveloper
• BEA Workshop for JSF
• Eclipse JBoss Tools
13
+ +

Composants de l’architecture JSF
• Le contrôleur (Faces Servlet) :
▫ Servlet principal de l'application qui sert de contrôleur. Déjà
implémenté dans le Framework. Toutes les requêtes de l'utilisateur
passent systématiquement par ce Servlet, qui les examine et appelle
les différentes actions correspondantes. Ce contrôleur sera déclaré
dans le Web.xlml et configuré dans le fichier faces-config.xml
• La vue: pages web (JSP, JSF, XHTML) :
▫ D’autre type de vue existe, comme WML pour les dispositifs mobiles.
La version JSF 2.0 utilise les Facelets. Les Facelets sont formées
d'une arborescence de composants UI (également appelés widgets ou
contrôles).
• Le modèle (Managed Bean/ Backing Bean) :
▫ Classes Java spécialisées qui synchronise les valeurs avec les
composants UI, accède au logique métier et gère la navigation entre
les pages.
• faces-config.xml
▫ Fichier de configuration de l’application définissant les règles de
navigation et les différents Managed Bean utilisés.
14

Architecture de JSF avec MVC2
15

Composants de l’architecture JSF
• Outre les composants MVC, JSF est composé de:
▫ Moteur de rendu (Rederrer): décode la requête de l'utilisateur pour
initialiser les valeurs du composant et encode la réponse pour créer une
représentation du composant que le client pourra comprendre et afficher.
▫ Convertisseurs et validateurs: Le protocole HTTP est un protocole
uniquement textuel, donc nous aurons besoin de valider les champs de
saisie textuelle et de les convertir vers les autres types d’Objets.
16

Architecture
application JEE
en JSF+EJB
17
Managed Beans
EJB Session Beans
JavaBeans

Les étapes de développements avec JSF
1. Configurer le fichier web.xml afin de déclarer le
Faces Servlet
2. Développer les objets du modèle qui détiennent les
données (Managed Bean ou les Backing
Bean)
3. Déclarer les Managed Bean dans le fichier de
configuration de l'application faces-config.xml
4. Créer des pages en utilisant les composants
d'interface utilisateur UI et les tagLib de JSF
5. Définir les règles de navigation entre les pages dans
faces-config.xml
18

1. La configuration JSF dans le Web.xml
• Exemple basique d’un Web.xml avec l’implémentation Sun de JSF
19

1. Configuration de JSF dans le web.xml
• Identifier la servlet principale : javax.faces.webapp.FacesServlet
• Spécifier le nom et le chemin du fichier de configuration
▫ Nom du paramètre : javax.faces.application.CONFIG_FILES
▫ Exemple : /WEB-INF/faces-config.xml
• Spécifie où l’état de l’application doit être sauvé
▫ Nom du paramètre : javax.faces.STATE_SAVING_METHOD
▫ Valeurs possibles : client ou server
• La classe Servlet principale est le point d’entrée d’une application JSF. On peut pas
appeler directement une page web en utilisant l’extension de son fichier (.jsp ou
.xhtml) sans avoir utiliser l’«url-pattern» du Servlet principal. Ainsi, l’utilisation de
préfixe ou suffixe déclaré dans le web.xml (url-pattern) devient obligatoire. On trouve
plusieurs manières de déclencher des ressources JSF:
▫ Préfixe /faces/ (http://localhost/myAppli/faces/index.jsp)
▫ Suffixes *.jsf (http://localhost/myAppl/index.jsf)
▫ ou *.faces (http://localhost/myAppl/index.faces)
20
<context-param>
<param-name>javax.faces.DEFAULT_SUFFIX</param-name>
<param-value>.jsf</param-value>
</context-param>

1. La configuration de JSF dans le Web.xml
• Le démarrage d'une application directement avec une page par défaut
utilisant JSF ne fonctionne pas correctement. Il est préférable d'utiliser
une page (index.jsp), qui va effectuer une redirection vers la page
d'accueil de l'application d’un manière invisible à l’utilisateur.
• Exemple dans un projet dont le suffixe du Servlet est «.jsf»
▫ Dans «index.jsp» il suffit d’écrire la ligne suivante :
Ou bien
21
<% response.sendRedirect("welcome.jsf"); %>
La page index.jsp ne sera pas affiché, il aura
une redirection silencieuse vers login.jsf

1. La configuration de JSF dans le Web.xml
• Pour exploiter et déployer
une application WEB avec
JSF il faut:
▫ des librairies JSF (Apache ou
Sun) et JSTL
▫ configurer le fichier web.xml
selon la version de JSF
22

2. Le fichier de configuration faces-config.xml
• La description de l’ensemble des balises peut être
trouvée: http://www.horstmann.com/corejsf/faces-config.html
• Un exemple basique de fichier faces-config.xml, que nous allons
enrichir fur à mesure de ce cours:
23
Règle de
navigation
Déclaration des
Managed Bean

2. Le fichier de configuration faces-config.xml
• Le fichier gérant la logique de l’application web
s’appelle par défaut faces-config.xml
• Il est placé dans le répertoire WEB-INF au même
niveau que web.xml. Il décrit essentiellement six
principaux éléments :
▫ les Beans managés <managed-bean>
▫ les règles de navigation <navigation-rule>
▫ les ressources éventuelles suite à des messages <message-
bundle>
▫ la configuration de la localisation <resource-bundle>
▫ la configuration des Validateurs et des Convertisseurrs
<validator> et <converter>
▫ d’autres éléments liés à des nouveaux composants JSF
<render-kit>
• Le fichier de configuration est un fichier XML décrit par
une DTD. La balise de départ est <faces-config>
24

• Un Bean géré est un Bean dont la vie est gérée par JSF et
déclaré dans le fichier de configuration faces-config.xml
• Les Beans géré de JSF n’héritent pas d’une classe
particulière. Il permettra de réaliser
▫ l’affichage des données provenant de la couche métier
▫ le stockage des valeurs d’un formulaire
▫ la validation des valeurs
▫ l’émission des clés de navigation reçus par faces-config.xml
• Il se compose de :
▫ Ensemble des attributs d’instance (private), qui correspondent
à chaque zone de saisie du formulaire d’entrée
▫ Les accesseurs de ses attributs.
▫ Les méthodes d'action qui ne tient pas d’arguments et
retourne une chaîne (la clé de navigation). Ces méthodes
seront mentionnées comme l'action suite au click à un bouton
présent dans le formulaire d'entrée.
25

• Squelette d’une classe Managed Bean :
26
Il faut respecter les règles
suivante lors de l’écriture
d’une classe Managed Bean:
Pas de déclaration de
constructeur
 Pas d’attribues public
Si un attribut est de
type boolean, sa
méthode d’accès
‘getXXX’ doit être écrite
sous forme de ‘isXXX’.
(eg. isMarried())

• Il faut déclarer un Bean managé dans le fichier de
configuration de JSF à l’aide de la balise <managed-
bean>
• Trois éléments essentiels sont à préciser:
▫ <managed-bean-name> définit un nom qui servira d’étiquette quand le
Bean sera exploité dans les pages JSP
▫ <managed-bean-class> déclare le nom de la classe de type
package.class
▫ <managed-bean-scope> précise le type de scope utilisé pour le Bean
(none, application, session, request)
27

4. Exemple d’un Managed Bean qui correspond à une
formulaire
28
Affichage de la valeur
d’Initialisation du Bean
Clé de navigation
Déclaration dans Faces-config.xml

3. Etape d’exécution d’un Managed Bean
29

4. Création Page JSF 2.0 avec Facelet
30
• Comme JSP, Facelets est une technologie de présentation
pour le développement d'applications web en Java.
• Une page JSP est transformée en une Servlet qui possède un
cycle de vie différent de celui de JSF, ce qui peut être source de
confusion et de problèmes. A l'inverse, Facelets est
spécifiquement développé pour JSF et est plus performant et
léger
• .
• Facelets introduit des nouvelles fonctionnalités, comme par
exemple un système de templating ou encore la possibilité de
créer des composants personnalisés sans écrire la moindre
ligne de code Java.
• Facelets est basé sur xml, c'est pour cette raison que les vues
sous facelets sont des pages xhtml (ou encore jspx) et qu'elles
doivent impérativement respecter la structure d'un document
xml.

4. Squelette d’une page XHTML
• On peut continuer d’utiliser
les balises HTML dans les
pages XHTML. Cependant,
il est désormais interdit
d’utiliser des Scriptlets et le
code Java.
• Appel aux deux
bibliothèques de balises
personnalisées de JSF:
▫ Taglib « html » préfixé par
‘h’
▫ Taglib « core » préfixé par
‘f’
31
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
1.0 Transitional">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core">
<h:head>
...
</h:head>
<h:body>
<h:form>
...
</h:form>
</h:body>
</html>

4. Accès aux Bean managés : Facelet et Expression de
Langage (EL)
• Un formulaire JSF doit être construit dans un groupe défini
par la balise <html:form> ... </html:form>
▫ ACTION est automatiquement à SELF (URL courante)
▫ METHOD est obligatoirement POST
• Utilisation de composants JSF pour saisir des informations
▫ <h:inputText> pour la balise HTML <INPUT TYPE="Text">
▫ <h:inputSecret> pour la balise <INPUT TYPE="PASSWORD">
▫ <h:commandButton> pour la balise <INPUT TYPE="SUBMIT">
• La balise <h:commandButton> contient un attribut action
qui permet:
▫ d’indiquer une clé de navigation traité par les règles de navigation
définies dans faces-config.xml
▫ Ou de faire appel à une méthode d’action dans un Managed Bean
via une expression de langage EL.
32

4. Accès aux Managed Bean avec EL
• Les Expressions Languages (EL) sont utilisées pour
accéder aux éléments du Bean dans les pages JSP ou Xhtml
▫ Un EL permet d’accéder simplement aux Beans des différents scopes
de l’application (page, request, session et application)
▫ Forme d’un Expression Language JSF #{expression}
▫ Une EL est une expression dont le résultat est évaluée au moment où
JSF effectue le rendu de la page
• L’écriture #{MyBean.value} indique à JSF
▫ de déterminer le nom de l’objet MyBean dans le fichier faces-
config.xml
▫ de chercher l’instance du Bean, qui porte le nom de MyBean
dans son contexte puis invoque la méthode getValue()
(chercher la propriété value)
• Possibilité d’accéder à un objet contenu dans le Bean
▫ #{MyBean.myobject.value} : propriété value de myobject
contenu dans MyBean
33

4. Accès aux Managed Bean avec EL
• Déclaration du Bean dans Faces-config.xml
• Dans la vue, l’accés en lecture ou en écriture aux attributs du Bean et à ses
méthodes s’effectue comme suit:
▫ <h:inputText value="#{MyBean.name}"/>
La valeur saisie sera stocké au niveau de l’attribut name de MyBean. (≈
MyBean.setName(String s))
▫ <h:inputText value="#{MyBean.name}"/>
affiche la valeur de l’attribut name de MyBean. (≈ MyBean.getName())
▫ <h:commandButton value="Login"
action="#{MyBean.authentification}" type="submit" />
Suite au submit du formulaire, il aura appel à la méthode authentification() du
Bean MyBean
34

Exemple des Expression Language
35

Suite de l’exemple d’un formulaire de connexion
• Managed Bean «ConnectBean.java»
36
Affichage de la valeur
d’Initialisation du Bean
Clé de navigation
Déclaration dans Faces-config.xml

xmlns:f="http://java.sun.com/jsf/core">
<h:head><title>Authentification</title></h:head>
<h:body>
<h:form>
<h:panelGrid border="1" columns="2">
<h:outputText value="Adresse Mail"></h:outputText>
<h:inputText value="#{connectBean.email}" />
<h:outputText value="Mot de Passe"></h:outputText>
<h:inputSecret value="#{connectBean.password}" />
<h:commandButton value="Valider" type="submit"
action="#{connectBean.connect}" />
<h:commandButton value="Reset" type="reset" />
</h:panelGrid>
</h:form>
</h:body>
</html>
Suite de l’exemple
• La page JSP du formulaire «connect.xhtml»
37
Accès aux attributs
du Bean
Appel à la méthode connect()
du Bean

5. Navigation : configuration de faces-config.xml
• FacesServlet décide la ressource à appeler suite à la réception d’un
message grâce à la configuration décrite dans le faces-config.xml
▫ Les messages sont des simples chaînes de caractères
▫ Utilisation de la balise <navigation-rule> pour paramétrer les règles de
navigation
• La balise <from-view-id> indique la vue source où est effectuée la
demande de la redirection. La vue peut être un :
▫ Formulaire (action de soumission)
▫ Lien hypertext
• Pour chaque valeur de message une page de direction est indiquée
dans la balise <navigation-case>
▫ <from-action> : la méthode du Managed Bean qui a généré la clé
▫ <from-outcome> : la valeur du message (clé de navigation)
▫ <to-view-id> : la vue de direction, la page JSP/XHtml
• Pour schématiser nous distinguons deux sortes de navigation
▫ Navigation statique: La valeur de l’Outcome est connue au
moment de l’écriture de la JSP
▫ Navigation dynamique: La valeur de l’Outcome est inconnue au
moment de l’écriture de la Vue. Elle peut être calculée par un Bean Managé
ou autre chose comme nous l’avons vu dans l’exemple du formulaire.
38

Suite de l’exemple d’un formulaire de connexion
• Afin de pouvoir exécuter le formulaire, il faut définir des règles de navigation dans
le Faces-config.xml qui correspond aux états retourné par le ManagedBean
39
Définition des règles de
Navigation Faces-config.xml

5. Navigation statique
• Appel direct à un message de navigation sans passer par une
méthode d’action => clé de navigation statique
40
Pas de balise <from-action>
Redirection vers
Welcom.jsp sans
passer par le
ManagedBean

7. Principes de composants graphiques JSF
• Chaque composant graphique est défini par une classe
Java qui décrit ses fonctionnalités.
• Plusieurs rendus pour un même composant
• Possibilité de définir des rendus
• Chaque composant génère des événements (Events)
• Le serveur possède des écouteurs (Listeners) qui traitent
les événements de chaque composant UI (user interface)
• Les composants graphiques sont appelé par des balise
spécialisé dans les page JSP/XHtml.
• Elles peuvent aussi manipulé à partir de ses classes Java
dans les Managed Bean
4
1

7. Composants Graphiques de JSF
• Le Framework JSF offre la possibilité d’encapsuler tout ou partie des
composants UI qui composent une vue.
• Ci-dessous l’hiérarchie des principaux composants JSF
42

• JSF fournit un ensemble de composants
graphiques pour la conception de l’IHM
43

44

7. Composants <h:dataTable>
• Le composant <html:dataTable> permet de visualiser des
données sur plusieurs colonnes et plusieurs lignes
• La table peut être utilisée quand le nombre d'éléments à afficher
est inconnu
• Attributs de la balise :
▫ value : une collection de données (Array, List, ResultSet,…)
▫ var : nom donné à la variable à manipuler pour chaque ligne
▫ border, bgcolor, width : attributs pour l'affichage
▫ rowClasses, headerClass : attributs pour la gestion des styles (CSS)
• Pour chaque colonne de la table, la valeur à afficher est obtenue
par la balise <h:column>
• Exemple :
45
<h:dataTable var="someVar" value="#{myBean.someCollection} "
border="…">
<h:column>#{someVar.property1}</h:column>
<h:column>#{someVar.property2} </h:column>
…
</h:dataTable>

7. Composants <h:dataTable>
• La modification des en-tête et pied d'une table est
obtenue en utilisant la balise <c:facet>
• Pour le composant table trois filiations possibles
 header : une filiation entre une colonne et le nom de la
colonne
 footer : une filiation entre la table et un nom
 caption : une filiation entre le titre de la table et un nom
46
<h:dataTable var="someVar" value="#{someCollection}">
<h:column>
<f:facet name="header">First Heading</f:facet>
#{someVar.property1}
</h:column>
…
</h:dataTable>

8. FacesContext : principe
• FacesContext permet de représenter toutes les informations contextuelles
associées à la requête et à la réponse
▫ Notez qu'il y autant d'instances de type FacesContext qu'il y a de vues JSF
▫ FacesContext est essentiellement utilisé par les mécanismes internes de JSF. Toutefois
il est possible d'en extraire des informations intéressantes
• Un objet FacesContext est exploitable dans un Bean ou dans une Vue via
son objet implicite associé. On peut en extraire:
▫ ExternalContext : accéder aux éléments de la requête et de la réponse
▫ Message Queue : stocker des messages
▫ ViewRoot : accéder à la racine de l'arbre des composants (UIViewRoot)
▫ Modifier le déroulement du cycle de vie
• Accès au object HttpServletRequest, HttpServletResponse via le code
suivant:
48
ExternalContext context =
FacesContext.getCurrentInstance().getExternalContext();
HttpServletRequest request =(HttpServletRequest)context.getRequest();
HttpServletResponse
response=(HttpServletResponse)context.getResponse();

9. Classe Backing Bean
• Un Backing Bean est un Managed Bean dont certaines propriétés sont de
type UIComponent
• Dans le Bean, il faut déclarer des accesseurs et des modificateurs sur des
propriétés de type UIComponent
49
 Au niveau de la page JSP, la liaison entre le « Backing Bean » est la vue se fait par
l’attribut binding

9. Activer ou désactiver un bouton par un Bean 50
Page JSP
Composant UI Encapsulé
Avant
Après

10. Message de validation: création dans les Beans
• L’API JSF fournit l’objet FacesMessage pour empiler des messages qui
pourront être afficher dans une page XHTML
• Un objet FacesMessage est caractérisé par :
▫ Sévérité : SEVERITY_INFO, SEVERITY_WARN, SEVERITY_ERROR et SEVERIRY_FATAL
▫ Résumé : texte rapide décrivant le message
▫ Détail : texte détaillé: le message à affiché
• Pour envoyer des messages vers une Vue, il faut passer par le contexte
courant de JSF (FacesContext)
▫ addMessage(String id, FacesMessage message) : ajoute un message à
un composant (identifié par id)
▫ Si id est null le message n’est pas associé à un composant
• Exemple de construction et transmission d’un FacesMessage :
51

10. Message de validation : affichage
• La bibliothèque HTML propose deux balises
personnalisées pour afficher les messages suite à la
validation de champs de saisie d’un formulaire
▫ <html:messages> : affiche tous les messages envoyés par le bean
▫ <html:message> : affiche les messages associés à un identifiant ‘id’
d’un composant du formulaire
• Les balises contiennent les attributs suivants :
▫ for : indique l’id du composant (uniquement pour message)
▫ showDetail : booléen qui précise si le message est détaillé
▫ showSummary : booléen qui précise si le message est résumé
▫ tooltip : booléen qui précise si une bulle d’aide est affichée
52

Exemple avec <h:messages />
53

54
Backing Bean
Exemple avec <h:message />
Il faut ajouté un ‘id’ pour chaque
composant du formulaire

11. L’internationalisation I18N
• JSF offre la possibilité d’internationaliser ses applications, c'est-à-dire
d’adapter la langue utilisée dans l’interface (français, anglais…). Pour ce faire,
il faut :
▫ Ne pas écrire directement sur les JSP, les différents libellés des champs
d’un formulaire et les différents messages à afficher sur la Vue. Il faut
passer par les clés définit dans un fichier de ressources.
▫ Un fichier de ressources comprend une liste de clés et leur valeur associée.
Les clés seront utilisé dans les JSP alors que les valeurs seront affiché à
l’utilisateur.
• Le fichier ressource doit :
▫ Porter comme extension «.properties », (eg:toto.properties)
▫ Pour chaque langage, il faut créer un fichier de ressource spécifique
 MessageRessources.properties : ce fichier contient les messages de la langue
par défaut pour votre application.
 MessageRessources_XX.properties : ce fichier contient les mêmes
messages dans la langue dont le code ISO est XX (fr, en, it, es)
• Les fichiers des ressources doivent être placés directement au dessus du
‘src’ de votre projet ou bien dans un répertoire ‘resources’ aussi au dessus
de ‘src’ comme le montre la figure.
55

Exemple d’un fichier de ressource
56
anglais
français
ApplicationMessages.properties (Français)
ApplicationMessages_en.properties(Anglais)

11. Internationalisation
• Faces-config.xml permet de configurer les langues acceptées pour l’application WEB
dans la balise <application> qui se compose des sous balises suivants:
• La balise <resource-bundle> permet de déclarer l’emplacement de fichier de
ressource à utiliser.
▫ <base-name> : le nom de base du fichier de ressource. Dans l’exemple, ce fichier
est ‘messages.proprieties’ et il est placé directement au dessus du ‘src’
▫ <var> : la variable qui fera référence au fichier de ressource. Elle sera utilisée
dans les Vues pour accéder aux messages.
• Si les fichiers de ressources sont crées au dessous du package ‘resources’
(WEB-INF/classes/resources/messages.properties), :
57
<application>
<resource-bundle>
<base-name>messages</base-name>
<var>msgs</var>
</resource-bundle>
</application>
<application>
<resource-bundle>
<base-name>resources.messages</base-name>
<var>msgs</var>
</resource-bundle>
</application>

11. Internationalisation
• L’appel à un message de ressource s’effectue directement dans le vues via EL en
utilisant le ‘var’ déclaré dans le faces-config:
▫ #{msgs.name}
• JSF détermine la langue par défaut en se référant à la langue configuré au niveau
de votre navigateur
58

12. Templating avec JSF/Facelets
• Un template est une page xhtml ordinaire qui définit la structure du
document avec des emplacements spécifiques où les pages qui utilisent
ce template (pages clientes) insèreront leur contenu.
• Les tag responsables de la création et l’utilisation des template font
partie du taglib ‘facelets’ généralement référencé par ‘ui’
• Les étapes de base :
1. Création d’un fichier ordinaire ‘template.xhtml’ :
a. Le contenu qui apparaîtra dans tous les pages clientes est entré directement
dans le fichier template
b. Le contenu qui peut être remplacé dans le pages clientes sera entouré par le
tag ‘<ui:insert name=‘section’’>
2. Création des pages clientes, qui utiliseront le template :
a. Le contenu de ces pages sera entouré par la balise ‘ui:composition’. Cette
balise indique le chemin du fichier ‘template’ qui sera utilisé.
b. Utilisé la balise ‘ui:define’ pour réécrire le contenu de chaque section
remplaçable indiqué dans le modèle (marqué dans le modèle avec ui: insert)
59
xmlns:f="http://java.sun.com/jsf/core"
xmlns:ui="http://java.sun.com/jsf/facelets">

Exemple de ‘template.xhtml’ Exemple de page cliente
<ui:composition
template="./templates/template.xhtml">
<ui:define name="title"> Page Cliente</ui:define>
<ui:define name="body">
<p/>Je suis la page cliente
</ui:define>
</ui:composition>
</html>
60
<h:body>
Content commun à toutes les pages
clientes
<h2><ui:insert name="title">
Un titre qui pourra être remplacé
</ui:insert></h2>
Encore des lignes communes qui seront
affichés dans toutes les pages
<ui:insert name="body">
Un corp de page par défaut qui peut
être remplacé
dans les pages
</ui:insert>
</h:body>
</html>

• Dans le fichier template:
▫ Le paramètre ‘name’ du le tag <ui :insert name=" XXX" > indique le
nom de la section qui peut être modifié chez la page cliente: en-tête, menu,
body etc.
• Dans le fichier xhtml de la page cliente :
▫ <ui:composition template=‘/template.xhtml’> fait référence au fichier
du template à utilisé
▫ <ui:define name=" XXX" > remplace le contenu d’une section déclaré
dans le fichier template.
▫ <ui:include src= " path d’un fichier xhtml" > permet d’insérer un fichier
dans un autre.
• Généralement, un contenu commun à toutes les page est mis dans le
fichier du template, un contenu spécifique est mis directement dans la
page cliente et un contenu, qui peut être appelé par certaines pages et
d’autres non, sera mis dans un fichier séparé et appelé par la balise
‘ui:include’
61

62
12. Exemple évolué de Templating
header.xhtml
footer.xhtml
Search-menu.xhtml
welcome.xhtml
fournisseursList.xhtml

• Le projet est constitué de deux pages
clientes ‘welcome’ et ‘fournisseursList’ qui
respectent le même modèle d’IHM.
• Le fichier ‘template’ fait appel à des fichiers
communs à toutes les pages:
▫ Footer.xhtml
▫ Header.xhtml
▫ Google-search-box.xhtml, ce fichier
respecte le template ‘search-box-
template.xhtml’
• Les fichiers du projet sont regroupés
dans des répertoires différents:
▫ Pages : les pages clients
▫ Templates: fichiers de template
▫ Template/include : fichier d’inclusion
▫ Images: les images utilisés dans les pages
▫ Css : fichiers de style.
63

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:h="http://java.sun.com/jsf/html"
<h:head><title><ui:insert name="title">Title</ui:insert></title>
<link rel="stylesheet" type="text/css“ href="../css/styles.css"/>
</h:head>
<h:body>
<ui:insert name="header">
<ui:include src="../templates/includes/header.xhtml"></ui:include>
</ui:insert>
<p/>
<table border="5" align="center">
<tr><th class="title">
<ui:insert name="title">Title</ui:insert>
</th></tr>
</table><p/>
<table width="75" align="left" cellspacing="5">
<tr><td>
<ui:insert name="menu">
<ui:include src="../templates/includes/google-search-box.xhtml"/>
</ui:insert></td></tr>
</table><p/>
<ui:insert name="body">Body</ui:insert>
<br clear="all"/> <hr/>
<ui:insert name="footer">
<ui:include src="./includes/footer.xhtml"/>
</ui:insert>
</h:body></html>
64
C’est le fichier du
‘Template’
le reste de ‘src’ du projet
sont joint au support du
cours

• Les projets exemples joints au support du cours :
▫ Basics : exemple de projet JSF basique
▫ data-tables : exemple de projet JSF avec différents
cas d’utilisation des tableaux
▫ FournisseursJSF : exemple basique de JSF avec
Templating et tableau
▫ FournisseursJSFInternational : le projet
FournissersJSF avec Internationalisation
65

RichFaces
http://richfaces-showcase.appspot.com/richfaces/component-
sample.jsf
66

RichFaces
67
• Richfaces est né du besoin d'associer la technologie
Ajax à celle de JSF.
• Il comporte un ensemble de composants permettant
d'ajouter des fonctionnalités Ajax avancées aux
composants standards JSF sans manipulation du
code JavaScript.
• Richfaces permet aussi d’enrichir les composants
graphiques de JSF et d’ajouter des nouveaux
composants.
• L’utilisation de RichFaces n’apporte pas des
modifications au niveau de Managed Bean, ni au cycle
général de développement de JSF. C’est seulement au
niveau des Vues qu’on pourra désormais bénéficier de
nouvelles balises prédéfinies.

<context-param>
<param-name>org.richfaces.SKIN</param-name>
<param-value>classic</param-value>
</context-param>
<context-param>
<param-name>org.ajax4jsf.VIEW_HANDLERS</param-name>
<param-value>com.sun.facelets.FaceletViewHandler</param-value>
</context-param>
<filter>
<display-name>RichFaces Filter</display-name>
<filter-name>richfaces</filter-name>
<filter-class>org.ajax4jsf.Filter</filter-class>
</filter>
<filter-mapping>
<filter-name>richfaces</filter-name>
<servlet-name>Faces Servlet</servlet-name>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
<dispatcher>INCLUDE</dispatcher>
</filter-mapping>
Intégration de RichFaces
68
• Ajout de déclaration dans le Web.xml
Défini le style (Skin)
générale des pages , d’autres
(wine, cherry)

Intégration de RichFaces
69
• Pour ajouter les balises richfaces dans une Facelet,
on ajoute à l’entête de la page les taglib A4J et Rich.
• La bibliothèque a4j (Ajax for JSF) permet d’ajouter
des traitements Ajax aux pages JSF.
• La bibliothèque rich contient les composants
graphiques de richfaces.
• Il faut ajouter au projet les Jar de la bibliothèque
RichFaces.

Exemple de composants RichFaces
70

Composants Graphiques de RichFaces
71
<rich:gmap />

72
• <rich:tabPanel/>
• <rich:panel/>: Représente une zone rectangulaire qui peut inclure
d'autres composants y compris d'autres panels.Il est possible de lui ajouter un
en-tête avec un titre à l'aide d'un facet.
<rich:tabPanel>
<rich:tab label="Client">
composants pour le client
</rich:tab>
<rich:tab label="Commandes ">
composants pour commandes
</rich:tab>
<rich:tab label="Livraison">
Composants pour livraison </rich:tab>
</rich:tabPanel>
<rich:panel>
<f:facet name="header"> Rich Panel </f:facet>
<h:outputText value="Exemple panel" />
</rich:panel>

73
• <rich:panelBar/>
• <rich:simpleTogglePanel />: Représente un panel
dont le contenu peut être affiché ou caché, grâce à un clic sur son titre.
<rich:panelBar height="150" width="500">
<rich:panelBarItem label="Panel Client"> Clients
</rich:panelBarItem>
<rich:panelBarItem label="Panel Commandes">
commandes
</rich:panelBarItem>
</rich:panelBar>

74
• <rich:contextMenu />: c’est un menu que l'on peut attacher à un
autre composant JSF, il s'active par un événement JavaScript. L'exemple suivant
présente un contextMenu attaché au composant rich:panel.
<rich:panel id="panel">
<f:facet name="header">
<h:outputText value="Exemple rich:contextMenu" />
</f:facet>
<h:outputText value="Cliquer pour avoir un menu contextuel" />
<rich:contextMenu event="onclick" attachTo="panel“ submitMode="ajax">
<rich:menuGroup value="Ajouter">
<rich:menuItem value="Client" />
<rich:menuItem value="Produit" />
<rich:menuItem />
</rich:menuGroup>
<rich:menuGroup value="Supprimer">
<rich:menuItem value="Client" />
<rich:menuItem value="Produit" />
</rich:menuGroup>
</rich:contextMenu>
</rich:panel>

Exemple avec le composant <rich:dataTable/>
75
• rich:dataTable apporte plusieurs fonctionnalités absentes
dans le composant standard h:dataTable. En effet,
rich:dataTable dispose des facets header et footer, il
implémente les paramètres HTML rowspan et colspan. De
plus, il peut contenir des sub-tables, et fournit des outils
pour filtrer, ordonner les colonnes et paginer les lignes.

Exemple avec le composant <rich:dataTable/>
76
Trier
cette
colonne
recherche d’un
élément de cette
colonne
Pagination du
tableau : (5 lignes
par page)

Java Server Faces 2

Contenu connexe

Tendances (20)

En vedette (6)

Similaire à Java Server Faces 2 (20)

Plus de 'Farouk' 'BEN GHARSSALLAH' (18)

Java Server Faces 2