Tutoriel pour apprendre à développer une application web Jakarta EE avec JSF, EJB, JTA et JPA

Olivier BUTTERLIN

Le but de ce tutoriel est d’apprendre à développer des applications web avec les technologies Jakarta EE (anciennement Java Enterprise Edition ou JEE) en version 8 et plus particulièrement :

- JSF 2.3

- EJB 3.2

- JTA

- JPA 2.1

Il présente une manière de faire en relation avec la bibliothèque de composants graphiques Primefaces.

Le serveur d’application certifié EE8 peut être choisi en fonction de ses affinités même si personnellement j’utilise un serveur Wildfly 17.

Notez qu’en fonction du serveur d’application que vous choisirez, l’implémentation de JPA pourra différer. Le serveur Wildfly utilise Hibernate comme implémentation de JPA.

La base de données relationnelle peut également être choisie entre plusieurs possibilités, j’utilise pour mes tests une base de données MySQL.

Pour l’EDI, je vous conseille Eclipse 2019-06 (ou supérieur) avec l’extension Jboss Tools.

Vous pourrez télécharger tous les logiciels nécessaires aux adresses suivantes ainsi que les sources de l’application :

- https://wildfly.org/downloads/

- https://www.mysql.com/fr/downloads/

- https://www.eclipse.org/downloads/packages/

- Sources de l'application

Pour réagir au contenu de cet article, un espace de dialogue vous est proposé sur le forum Commentez .

- Titre : Tutoriel pour apprendre à développer une application web Jakarta EE avec JSF, EJB, JTA et JPA

- Auteur : Olivier BUTTERLIN

- Parution : 4 septembre 2019

- Public visé :

- Licence : Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright ® 2019 Olivier BUTTERLIN. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Spécification Jakarta EE (Java EE )

- I-A. EJB (Enterprise Java Bean)

- I-B. JPA (Java persistence API)

- I-C. JTA (Java Transaction API)

- I-D. JSF (Java Server Faces)

- I-D-1. Le cycle JSF

- I-D-2. Le cycle de vie des beans gérés (Managed beans)

- I-D-3. Les convertisseurs

- I-D-4. Les validations

- I-D-5. Les systèmes de navigation

- I-D-5-a. Navigation explicite

- I-D-5-b. Navigation implicite

- I-D-5-c. Navigation par code

- II. Internationalisation

- III. Application type : Gestion de personnes

- III-A. Création et configuration des projets

- III-B. Modèle de données

- III-C. Scripts de création de la base de données (MySQL)

- III-D. Classes utilitaires et abstraites de l’application

- III-E. Modèle JPA

- III-F. La couche d’accès aux données (EJB métier)

- III-F-1. Façade de l’application

- III-F-2. EJB spécialisés

- III-F-3. Requête variable d’extraction d’enregistrements

- III-F-4. Passage des erreurs de l’EJB à l’IHM

- III-G. Le template de l’application

- III-H. Le module de recherche de personnes

- III-H-1. PersonneRechercheManager

- III-H-2. PersonneRechercheOptions

- III-H-3. PersonneRechercheDataModel

- III-H-4. La page xhtml associée

- III-I. Module de gestion du détail d’une personne

- III-I-1. PersonneManager

- III-I-2. La page xhtml associée

- III-J. Module de gestion des civilités

- III-J-1. CiviliteRechercheManager

- III-J-2. CiviliteRechercheDataModel

- III-J-3. La page xhtml associée

- III-K. Module de gestion des types de téléphones

- IV. Conclusion et remerciements

I - Spécification Jakarta EE (Java EE )

Jakarta EE est une spécification qui étend Java Standard Edition (Java SE).

La première version des spécifications Java EE fut publiée en 1999.

La dernière version, Java EE8, est sortie en août 2017.

En 2018, le projet est confié par Oracle à la Fondation Eclipse, et le nom Jakarta EE est choisi par la communauté des développeurs à la place de Java EE.

La plate-forme se fonde principalement sur des composants modulaires exécutés sur un serveur d'applications dont la version open source de référence est GlassFish 5.

I-A - EJB (Enterprise Java Bean)

Enterprise Java Bean est un standard de développement de composants métiers côté serveur écrits en Java et capables d’être appelés à distance ou localement.

Initialement développé par IBM en 1997, la spécification a été adoptée par Sun Microsystems en 1999 en tant qu’EJB 1.0. 20 ans après, on est à la version 3.2 de la spécification EJB, beaucoup plus simple d’utilisation qu’à ses débuts.

Il existe (actuellement) deux types d’EJB :

- EJB session
EJB avec état (stateful) ou sans état (stateless), ce sont les plus utilisés pour écrire la couche métier d’une application. Ils ont la capacité d’être appelés à distance (JVM distincte) ou localement (même JVM que l’appelant), le choix se faisant par l’interface utilisée (soit avec une annotation @Local, soit @Remote).
Une variante permet de créer un bean unique via l’annotation @Singleton, pratique pour partager des données ou faire des traitements particuliers au démarrage et à l’arrêt d’une application.

- EJB message driven
EJB répondant à des messages fournis par JMS (par exemple ActiveMQ, MQSeries).

I-B - JPA (Java persistence API)

Java Persistence API permet de gérer facilement la transformation du monde relationnel des bases de données et le monde Objet de Java.

Elle s’appuie sur :

- des annotations spécifiques de paramétrage ;

- un langage de requête (JPQL) ;

- une implémentation de l’API (Hibernate, EclipseLink, OpenJPA…).

I-C - JTA (Java Transaction API)

Java Transaction API fournit des interfaces Java standards entre un gestionnaire de transaction et les différentes parties impliquées dans un système de transactions distribuées : le gestionnaire de ressources, le serveur d'application et les applications transactionnelles.

JTA est un protocole de commit à deux phases.

I-D - JSF (Java Server Faces)

Java Server Faces est un framework MVC2 (Modèle, Vue, Contrôleur) basé sur des composants.

Le point d’entrée d’une requête se fait par une unique servlet Faces Servlet (javax.faces.webapp.FacesServlet).

La dernière version de JSF est la version 2.3.

Depuis la version 2.0, Facelets est la technologie utilisée par défaut pour le rendu des pages en remplacement des pages JSP.

Facelets inclut un moteur de template qui simplifie la construction des pages.

Les composite components simplifient la création de composants personnels réutilisables dans plusieurs vues.

I-D-1 - Le cycle JSF

Le traitement d’une requête se fait en six phases :

Explications :

1. Lorsqu’une requête arrive, on commence par restaurer le graphe des objets de la vue ou de les créer si c’est la première utilisation.

2. Les données envoyées par un formulaire sont affectées aux composants correspondants.
Si des convertisseurs sont nécessaires, ils sont appelés.

3. Les valeurs sont validées par les éventuels validators.

4. Les données sont transférées au bean sous-jacent.

5. Les listeners de l’application sont appelés.
Les méthodes de l’application sont exécutées.
Le calcul de la prochaine page est effectué.

6. La vue est construite et renvoyée au client.

I-D-2 - Le cycle de vie des beans gérés (Managed beans)

Avec la version 2.3 de JSF, l’injection de dépendance est confiée à CDI (Context and Dependency Injection).

Les beans sont créés et enregistrés automatiquement dans différents contextes (scope), lesquels ont des durées de vie différentes.

Les scopes standards :

- @RequestScoped
Le bean est créé pour la requête en cours et sera détruit après la réponse du serveur.

- @ViewScoped
Le bean est créé et associé à une vue. Tant que la vue ne change pas, le bean reste accessible. Au changement de vue, le bean sera détruit.

- @SessionScoped
Le bean est créé et associé à la session (HttpSession) de l’utilisateur. Le bean sera accessible tant que la session de l’utilisateur sera active et il sera détruit lorsque la session sera détruite. Tous les beans au sein de la même session peuvent accéder aux autres beans de scope session.

- @ApplicationScoped
Le bean est créé et associé à l’application sur le serveur. Tant que l’application est active, le bean est accessible. Il sera détruit avec l’arrêt de l’application (généralement à l’arrêt du serveur). Tous les utilisateurs de l’application partagent un bean en scope application.

- @ConversationScoped
Le bean est créé pour une unité de travail, il sera détruit une fois l’unité stoppée.

Le choix du scope d’un bean s’avère très important, il s’agit de bien réfléchir à ce qui est lié à une requête, ce qui doit survivre à la requête et pour combien de temps.

Attention quand même à ne pas mettre trop de choses en session, la taille d’une session peut avoir des répercussions sur les performances.

I-D-3 - Les convertisseurs

Les convertisseurs permettent de générer une valeur String identifiant un objet et en retour de récupérer l’objet par son identifiant.

Il existe deux manières d’écrire des convertisseurs, dans les deux cas, la classe doit implémenter l’interface javax.faces.convert.Converter.

Exemple CDI

1. @Named

2. @ApplicationScoped

3. public class TelephoneTypeConverter implements Converter<Object>

4. {

5. @EJB

6. private MonProjetFacadeLocal facade;

7. @Override

8. public Object getAsObject(FacesContext context, UIComponent component, String value)

9. {

10. if (value == null)

11. {

12. return null;

13. }

14. return facade.getTelephoneType(Integer.valueOf(value));

15. }

16. @Override

17. public String getAsString(FacesContext context, UIComponent component, Object value)

18. {

19. if (value == null)

20. {

21. return null;

22. }

23. if (value instanceof DTOTelephoneType)

24. {

25. return ((DTOTelephoneType)value).getUid().toString();

26. }

27. return value.toString();

28. }

29. }

Dans cet exemple, nous avons accès aux objets gérés par CDI, ici la façade EJB.

Référencement dans la page

1. <p:balise … converter="#{telephoneTypeConverter}">

Exemple JSF

1. @FacesConverter("datetimeConverter")

2. public class DatetimeConverter implements Converter<Object>

3. {

4. private static final SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm");

5. @Override

6. public Object getAsObject(FacesContext context, UIComponent component, String value)

7. {

8. if (value == null)

9. {

10. return null;

11. }

12. try

13. {

14. return sdf.parse(value);

15. }

16. catch (Exception e)

17. {

18. return null;

19. }

20. }

21. @Override

22. public String getAsString(FacesContext context, UIComponent component, Object value)

23. {

24. if (value == null)

25. {

26. return null;

27. }

28. try

29. {

30. return sdf.format(value);

31. }

32. catch (Exception e)

33. {

34. return null;

35. }

36. }

37. }

Dans cet exemple, nous n’avons pas accès aux objets gérés par CDI.

Référencement dans la page

1. <p:balise … converter="datetimeConverter">

À noter qu’avec JSF 2.3, on pourrait avoir accès à l’injection en utilisant le nouvel attribut managed=true de la balise @FacesConverter.

Exemple

@FacesConverter("datetimeConverter", managed=true)

I-D-4 - Les validations

Les validateurs permettent de contrôler la saisie et d’interrompre, en cas d’erreur, le cycle JSF.

Il existe deux manières de concevoir un validateur, dans les deux cas la classe doit implémenter l’interface javax.faces.validator.Validator.

Exemple CDI

1. @Named

2. @ApplicationScoped

3. public class TelephoneTypeValidator implements Validator<Object>

4. {

5. @EJB

6. private MonProjetFacadeLocal facade;

7. @Override

8. public void validate(FacesContext context, UIComponent component, Object value) throws ValidatorException

9. {

10. if (value == null)

11. {

12. throw new ValidatorException(new FacesMessage("Le type de numéro de téléphone est obligatoire"));

13. }

14. Object test = facade.getTelephoneType(((DTOTelephoneType)value).getUid());

15. }

16. }

Dans cet exemple, nous avons accès aux objets gérés par CDI, ici la façade EJB.

Référencement dans la page

1. <p:balise>

2. <f:validator binding="#{telephoneTypeValidator}"/>

3. </p:balise>

Exemple JSF

1. @FacesValidator(value="telephoneNumeroValidator")

2. public class TelephoneNumeroValidator implements Validator<Object>

3. {

4. @Override

5. public void validate(FacesContext context, UIComponent component, Object value) throws ValidatorException

6. {

7. if (!Utils.isSet(value))

8. {

9. throw new ValidatorException(new FacesMessage("Le numéro de téléphone est obligatoire"));

10. }

11. }

12. }

Dans cet exemple, nous n’avons pas accès aux objets gérés par CDI.

Référencement dans la page

1. <p:balise ... validator="telephoneNumeroValidator">

2. ou

3. <p:balise ...>

4. <f:validator validatorId="telephoneTypeValidator"/>

5. </p:balise>

À noter qu’avec JSF 2.3, on pourrait avoir accès à l’injection en utilisant le nouvel attribut managed=true de la balise @FacesValidator.

Exemple

@FacesValidator(value="telephoneNumeroValidator", managed=true)

I-D-5 - Les systèmes de navigation

Il existe différents moyens pour naviguer d’une page vers une autre avec JSF, en passant par le fichier faces-config.xml (navigation dite « explicite ») ou sans (navigation « implicite » ou par code).

I-D-5-a - Navigation explicite

Pour configurer une navigation dans le fichier faces-config.xml, on utilise les directives <navigation-rule>, <from-view-id>, <navigation-case>, <from-outcome>, etc.

Exemple

1. <navigation-rule>

2. <from-view-id>index.xhtml</from-view-id>

3. <navigation-case>

4. <from-outcome>go</from-outcome>

5. <if>#{defaultManager.ok}</if>

6. <to-view-id>/WEB-INF/go.xhtml</to-view-id>

7. </navigation-case>

8. <navigation-case>

9. <from-outcome>go</from-outcome>

10. <if>#{!defaultManager.ok}</if>

11. <to-view-id>/WEB-INF/nogo</to-view-id>

12. </navigation-case>

13. </navigation-rule>

Ici, nous avons donc une règle de navigation conditionnelle à partir de la page index.xhtml.

Si le retour est « go » et que la condition defaultManager.ok == true, alors on affichera la page /WEB-INF/go.xhtml.

Si la valeur defaultManager.ok == false, alors on affichera la page /WEB-INF/nogo.xhtml.

À noter que l’extension ‘.xhtml’ n’est pas obligatoire, c’est la valeur par défaut.

Si une redirection est nécessaire ou voulue, il faut alors ajouter la directive <redirect/> après <to-view-id>.

Dans le cas d’une redirection, il est impossible d’utiliser le répertoire /WEB-INF/ de l’application, ce dernier n’étant pas visible en dehors de l’application.

I-D-5-b - Navigation implicite

On peut directement passer la référence de la page à afficher au retour d’une action ou directement comme valeur de l’attribut action dans une balise.

Exemple simple

1. <h:commandLink action="/views/personne/recherche.xhtml" value="Action=chemin"/>

Exemple avec paramètres

1. <h:commandLink action="/views/personne/detail?faces-redirect=true&amp;uid=1" value="Action=chemin"/>

Là aussi, l’extension .xhtml est optionnelle.

Notez l’utilisation de &amp; pour le caractère & dans l’URL, sans cela, ça ne fonctionnera pas.

Le paramètre faces-redirect=true permet de signifier qu’on veut une redirection vers la page demandée.

I-D-5-c - Navigation par code

Lorsqu’une fonction est appelée par AJAX (cas d’un listener ou actionListener), le système de navigation standard ne fonctionne plus, il est alors possible d’obtenir un objet de navigation et de lui passer des paramètres éventuels pour appeler la page voulue.

Exemple

1. public void personneDetail()

2. {

3. ConfigurableNavigationHandler navigationHandler = (ConfigurableNavigationHandler) getFacesContext().getApplication().getNavigationHandler();

4. navigationHandler.performNavigation("/views/personne/detail.xhtml?faces-redirect=true&uid=1");

5. }

Là aussi, l’extension .xhtml est optionnelle.

Le paramètre faces-redirect=true permet de signifier qu’on veut une redirection vers la page demandée.

II - Internationalisation

L’internationalisation, i18n en abrégé (parce qu’il y a 18 lettres entre le i et le n) permet entre autre de modifier la langue de l’interface graphique grâce à des définitions de constantes dans des fichiers properties.

L’application embarque différentes versions d’un fichier, dans notre cas ce sera le fichier ApplicationResources.properties, avec un suffixe de langue pour les différencier.

À noter que le fichier sans suffixe sera défini comme celui par défaut si on ne dispose pas du fichier dans la langue demandée.

Quand on parle d’internationalisation, on ne parle pas que de langue mais également de régionalisation de la langue.

Pour exemple, en_GB représente l’anglais parlé en Grande-Bretagne alors que en_US représente l’anglais parlé aux États-Unis. Idem pour fr_FR et fr_CA ou fr_BE, fr_CH, etc.

Il est donc préférable de prévoir tout de suite la régionalisation, même si on se contente dans un premier temps que des langues au sens large.

Pour paramétrer les langues utilisées par l’application, on définira un bloc dans le fichier faces-config.xml dont voici un extrait :

Extrait de faces-config

<application>
<locale-config>
<default-locale>fr_FR</default-locale>
<supported-locale>fr_FR</supported-locale>
<supported-locale>en_GB</supported-locale>
</locale-config>
<resource-bundle>
<base-name>ApplicationResources</base-name>
<var>msg</var>
</resource-bundle>
</application>

Dans cet exemple, l’application définit deux langues, le français parlé en France et l’anglais parlé en Grande-Bretagne. La langue par défaut étant le français.

Ces paramètres s’appliquent au fichier dont le nom de base est ApplicationResources.

Lorsque l’utilisateur choisira l’anglais, l’application fera automatiquement référence au fichier ApplicationResources_en_GB.properties, si elle ne le trouve pas, elle cherchera dans ApplicationResources_fr_FR.properties, et si elle ne le trouve toujours pas, dans ApplicationsResources.properties.

Au niveau des pages de l’application, il faudra prévoir la balise <f:view locale="#{unManagerSession.locale}"> pour définir qu’on utilise l’internationalisation (avec la balise fermante bien sûr). Le manager associé DOIT être placé en scope session. L’attribut « locale » représente un objet java.util.Locale.

Le plus simple est de passer par une page template, ça évitera de dupliquer ce code dans toutes les pages.

Pour changer la langue de l’interface graphique, il suffira de remplacer l’objet Locale dans ce manager par celui correspondant à la langue voulue.

III - Application type : Gestion de personnes

Dans cet exemple très simple (mais qui donne une bonne idée de ce qu’on peut faire), nous allons gérer une base de données de personnes en utilisant :

- JSF 2.3

- Primefaces 6.2

- EJB 3.2

- JPA 2.1

Le serveur d’application utilisé est un Wildfly 15 qui s’exécute sur un OpenJDK 11.

Le système de navigation est de type code hybride, le code étant défini dans la classe abstraite AbstractManager.

Toutes les pages sont définies par une énumération laquelle renvoie à un identifiant de message dans le fichier de propriétés de l’application.

Ce système permettrait de différencier les sources des pages xhtml en fonction de la langue de l’interface, même si dans cet exemple, nous n’utiliserons pas cette possibilité.

Primefaces est une bibliothèque de composants graphiques spécifiques à JSF développée par PrimeTek Informatics, open source et libre d’utilisation sous licence Apache.

Elle est largement utilisée et extrêmement puissante tout en restant simple d’utilisation.

III-A - Création et configuration des projets

Pour notre application type, nous utiliserons trois projets :

- 1 projet EJB nommé MonProjetEJB
Ce projet sert à définir la couche métier de l’application. C’est ce projet qui fera le lien avec la base de données en utilisant les API JPA et JTA.
Une fois créé, faire un clic droit sur le projet ? Properties
Choisir Project Facets et cocher JPA (version 2.1) et ajuster s’il y a lieu les versions pour :

- EJB (version 3.2) ;

- Java (version 1.8 minimum).

persistence.xml

1. <?xml version="1.0" encoding="UTF-8"?>

2. <persistence version="2.1"

3. xmlns="http://xmlns.jcp.org/xml/ns/persistence"

4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

5. xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd">

7. <persistence-unit name="MonProjetEJBPU">

9. <jta-data-source>java:/MySQLDS</jta-data-source>

10. <properties>

11. <property name="org.hibernate.dialect" value="org.hibernate.dialect.MySQL5Dialect" />

12. </properties>

13. </persistence-unit>

14. </persistence>

Cliquer sur le bouton Apply and Close.
Le fichier persistence.xml sera créé automatiquement dans le répertoire /META-INF.
Finalement, il contiendra ceci :

- 1 projet Dynamic Web Module nommé MonProjetWeb
Ce projet sert à définir l’application IHM qui sera utilisée par les différents utilisateurs.
Une fois créé, faire un clic droit sur le projet ? Properties.
Choisir Project Facets et cocher JavaServer Faces (version 2.3) et ajuster s’il y a lieu les versions pour :

- Dynamic Web Module (version 4.0)

- Java (version 1.8 minimum) ;

- Javascript (version 1.0).

faces-config.xml

1. <?xml version="1.0" encoding="UTF-8"?>

2. <faces-config

3. xmlns="http://xmlns.jcp.org/xml/ns/javaee"

4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

5. xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_3.xsd"

6. version="2.3">

8. <application>

9. <resource-bundle>

10. <base-name>ApplicationResources</base-name>

11. <var>msg</var>

12. </resource-bundle>

13. <message-bundle>Messages</message-bundle>

14. </application>

15. </faces-config>

web.xml

1. <?xml version="1.0" encoding="UTF-8"?>

3. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0">

4. <display-name>MonProjetWeb</display-name>

6. <context-param>

7. <param-name>primefaces.THEME</param-name>

8. <param-value>omega</param-value>

9. </context-param>

10. <servlet>

11. <servlet-name>Faces Servlet</servlet-name>

12. <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>

13. <load-on-startup>1</load-on-startup>

14. </servlet>

15. <servlet-mapping>

16. <servlet-name>Faces Servlet</servlet-name>

17. <url-pattern>*.xhtml</url-pattern>

18. </servlet-mapping>

19. <welcome-file-list>

20. <welcome-file>index.xhtml</welcome-file>

21. </welcome-file-list>

22. </web-app>

Cliquez sur le bouton Apply and Close.
Le fichier faces-config.xml sera créé automatiquement dans le répertoire /WEB-INF
et la servlet Faces Servlet sera ajoutée au fichier web.xml avec les paramètres par défaut.
Finalement, nous aurons ces deux fichiers :

- 1 projet EAR nommé MonProjet
Ce projet sert à encapsuler les deux autres projets dans une archive déployable sur le serveur d’application.
Une fois créé, faire un clic droit sur le projet ? Java EE Tools ? Generate Deployment Descriptor Stub.
Le fichier application.xml sera créé dans le répertoire /META-INF.
Finalement, le fichier contiendra ceci :

application.xml

1. <?xml version="1.0" encoding="UTF-8"?>

2. <application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/application_8.xsd" version="8">

3. <display-name>MonProjet</display-name>

4. <module>

5. <web>

6. <web-uri>MonProjetWeb.war</web-uri>

7. <context-root>MonProjetWeb</context-root>

8. </web>

9. </module>

10. <module>

11. <ejb>MonProjetEJB.jar</ejb>

12. </module>

13. </application>

Par défaut, le nom du projet web est pris pour le nom de l’application, vous pouvez modifier la ligne <context-root> pour lui donner un nom plus représentatif, ici, nous pourrions mettre ‘personne’.

Lors de l’appel de l’application dans un navigateur, c’est ce nom qu’il faudra utiliser.

Pour nous, ce sera :

http://localhost:8080/MonProjetWeb/

- Structure des projets

III-B - Modèle de données

Les personnes possèdent une liste de numéros de téléphone, ces numéros sont typés (mobile, fixe, bureau, etc.)

Ci-dessous le schéma de relation des tables de l’application.

III-C - Scripts de création de la base de données (MySQL)

Script de création

1. create table olivier.civilite (

2. uid integer AUTO_INCREMENT not null,

3. abrege varchar(10) not null,

4. libelle varchar(64) not null,

6. primary key (uid)

7. );

9. insert into olivier.civilite (abrege, libelle) values ('M', 'Monsieur'), ('Mme', 'Madame'), ('Mlle', 'Mademoiselle'), ('Dr', 'Docteur'), ('Pr', 'Professeur'), ('Me', 'Maïtre'), ('Mgr', 'Monseigneur'), ('Vve', 'Veuve');

11. create table olivier.personne (

12. uid integer AUTO_INCREMENT not null,

13. uid_civilite integer not null,

14. genre char(1),

15. nom varchar(64) not null,

16. prenom varchar(64) not null,

17. adresse1 varchar(64),

18. adresse2 varchar(64),

19. code_postal varchar(15),

20. ville varchar(64),

21. maj_date timestamp not null default current_timestamp,

23. primary key (uid),

25. constraint check_genre check (genre in ('H', 'F')),

27. constraint fk_personne_civilite foreign key (uid_civilite)

28. references civilite (uid)

29. on delete restrict

30. on update restrict

31. );

33. create table olivier.telephone_type (

34. uid integer AUTO_INCREMENT not null,

35. code varchar(10) not null,

36. libelle varchar(64),

38. primary key (uid)

39. );

41. insert into olivier.telephone_type (code, libelle) values

42. ('MOBILE', 'Téléphone mobile'), ('FIXE', 'Téléphone fixe'),

43. ('BUREAU', 'Téléphone bureau');

45. create table olivier.personne_telephone (

46. uid integer AUTO_INCREMENT not null,

47. uid_personne integer not null,

48. uid_telephone_type integer not null,

49. numero varchar(15),

51. primary key (uid),

52. constraint fk_personne_telephone_personne foreign key (uid_personne)

53. references personne (uid)

54. on delete cascade

55. on update restrict,

56. constraint fk_personne_telephone_telephone_type foreign key (uid_telephone_type)

57. references telephone_type (uid)

58. on delete cascade

59. on update restrict

60. );

III-D - Classes utilitaires et abstraites de l’application

Il est largement recommandé de factoriser tout ce qui est récurrent dans les traitements soit sous la forme d’une classe utilitaire, soit sous la forme d’une classe abstraite qui sera étendue par la classe finale.

Dans cet exemple, nous utiliserons trois classes abstraites liées aux trois types de managed bean utilisés :

1. AbstractManager
Classe qui centralise toutes les propriétés et fonctions utiles à un contrôleur de page en particulier l’accès au bundle de ressources de l’application, le point de retour éventuel, l’accès aux pages de l’application, le formatage des messages, l’envoi de message, etc.

AbstractManager

1. public abstract class AbstractManager implements Serializable

2. {

3. public static final long serialVersionUID = 1;

4. public static final String REDIRECT_PART = "faces-redirect";

5. public static final String RETURN_POINT_PART = "rp";

6. public static final String UID_PART = "uid";

7. private String returnPoint;

8. private static String contextRoot;

10. /*

11. * ----- getter/setter

12. */

14. public String getContextRoot()

15. {

16. if (contextRoot == null)

17. {

18. contextRoot = "/" + getFacesContext().getExternalContext().getContextName();

19. }

21. return contextRoot;

22. }

24. public String getReturnPoint()

25. {

26. return returnPoint;

27. }

29. public void setReturnPoint(String returnPoint)

30. {

31. this.returnPoint = returnPoint;

32. }

34. public ResourceBundle getResourceBundle()

35. {

36. FacesContext facesContext = FacesContext.getCurrentInstance();

37. return getFacesContext().getApplication().getResourceBundle(facesContext, "msg");

38. }

40. public String getResourceBundleMessage(String key)

41. {

42. ResourceBundle bundle = getResourceBundle();

43. if (bundle.containsKey(key))

44. {

45. return bundle.getString(key);

46. }

47. return key;

48. }

50. public FacesContext getFacesContext()

51. {

52. return FacesContext.getCurrentInstance();

53. }

55. public Locale getLocale()

56. {

57. Locale locale = null;

58. try

59. {

60. locale = getFacesContext().getViewRoot().getLocale();

61. }

62. catch (Exception e)

63. {

64. try

65. {

66. locale = getFacesContext().getExternalContext().getRequestLocale();

67. }

68. catch (Exception e2)

69. {

70. locale = new Locale("fr", "FR");

71. }

72. }

73. return locale;

74. }

77. /*

78. * ----- méthodes

79. */

81. /**

82. * Formatage de l'URL de retour à l'appelant

83. *

84. * @param redirect

85. * @return

86. */

87. public String formatToCaller(boolean redirect)

88. {

89. if (!Utils.isSet(returnPoint))

90. {

91. return null;

92. }

93. return formatURL(getPageURL(ApplicationPagesNamesEnum.valueOf(returnPoint)), redirect);

94. }

96. /**

97. * Formatage de l'URL avec ou sans redirection

98. *

99. * @param url

100. * @param redirect

101. * @return

102. */

103. public String formatURL(String url, boolean redirect)

104. {

105. if (!Utils.isSet(url))

106. {

107. return null;

108. }

109. if (redirect)

110. {

111. return addURLParameter(new StringBuilder(url), REDIRECT_PART, true).toString();

112. }

113. return url;

114. }

116. /**

117. * Ajout d'un paramètre à l'URL

118. *

119. * @param url

120. * @param attributeName

121. * @param attributeValue

122. * @return

123. */

124. public StringBuilder addURLParameter(StringBuilder url, String attributeName, Object attributeValue)

125. {

126. if (!Utils.isSet(url))

127. {

128. return null;

129. }

131. if (!Utils.isSet(attributeName))

132. {

133. return url;

134. }

136. if (url.indexOf("?") == -1)

137. {

138. url.append("?");

139. }

140. else

141. {

142. url.append("&");

143. }

145. url.append(attributeName).append("=");

147. if (Utils.isSet(attributeValue))

148. {

149. url.append(attributeValue.toString());

150. }

152. return url;

153. }

155. /**

156. * Formatage de l'URL standard d'appel d'un manager

157. *

158. * @param url

159. * @param redirect

160. * @param returnPointURL

161. * @param uid

162. * @return

163. */

164. public String formatStandardCallURL(String url, boolean redirect, String returnPointURL, Integer uid)

165. {

166. StringBuilder sb = new StringBuilder();

167. sb.append(url);

169. if (redirect)

170. {

171. addURLParameter(sb, REDIRECT_PART, true);

172. }

174. if (returnPointURL != null)

175. {

176. addURLParameter(sb, RETURN_POINT_PART, returnPointURL);

177. }

179. if (uid != null)

180. {

181. addURLParameter(sb, UID_PART, uid);

182. }

184. return sb.toString();

185. }

187. /**

188. * Navigation par programmation

189. *

190. * @param url

191. * @param redirect

192. * @param returnPointURL

193. * @param uid

194. */

195. public void navigateTo(String url, boolean redirect, String returnPointURL, Integer uid)

196. {

197. ConfigurableNavigationHandler navigationHandler = (ConfigurableNavigationHandler) getFacesContext()

198. .getApplication().getNavigationHandler();

199. navigationHandler.performNavigation(formatStandardCallURL(url, redirect, returnPointURL, uid));

200. }

202. /**

203. * Récupération de l'URL associée à l'enum

204. *

205. * @param page

206. * @return

207. */

208. public String getPageURL(ApplicationPagesNamesEnum page)

209. {

210. String url = getResourceBundleMessage(page.toString());

211. return url;

212. }

214. /**

215. * Envoi d'un message

216. *

217. * @param text            : Texte ou identifiant de message dans le fichier

218. *                        ApplicationResources.properties

219. * @param severity        : Gravité du message

220. * @param useFlashContext : Utilisation du contexte flash (dans le cadre d'une

221. *                        redirection)

222. */

223. public void sendFacesMessage(String text, Severity severity, boolean useFlashContext)

224. {

225. FacesContext facesContext = getFacesContext();

227. facesContext.getExternalContext().getFlash().setKeepMessages(useFlashContext);

229. text = getResourceBundleMessage(text);

231. if (severity == null)

232. {

233. severity = FacesMessage.SEVERITY_INFO;

234. }

236. FacesMessage facesMessage = new FacesMessage(severity, null, text);

238. facesContext.addMessage(null, facesMessage);

239. }

241. /**

242. * Envoi d'un message lié à une Exception

243. *

244. * @param e               : L'Exception à traiter

245. * @param useFlashContext : Utilisation du contexte flash (dans le cadre d'une

246. *                        redirection)

247. */

248. public void sendFacesMessage(Exception e, boolean useFlashContext)

249. {

250. FacesContext facesContext = getFacesContext();

252. facesContext.getExternalContext().getFlash().setKeepMessages(useFlashContext);

254. if (e instanceof ValidationException)

255. {

256. for (CauseException cause : ((ValidationException) e).getCauses())

257. {

258. FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_ERROR, cause.toString(),

259. formatMessage(cause.getLibelle(), cause.getParameters()));

260. facesContext.addMessage(null, facesMessage);

261. }

262. }

263. else

264. {

265. FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_ERROR, e.toString(), e.toString());

266. facesContext.addMessage(null, facesMessage);

267. }

268. }

270. /**

271. * Formatage d'un message avec d'éventuels paramètres

272. *

273. * @param message    : Texte du message ou identifiant de message dans le

274. *                   fichier ApplicationResources.properties

275. * @param parameters : Tableau de paramètres ou null

276. * @return Le message formaté

277. */

278. public String formatMessage(String message, Object[] parameters)

279. {

280. String formatted = message;

281. int p1, p2 = 0;

282. String value = "";

284. try

285. {

286. if (getResourceBundle().containsKey(message))

287. {

288. formatted = getResourceBundle().getString(message);

289. }

291. while ((p1 = formatted.indexOf("{")) != -1)

292. {

293. p2 = formatted.indexOf("}", p1);

294. int idx = Integer.valueOf(formatted.substring(p1 + 1, p2));

295. if (idx < parameters.length)

296. {

297. value = parameters[idx].toString();

298. }

299. else

300. {

301. value = "";

302. }

303. value = getResourceBundleMessage(value);

304. formatted = formatted.substring(0, p1) + value + formatted.substring(p2 + 1);

305. }

306. }

307. catch (Exception e)

308. {

309. }

310. return formatted;

311. }

312. }

2. AbstractRechercheDataModel
Classe qui centralise toutes les fonctions utiles à la gestion d’une liste pour un composant dataTable de Primefaces.

AbstractRechercheDataModel

1. public class AbstractRechercheDataModel<T> extends LazyDataModel<T>

2. {

3. public static final long serialVersionUID = 1;

4. @Override

5. public T getRowData(String rowKey)

6. {

7. for (T dto : getWrappedData())

8. {

9. if (dto.hashCode() == Integer.valueOf(rowKey))

10. {

11. return dto;

12. }

13. }

14. return null;

15. }

16. @Override

17. public Object getRowKey(T object)

18. {

19. return object == null ? null : object.hashCode();

20. }

21. }

3. AbstractRechercheOptions
Classe qui centralise toutes les propriétés et fonctions utiles pour les options d’un dataTable de Primefaces.

AbstractRechercheOptions

1. public class AbstractRechercheOptions implements Serializable

2. {

3. public static final long serialVersionUID = 1;

4. private int first;

5. private int pageSize = 20;

6. private String sortField;

7. private String sortOrder;

8. private boolean changed;

10. public void checkChanged(Object object1, Object object2)

11. {

12. if (Utils.isDifferent(object1, object2))

13. {

14. setChanged(true);

15. }

16. }

18. public boolean isChanged()

19. {

20. return changed;

21. }

23. public void setChanged(boolean changed)

24. {

25. this.changed = changed;

26. }

28. public int getFirst()

29. {

30. return first;

31. }

33. public void setFirst(int first)

34. {

35. this.first = first;

36. }

38. public int getPageSize()

39. {

40. return pageSize;

41. }

43. public void setPageSize(int pageSize)

44. {

45. this.pageSize = pageSize;

46. }

48. public String getSortField()

49. {

50. return sortField;

51. }

53. public void setSortField(String sortField)

54. {

55. this.sortField = sortField;

56. }

58. public String getSortOrder()

59. {

60. return sortOrder;

61. }

62. public void setSortOrder(String sortOrder)

63. {

64. this.sortOrder = sortOrder;

65. }

66. public void forceLoad(AjaxBehaviorEvent event)

67. {

68. setChanged(true);

69. }

70. }

4. LocaleManager
Classe qui permet de gérer la langue de l’interface de l’application.
Dans la méthode postConstruct, on récupère toutes les langues gérées par l’application et définies dans le fichier faces-config.xml.

LocaleManager

@Named
@SessionScoped
public class LocaleManager implements Serializable
{
public static final long serialVersionUID = 1;
private List<Locale> locales = new ArrayList<>();
private Locale locale;

@PostConstruct
public void postConstruct()
{
Iterator<Locale> it = FacesContext.getCurrentInstance().getApplication().getSupportedLocales();
while (it.hasNext())
{
locales.add(it.next());
}
}

public Locale getLocale()
{
if (locale == null)
{
try
{
FacesContext facesContext = FacesContext.getCurrentInstance();
locale = facesContext.getViewRoot().getLocale();
if (locale == null)
{
locale = facesContext.getExternalContext().getRequestLocale();
}
}
catch (Exception e) {}
if (locale == null)
{
locale = Locale.FRANCE;
}
}
return locale;
}

public void setLocale(Locale locale)
{
this.locale = locale;
}

public List<Locale> getLocales()
{
return locales;
}

public void setLocales(List<Locale> locales)
{
this.locales = locales;
}

public void changeLocale(String language)
{
changeLocale(language, language.toUpperCase());
}

public void changeLocale(String language, String country)
{
Locale locale = new Locale(language, country);
setLocale(locale);
}

public ResourceBundle getResourceBundle()
{
FacesContext facesContext = FacesContext.getCurrentInstance();
return facesContext.getApplication().getResourceBundle(facesContext, "msg");
}
public String getLocaleName(String key)
{
ResourceBundle bundle = getResourceBundle();
if (bundle.containsKey(key))
{
return bundle.getString(key);
}
return key;
}
}

5. Exemple d’utilisation dans le template :

Exemple de changement de Locale

<p:commandButton id="language" value="Langues"/>
<p:overlayPanel for="language" dynamic="true" style="background-color:#f0f0f0">
<ui:repeat value="#{localeManager.locales}" var="loc">
<p:commandLink title="#{localeManager.getLocaleName(loc.language)}"
actionListener="#{localeManager.changeLocale(loc.language, loc.country)}"
oncomplete="window.location.replace(window.location)"
style="text-decoration:none">
<p:graphicImage value="/resources/images/#{loc.language}_#{loc.country}.png"/>
</p:commandLink>
<br/>
</ui:repeat>
</p:overlayPanel>

Pour les classes utilitaires, nous utiliserons deux classes :

1. QueryUtils
Fonctions liées à l’ajout conditionnel de filtre pour la requête JPQL.

2. Utils
Différentes fonctions transversales, ici les fonctions :
isSet(Object)
Permet de savoir si le paramètre est positionné.
Pour un paramètre String, savoir s’il y a effectivement un contenu et pas une chaîne vide.
isDifferent(Object, Object)
Permet de déterminer si les deux paramètres sont différents.

III-E - Modèle JPA

Sans entrer dans le détail de JPA (qui nécessite un cours à lui tout seul), l’API de persistance utilise un jargon spécifique.

On parlera d’Entity pour la classe Java représentant l’enregistrement de la table de base de données (et ses liens éventuels) et d’EntityManager pour l’objet qui sert à manipuler ces entités.

L’Entity, dans sa plus simple expression, est une classe Java (pojo) avec des annotations spécifiques pour lier les propriétés de la classe aux colonnes de la table.

Exemple de la table Civilite

1. @Entity

2. @Table(name = "civilite", schema = "olivier")

3. public class Civilite implements java.io.Serializable, EntityUID

4. {

5. private static final long serialVersionUID = 1;

6. private Integer uid;

7. private String abrege;

8. private String libelle;

10. public Civilite()

11. {

12. super() ;

13. }

15. @Id

16. @GeneratedValue(strategy = GenerationType.IDENTITY)

17. @Column(name = "UID", unique = true, nullable = false)

18. public Integer getUid()

19. {

20. return this.uid;

21. }

23. public void setUid(Integer uid)

24. {

25. this.uid = uid;

26. }

28. @Column(name = "ABREGE", nullable = false, length = 10)

29. public String getAbrege()

30. {

31. return this.abrege;

32. }

34. public void setAbrege(String abrege)

35. {

36. this.abrege = abrege;

37. }

38. @Column(name = "LIBELLE", nullable = false, length = 64)

39. public String getLibelle()

40. {

41. return this.libelle;

42. }

43. public void setLibelle(String libelle)

44. {

45. this.libelle = libelle;

46. }

47. }

@Entity permet de qualifier la classe comme étant une entité JPA.

@Table permet de faire le lien avec la table de base de données.

@Column permet de qualifier la colonne cible dans la table.

@Id permet de désigner la clé primaire de l’enregistrement.

@GeneratedValue sert à préciser le type de génération automatique de la valeur.

JPA s’appuie sur un fichier de configuration nommé persistence.xml.

persistence.xml

1. <?xml version="1.0" encoding="UTF-8"?>

2. <persistence version="2.1"

3. xmlns="http://xmlns.jcp.org/xml/ns/persistence"

4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

5. xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd">

7. <persistence-unit name="MonProjetEJBPU">

9. <jta-data-source>java:/MySQLDS</jta-data-source>

10. <properties>

11. <property name="org.hibernate.dialect" value="org.hibernate.dialect.MySQL5Dialect" />

12. </properties>

13. </persistence-unit>

14. </persistence>

Ce fichier permet de paramétrer la ou les unités de persistance de l’application.

Il fait le lien avec la source de données (définie dans le serveur d’application), le type de gestionnaire de transaction (ici JTA) ainsi que des propriétés additionnelles liées à l’implémentation utilisée (ici Hibernate).

Le nom de l’unité de persistance sera dans notre cas ‘MonProjetEJBPU’, ce nom sera utilisé dans les EJB pour récupérer l’EntityManager.

Référencement

1. @Stateless

2. public class MonProjetFacade implements MonProjetFacadeLocal

3. {

4. @PersistenceContext(name = "MonProjetEJBPU")

5. private EntityManager entityManager;

6. ...

7. }

Pour plus de détail, je vous invite à consulter les tutoriels suivants :

https://www.jmdoudoux.fr/java/dej/chap-jpa.htm

https://tahe.developpez.com/java/jpa/?page=page

III-F - La couche d’accès aux données (EJB métier)

Dans un projet Jakarta EE, l’accès aux données se fait par l’intermédiaire d’EJBs session (Enterprise Java Bean), stateless ou stateful.

L’EJB stateless ne conserve pas d’état entre deux appels.

Pour l’EJB stateful, l’état est conservé entre plusieurs appels.

Dans le cas d’une application web, je vous conseille d’utiliser un EJB stateless.

Un EJB peut être appelé localement ou à distance.

Dans le cas d’un appel local, le passage des paramètres se fait par référence (plus rapide). Dans le cas d’un appel distant (autre jvm), le passage des paramètres se fait par valeur (plus lent du fait de la sérialisation/désérialisation et des couches traversées).

Si la couche EJB et la couche web s’exécutent sur des serveurs dédiés, vous n’aurez d’autre choix que de passer par des appels distants.

Si, comme dans notre exemple, les deux couches sont exécutées sur le même serveur, je vous conseille l’appel local.

La mise en œuvre va dépendre de l’interface utilisée.

Pour un appel distant, on utilisera l’interface avec l’annotation @Remote, pour un appel local, on utilisera l’interface avec l’annotation @Local.

Si les méthodes sont les mêmes, qu’elles soient appelées localement ou à distance, on peut utiliser l’héritage entre les interfaces pour n’avoir qu’une liste de méthodes à gérer.

Exemple

1. @Local

2. public interface MonProjetFacadeLocal

3. {

4. public QueryResult<DTOPersonne> recherchePersonnes(String prenom, String nom, Character sexe, boolean count, int first, int pageSize, String sortField, String sortOrder);

5. public DTOPersonne getPersonne(Integer uid);

6. public DTOPersonne saveOrUpdatePersonne(DTOPersonne dto) throws Exception;

7. public void deletePersonne(Integer uid) throws Exception;

9. public QueryResult<DTOCivilite> rechercheCivilites(String abreviation, String libelle,     boolean count, int first, int pageSize, String sortField, String sortOrder);

10. public DTOCivilite getCivilite(Integer uid);

11. public QueryResult<DTOTelephoneType> rechercheTelephoneTypes(boolean count, int first, int pageSize, String sortField, String sortOrder);

12. public DTOTelephoneType getTelephoneType(Integer uid);

13. }

14. @Remote

15. public interface MonProjetFacadeRemote extends MonProjetFacadeLocal

16. {

17. }

Petite précision qui a son importance :

Une application web s’exécute dans le conteneur web, l’EJB lui s’exécute dans un conteneur d’EJB.

À chaque fois que vous passez du conteneur web au conteneur d’EJB, vous créez un contexte d’exécution dans le conteneur EJB (acquisition de l’EntityManager, donc d’une connexion, etc.), et à la sortie de l’EJB, la transaction sera validée (commit).

Ces appels ont un coût non négligeable, surtout s’ils sont faits dans une boucle ou séquentiellement pour faire des vérifications successives depuis un ManagedBean.

Il est largement recommandé d’utiliser le pattern « Façade » dans un environnement de ce type, et d’enchaîner les actions derrière la façade.

Exemple

1. @Named

2. public class MaClasse

3. {

4. @EJB

5. private MaFacadeLocal facade ;

6. private MonBean monBean ;

7. ...

8. public boolean modifier()

9. {

10. if (facade.getUtilisateur().isAdmin())

11. {

12. facade.save(monBean) ;

13. return true ;

14. }

15. }

16. return false ;

17. }

Dans cet exemple, on a deux appels successifs à l’EJB ce qui créera deux initialisations du contexte EJB.

Il est préférable de faire comme ceci :

Exemple

1. @Named

2. public class MaClasse

3. {

4. @EJB

5. private MaFacadeLocal facade ;

6. private MonBean monBean ;

7. ...

8. public boolean modifier()

9. {

10. return facade.modifier(monBean) ;

11. }

12. }

où la méthode modifier(monBean) enchaînera les deux appels précédents.

III-F-1 - Façade de l’application

La façade d’une application web est donc le point d’accès unique entre le conteneur web et le conteneur d’EJB. Toutes les méthodes nécessaires à la gestion des données issues de la base de données sont donc définies ici.

Elles peuvent juste faire le lien avec des méthodes d’EJB spécialisées, ici ejbPersonne, ejbTelephoneType et ejbCivilite ou être définies directement dans la façade (c’est le cas des méthodes de recherche de notre exemple d’application).

Façade

1. @Stateless

2. public class MonProjetFacade implements MonProjetFacadeLocal

3. {

4. @PersistenceContext(name = "MonProjetEJBPU")

5. private EntityManager entityManager;

7. @EJB

8. private PersonneFacadeLocal ejbPersonne;

9. @EJB

10. private TelephoneTypeFacadeLocal ejbTelephoneType;

11. @EJB

12. private CiviliteFacadeLocal ejbCivilite;

13. …

14. }

Les données utilisées par l’application web sont définies sous la forme de DTO (Data Transfer Object). Certains argueront que c’est une duplication des classes Entity inutiles, personnellement, je trouve que l’isolation que ça entraîne par rapport au modèle de données et les possibilités de redéfinition de certains types obsolètes issus de vieilles bases de données sont des avantages suffisants pour continuer à utiliser ce pattern. De plus, l’application peut n’utiliser qu’une partie des données du modèle, le DTO sera l’exact reflet de ce que l’application consomme. Dernier intérêt, avec le pattern DTO, fini les erreurs liées au lazy loading de sous-entités dans le conteneur de servlet.

La conversion des classes Entity vers les classes DTO (et inversement) se fait par des méthodes spécialisées, personne2DTOPersonne, dtoPersonne2Personne, telephoneType2DTOTelephoneType, dtoTelephoneType2TelephoneType, etc.

Les EJB spécialisés manipulant des Entités, la conversion se fait dans les deux sens par les méthodes de la façade.

Exemple

1. public DTOPersonne saveOrUpdatePersonne(DTOPersonne dtoPersonne) throws Exception

2. {

3. Personne personne = dtoPersonne2Personne(dtoPersonne);

4. personne = ejbPersonne.saveOrUpdate(personne);

5. return personne2DTOPersonne(personne);

6. }

III-F-2 - EJB spécialisés

Dans l’application type, la gestion des différentes entités est confiée à des EJB spécialisés qui étendront la classe abstraite AbstractFacade.

Cette dernière inclut toutes les propriétés communes à l’interface DB, avec en particulier l’objet EntityManager.

Elle définit également toutes les méthodes de gestion d’une classe Entity :

- T get(Integer uid)
Récupération de l’entity par son UID (clé primaire incrémentale).

- void delete(T entity)
Suppression d’une entité.

- void delete(Integer uid)
Suppression d’une entité par son UID.

- T saveOrUpdate(T entity)
Sauvegarde ou modification d’une entité.

- void check(T entity, PersistenceModeEnum mode)
Méthode standard de contrôle d’une entité en fonction des annotations des attributs.

La mise en œuvre est très simple, il suffit de créer une classe étendant AbstractFacade en précisant le type de l’entité gérée.

Exemple

1. @Stateless

2. public class PersonneFacade extends AbstractFacade<Personne> implements PersonneFacadeLocal

3. {

4. ...

5. }

En cas de besoin, il suffira de redéfinir la méthode pour l’adapter à la demande spécifique.

III-F-3 - Requête variable d’extraction d’enregistrements

Pour exécuter des recherches en JPQL, il existe plusieurs façons de faire et d’objets dédiés à cet effet comme :

- Query natif
entityManager.createNativeQuery(String query)

- Query JPQL
entityManager.createQuery(String query)

- Query nommé
entityManager.createNamedQuery(String name)

- Criteria
entityManager.getCriteriaBuilder()

Personnellement, dans un contexte web, j’ai une préférence pour le query JPQL, avec l’aide de la classe utilitaire QueryUtils pour simplifier la création et l’exploitation de l’objet Query.

Exemple

1. public QueryResult<DTOPersonne> recherchePersonnes(String prenom, String nom, Character genre, boolean count, int first, int pageSize, String sortField, String sortOrder)

2. {

3. QueryResult<DTOPersonne> result = new QueryResult<>();

4. StringBuilder sb = new StringBuilder();

6. if (count)

7. {

8. StringBuilder sbCount = new StringBuilder(sb);

9. sbCount.append("select count(a) from Personne a where 1=1");

10. QueryUtils.addQueryParameter(sbCount, "a.genre", "genre", "and", "=", genre);

11. QueryUtils.addQueryParameter(sbCount, "a.prenom", "prenom", "and",     "like", prenom);

12. QueryUtils.addQueryParameter(sbCount, "a.nom", "nom", "and", "like", nom);

14. Query queryCount = entityManager.createQuery(sbCount.toString());

16. QueryUtils.setQueryParameter(queryCount, "genre", genre);

17. QueryUtils.setQueryParameter(queryCount, "prenom", prenom);

18. QueryUtils.setQueryParameter(queryCount, "nom", nom);

20. result.setTotalRecords((Long) queryCount.getSingleResult());

21. }

22. sb.append("select a from Personne a where 1=1");

24. QueryUtils.addQueryParameter(sb, "a.genre", "genre", "and", "=", genre);

25. QueryUtils.addQueryParameter(sb, "a.prenom", "prenom", "and", "like", prenom);

26. QueryUtils.addQueryParameter(sb, "a.nom", "nom", "and", "like", nom);

28. Query query = entityManager.createQuery(sb.toString());

30. QueryUtils.setQueryParameter(query, "genre", genre);

31. QueryUtils.setQueryParameter(query, "prenom", prenom);

32. QueryUtils.setQueryParameter(query, "nom", nom);

34. if (first > 0)

35. {

36. query.setFirstResult(first);

37. }

38. if (pageSize > 0)

39. {

40. query.setMaxResults(pageSize);

41. }

42. for (Personne personne : (List<Personne>) query.getResultList())

43. {

44. result.getRecords().add(personne2DTOPersonne(personne));

45. }

46. return result;

47. }

Cet exemple montre la mise en œuvre des doubles requêtes nécessaires à l’objet paginator d’un dataTable de Primefaces.

On a besoin de connaître le nombre total d’enregistrements répondant aux critères de recherche (paramètre count = true) et d’extraire les n enregistrements d’un bloc à partir d’une position donnée.

L’objet QueryUtils permet de simplifier la syntaxe de création d’une chaîne de requête, si le paramètre est null ou vide, l’argument est ignoré, sinon, il est pris en compte.

Exemple

QueryUtils.addQueryParameter(sb, "a.genre", "genre", "and", "=", genre);

Si genre est non null, on ajoute à sb (le StringBuilder représentant la requête) la condition pour la propriété de l’entité ‘a.genre’ avec comme nom de paramètre ‘genre’ et comme comparateur ‘=’.

À l’arrivée, on aura donc :

Exemple

1. select a from Personne a where 1=1         // partie commune

2. and a.genre = :genre

Après avoir créé l’objet Query, la méthode

Exemple

1. QueryUtils.setQueryParameter(query, "genre", genre);

ajoutera le paramètre si celui-ci est non null et non vide.

III-F-4 - Passage des erreurs de l’EJB à l’IHM

Laisser les EJB gérer les contrôles d’intégrité des données me semble être une bonne pratique, la couche métier est censée être la barrière ultime.

Ce principe a le désavantage d’envoyer des données issues de la page alors que les composants graphiques auraient été capables de faire certains contrôles basiques.

L’autre problème est que l’EJB ne peut envoyer qu’une seule Exception en cas d’erreur et elle devrait contenir les explications sur les problèmes rencontrés.

Dans notre application, la classe ValidationException est l’objet qui informera d’une erreur de validation. Cette ValidationException contient une liste de CauseException, laquelle définit de manière détaillée l’erreur rencontrée.

Exemple de contrôle

1. ValidationException ve = new ValidationException() ;

3. /*

4. * Test de l'unicité du code

5. */

6. if (Utils.isSet(entity.getAbrege()))

7. {

8. StringBuilder sb = new StringBuilder();

9. sb.append("select count(a) from Civilite a where upper(a.abrege) = upper(:abrege)");

11. QueryUtils.addQueryParameter(sb, "a.uid", "uid", "and", "<>", entity.getUid());

13. Query query = getEntityManager().createQuery(sb.toString());

15. query.setParameter("abrege", entity.getAbrege());

16. QueryUtils.setQueryParameter(query, "uid", entity.getUid());

17. Number count = (Number)query.getSingleResult();

18. if (count.intValue() > 0)

19. {

20. ve.addCauseException(new CauseException("exception.duplicate", new Object[]{"civilite.abrege", entity.getAbrege()}));

21. }

22. }

23. if (ve.hasErrors())

24. {

25. throw ve ;

26. }

Le fichier properties de l’application contiendra la définition du message exception.duplicate :

Exemple

exception.duplicate={0} : la valeur {1} a déjà été attribuée

qui contient deux paramètres représentant le libellé du champ et la valeur conflictuelle du code.

Du côté IHM, le managedBean devra convertir l’exception en messages compréhensibles par le composant <p:growl> de Primefaces.

Notre classe AbstractManager contient une méthode sendFacesMessage(Exception, boolean) qui se chargera de cette opération.

Exemple

1. public void sendFacesMessage(Exception e, boolean useFlashContext)

2. {

3. FacesContext facesContext = getFacesContext();

5. facesContext.getExternalContext().getFlash().setKeepMessages(useFlashContext);

6. if (e instanceof ValidationException)

7. {

8. for (CauseException cause : ((ValidationException)e).getCauses())

9. {

10. FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_ERROR, cause.toString(), formatMessage(cause.getLibelle(), cause.getParameters()));

11. facesContext.addMessage(null, facesMessage);

12. }

13. }

14. else

15. {

16. FacesMessage facesMessage = new FacesMessage(FacesMessage.SEVERITY_ERROR, e.toString(), e.toString());

17. facesContext.addMessage(null, facesMessage);

18. }

19. }

La méthode formatMessage(…) s’occupe de rechercher la définition du message et de remplacer les paramètres par leur valeur dans la liste des paramètres de l’objet CauseException.

III-G - Le template de l’application

Ce template contient deux parties, l’en-tête et le corps de la page. Il centralise toutes les références des pages comme les scripts, les css, les messages, etc.

Template de l'application

1. <?xml version="1.0" encoding="UTF-8"?>

2. <!DOCTYPE html>

4. <html xmlns="http://www.w3.org/1999/xhtml"

5. xmlns:h="http://java.sun.com/jsf/html"

6. xmlns:f="http://java.sun.com/jsf/core"

7. xmlns:ui="http://java.sun.com/jsf/facelets"

8. xmlns:p="http://primefaces.org/ui">

10. <h:head>

12. <h:outputStylesheet library="css" name="omega-specific.css"/>

13. <h:outputScript library="javascript" name="monProjet.js"/>

14. <f:loadBundle var="msg" basename="ApplicationResources"/>

16. <title>Mon projet</title>

17. </h:head>

19. <h:body>

21. <div id="top">

22. <h:form id="formTop">

23. <p:growl id="growl" keepAlive="true" showDetail="true" showSummary="false">

24. <p:autoUpdate/>

25. </p:growl>

27. <ui:insert name="top">

28. <span style="cursor:pointer" title="#{msg['navigation.accueil']}" onclick="contextRoot('#{defaultManager.contextRoot}')">

29. <h:outputText value="#{msg['application.titre']}" styleClass="applicationTitle"/>

30. </span>

31. <p:clock />

32. </ui:insert>

34. <p:menubar>

35. <p:submenu label="#{msg['menu.personne']}">

36. <p:menuitem value="#{msg['menu.personne.rechercher']}" action="#{personneRechercheManager.display()}"/>

37. </p:submenu>

38. <p:submenu label="#{msg['menu.administration']}">

39. <p:menuitem value="#{msg['menu.administration.civilites']}" action="#{administrationCivilitesManager.display()}"/>

40. <p:menuitem value="#{msg['menu.administration.types.telephones']}" action="#{administrationTelephonesManager.display()}"/>

41. </p:submenu>

42. </p:menubar>

43. </h:form>

44. </div>

46. <div id="content">

47. <div class="pageTitle"><ui:insert name="title"/></div>

48. <ui:insert name="content"/>

49. </div>

50. </h:body>

51. </html>

Tout en étant extrêmement simple, voire simpliste, le template illustre la manière d’utiliser facelet.

III-H - Le module de recherche de personnes

La page de recherche permet d’appliquer des critères de recherche et affiche la liste des personnes répondant à ces critères.

Nous utiliserons ici trois ManagedBean pour réaliser ce module. On pourrait le faire avec moins mais dans ma conception des choses, trois, c’est mieux.

Les beans et leur fonction :

- PersonneRechercheManager
C’est le contrôleur de la page, son scope peut être choisi entre @RequestScoped et éventuellement @ViewScoped.

- PersonneRechercheDataModel
La classe chargée de fournir les données de la liste. Son scope sera @ViewScoped, ce qui permettra de recharger la liste de manière simple lorsque nous reviendrons à la liste après avoir affiché le détail d’une personne.

- PersonneRechercheOptions
La classe chargée de conserver les critères de recherche. Son scope sera donc @SessionScoped, il me paraît naturel de retrouver les derniers critères utilisés lorsqu’on revient à ce module (mais ça se discute, libre à vous de faire autrement).

III-H-1 - PersonneRechercheManager

Le contrôleur de page se charge d’afficher la page xhtml adéquate et d’appeler le module de gestion du détail d’une personne dans deux modes :

- création d’une nouvelle personne ;

- modification d’une personne.

Manager

1. @Named

2. @ViewScoped

3. public class PersonneRechercheManager extends AbstractManager

4. {

5. public static final long serialVersionUID = 1;

7. public String display()

8. {

9. return formatURL(getPageURL(ApplicationPagesNamesEnum.PERSONNE_RECHERCHE), true);

10. }

12. public void onRowClick(SelectEvent event)

13. {

14. DTOPersonne dtoPersonne = (DTOPersonne)event.getObject();

15. if (dtoPersonne != null)

16. {

17. navigateTo(getPageURL(ApplicationPagesNamesEnum.PERSONNE_DETAIL), true, ApplicationPagesNamesEnum.PERSONNE_RECHERCHE.name(), dtoPersonne.getUid());

18. }

19. }

20. public void create()

21. {

22. navigateTo(getPageURL(ApplicationPagesNamesEnum.PERSONNE_DETAIL), true, ApplicationPagesNamesEnum.PERSONNE_RECHERCHE.name(), null);

23. }

24. }

III-H-2 - PersonneRechercheOptions

Ce managed bean s’occupe de stocker les critères de recherche.

Lors de l’affectation d’une valeur à un critère, la méthode checkChanged, héritée de AbstractRechercheOptions, teste si la valeur a changé et monte un flag.

Options

1. @Named

2. @SessionScoped

3. public class PersonneRechercheOptions extends AbstractRechercheOptions

4. {

5. private static final long serialVersionUID = 1;

6. private Character genre;

7. private String prenom;

8. private String nom;

9. private DTOPersonne selected;

11. public PersonneRechercheOptions()

12. {

13. super();

14. }

16. public Character getGenre()

17. {

18. return genre;

19. }

21. public void setGenre(Character genre)

22. {

23. checkChanged(genre, this.genre);

24. this.genre = genre;

25. }

27. public String getPrenom()

28. {

29. return prenom;

30. }

32. public void setPrenom(String prenom)

33. {

34. checkChanged(prenom, this.prenom);

35. this.prenom = prenom;

36. }

38. public String getNom()

39. {

40. return nom;

41. }

43. public void setNom(String nom)

44. {

45. checkChanged(nom, this.nom);

46. this.nom = nom;

47. }

48. public DTOPersonne getSelected()

49. {

50. return selected;

51. }

52. public void setSelected(DTOPersonne selected)

53. {

54. this.selected = selected;

55. }

56. }

III-H-3 - PersonneRechercheDataModel

Ce managed bean s’occupe de fournir les données au dataTable de la page.

Il est conçu en rapport avec le composant dataTable de Primefaces paramétré en chargement tardif, avec un paginator pour charger les enregistrements par bloc de n enregistrements.

DataModel

1. @Named

2. @ViewScoped

3. public class PersonneRechercheDataModel extends AbstractRechercheDataModel<DTOPersonne>

4. {

5. private static final long serialVersionUID = 1;

6. @Inject

7. private PersonneRechercheOptions options;

8. @EJB

9. private MonProjetFacadeLocal facade;

11. @PostConstruct

12. public void postConstruct()

13. {

14. options.setChanged(true);

15. }

17. @Override

18. public List<DTOPersonne> load(int first, int pageSize, String sortField, SortOrder sortOrder, Map<String, Object> filters)

19. {

20. boolean count = options.isChanged() ? true : false;

21. options.setFirst(first);

22. options.setPageSize(pageSize);

23. options.setSortField(sortField);

24. options.setSortOrder(sortOrder == null ? null : sortOrder.name());

26. QueryResult<DTOPersonne> result = facade.recherchePersonnes(QueryUtils.replaceJoker(options.getPrenom()), QueryUtils.replaceJoker(options.getNom()), options.getGenre(), count, options.getFirst(), options.getPageSize(), options.getSortField(), options.getSortOrder());

27. if (count)

28. {

29. setRowCount(result.getTotalRecords().intValue());

30. options.setChanged(false);

31. }

32. return result.getRecords();

33. }

34. }

La méthode load est appelée automatiquement lorsque la page est chargée.

L’objet lié au paginator a besoin de savoir combien d’enregistrements au total correspondent aux critères de recherche ce qui oblige la méthode recherchePersonne à faire deux requêtes :

1. Compter le nombre d’enregistrements.

2. Fournir les enregistrements pour la page en cours.

Comme ce traitement est gourmand en ressources, autant ne le faire qu’en cas de besoin, dans notre cas, lorsque les critères changent, ou la première fois.

Les critères de recherche sont stockés dans le managed bean PersonneRechercheOptions de scope session, celui-ci est injecté via l’annotation @Inject.

La façade de l’EJB de l’application est quant à elle récupérée via l’annotation @EJB.

On utilise ici l’interface locale, l’EJB s’exécutant sur la même JVM que l’application web.

III-H-4 - La page xhtml associée

Comme les pages utilisent un template, il n’y a que peu de choses à définir.

La balise <ui:composition> liste toutes les bibliothèques de composants utilisées et référence notre page template.

La page définie deux parties du template :

- le titre (<ui:define name="title">)

- le contenu (<ui:define name="content">)

Page

1. <ui:composition  xmlns="http://www.w3.org/1999/xhtml"

2. xmlns:h="http://java.sun.com/jsf/html"

3. xmlns:f="http://java.sun.com/jsf/core"

4. xmlns:ui="http://java.sun.com/jsf/facelets"

5. xmlns:p="http://primefaces.org/ui"

6. template="/templates/template.xhtml">

8. <ui:define name="title">

9. <h:outputText value="#{msg['menu.personne.rechercher']}"/>

10. </ui:define>

12. <ui:define name="content">

14. <h:form id="form1" onkeypress="return avoidEnter(event)">

15. <p:accordionPanel id="filtres">

16. <p:tab closable="true" title="#{msg['filtre.titre']}">

17. <p:panelGrid>

18. <p:row>

19. <p:column>

20. <h:outputLabel value="#{msg['filtre.genre']}" styleClass="label"/>

21. </p:column>

22. <p:column>

23. <p:selectOneMenu id="genre" value="#{personneRechercheOptions.genre}">

24. <f:selectItem itemValue="" itemLabel=""/>

25. <f:selectItem itemValue="H" itemLabel="#{msg['genre.homme']}"/>

26. <f:selectItem itemValue="F" itemLabel="#{msg['genre.femme']}"/>

27. </p:selectOneMenu>

28. </p:column>

29. <p:column>

30. <h:outputLabel value="#{msg['personne.recherche.filtre.prenom']}" styleClass="label"/>

31. </p:column>

32. <p:column>

33. <p:inputText value="#{personneRechercheOptions.prenom}" style="width:400px"/>

34. </p:column>

35. <p:column>

36. <h:outputLabel value="#{msg['personne.recherche.filtre.nom']}" styleClass="label"/>

37. </p:column>

38. <p:column>

39. <p:inputText value="#{personneRechercheOptions.nom}" style="width:400px"/>

40. </p:column>

41. </p:row>

43. <p:row>

44. <p:column colspan="4">

45. <p:commandButton id="rechercher" value="#{msg['bouton.rechercher']}" update="form1:list1"/>

46. <p:commandButton id="creer"      value="#{msg['bouton.nouveau']}" actionListener="#{personneRechercheManager.create()}"/>

47. </p:column>

48. </p:row>

49. </p:panelGrid>

50. </p:tab>

51. </p:accordionPanel>

52. <p:dataTable id="list1" value="#{personneRechercheDataModel}" var="p" lazy="true"

53. paginator="true" rows="#{personneRechercheOptions.pageSize}" rowsPerPageTemplate="10,20,40,80" paginatorPosition="top"

54. selectionMode="single" selection="#{personneRechercheOptions.selected}"

55. emptyMessage="#{msg['personne.recherche.vide']}">

57. <p:ajax event="rowSelect" listener="#{personneRechercheManager.onRowClick}"/>

59. <p:column headerText="#{msg['personne.recherche.colonne.civilite']}" style="width:80px;">

60. <h:outputText value="#{p.civilite.libelle}"/>

61. </p:column>

63. <p:column headerText="#{msg['personne.recherche.colonne.prenom']}">

64. <h:outputText value="#{p.prenom}"/>

65. </p:column>

67. <p:column headerText="#{msg['personne.recherche.colonne.nom']}">

68. <h:outputText value="#{p.nom}"/>

69. </p:column>

71. <p:column headerText="#{msg['personne.recherche.colonne.codePostal']}" style="width:80px">

72. <h:outputText value="#{p.codePostal}"/>

73. </p:column>

75. <p:column headerText="#{msg['personne.recherche.colonne.ville']}">

76. <h:outputText value="#{p.ville}"/>

77. </p:column>

79. <p:column headerText="uid" style="width:50px; text-align:right">

80. <h:outputText value="#{p.uid}"/>

81. </p:column>

83. </p:dataTable>

85. </h:form>

86. </ui:define>

87. </ui:composition>

Le contenu de la page est divisé en deux parties :

1. La saisie des critères de filtre avec les boutons d’actions.

2. La liste de personnes correspondant aux critères.

La sélection d’une personne de la liste se fait ici sur simple clic, on aurait pu utiliser le double-clic en modifiant l’événement ajax par ‘rowDblselect’.

Toutes les constantes de la page sont définies dans un fichier de propriétés ce qui permettra, le jour venu, de très simplement ajouter d’autres langues à l’interface.

À noter que si les noms des clés de propriétés avaient été définis sans point séparateur mais avec un ‘_‘, la syntaxe aurait pu être :

Exemple

#{msg.personne_recherche_colonne_ville}

III-I - Module de gestion du détail d’une personne

Ce module permet de gérer ou de supprimer toutes les données relatives à une personne.

Le chargement se fait via les paramètres d’URL :

- rp = return point ;

- uid = clé primaire à charger.

III-I-1 - PersonneManager

Manager

1. @Named

2. @ViewScoped

3. public class PersonneManager extends AbstractManager

4. {

5. private static final long serialVersionUID = 1;

6. private DTOPersonne personne;

7. private Integer uid;

9. @EJB

10. private MonProjetFacadeLocal facade;

12. public Integer getUid()

13. {

14. return uid;

15. }

17. public void setUid(Integer uid)

18. {

19. this.uid = uid;

20. if (personne == null || !uid.equals(personne.getUid()))

21. {

22. personne = facade.getPersonne(uid);

23. }

24. }

26. public DTOPersonne getPersonne()

27. {

28. if (personne == null)

29. {

30. personne = new DTOPersonne();

31. }

32. return personne;

33. }

35. public void setPersonne(DTOPersonne personne)

36. {

37. this.personne = personne;

38. }

40. public String display()

41. {

42. return formatURL(getPageURL(ApplicationPagesNamesEnum.PERSONNE_DETAIL), true);

43. }

45. public String saveOrUpdate()

46. {

47. try

48. {

49. facade.saveOrUpdatePersonne(personne);

50. sendFacesMessage("Personne enregistrée", FacesMessage.SEVERITY_INFO, true);

51. return formatToCaller(true);

52. }

53. catch (Exception e)

54. {

55. sendFacesMessage(e, false);

56. }

57. return null;

58. }

60. public String delete()

61. {

62. try

63. {

64. facade.deletePersonne(personne.getUid());

65. sendFacesMessage("Personne supprimée", FacesMessage.SEVERITY_INFO, true);

66. return formatToCaller(true);

67. }

68. catch (Exception e)

69. {

70. sendFacesMessage("Erreur lors de la suppression de la personne", FacesMessage.SEVERITY_ERROR, false);

71. }

72. return null;

73. }

74. public void addTelephone()

75. {

76. personne.getTelephones().add(new DTOPersonneTelephone());

77. }

78. public boolean autorisation(String action)

79. {

80. if (personne == null)

81. {

82. return false;

83. }

84. if ("delete".equals(action) && personne.getUid() != null)

85. {

86. return true;

87. }

88. if ("save".equals(action))

89. {

90. return true;

91. }

92. return false;

93. }

94. }

III-I-2 - La page xhtml associée

La balise <f:metadata> permet de lier le paramètre d’URL ‘rp’ à la propriété ‘returnPoint’ du bean personneManager ainsi que le paramètre d’URL ‘uid’ à la propriété ‘uid’ du bean.

Le setter setUid(Integer uid) se chargera, si besoin, de charger le DTOPersonne.

Page

1. <ui:composition  xmlns="http://www.w3.org/1999/xhtml"

2. xmlns:h="http://java.sun.com/jsf/html"

3. xmlns:f="http://java.sun.com/jsf/core"

4. xmlns:ui="http://java.sun.com/jsf/facelets"

5. xmlns:p="http://primefaces.org/ui"

6. template="/templates/template.xhtml">

8. <ui:define name="title">

9. <h:outputText value="#{msg['personne.detail.titre']}"/>

10. </ui:define>

12. <ui:define name="content">

14. <f:metadata>

15. <f:viewParam name="rp" value="#{personneManager.returnPoint}"/>

16. <f:viewParam name="uid" value="#{personneManager.uid}"/>

17. </f:metadata>

19. <h:form id="form1">

20. <p:panel style="width:600px;">

21. <f:facet name="footer">

22. <span style="float:left">

23. <h:outputText value="#{msg['derniere.mise.a.jour']}" styleClass="label"/>

24. <h:outputText value="#{personneManager.personne.majDate}" converter="datetimeConverter" style="margin-left:5px"/>

25. </span>

27. <p:commandButton value="#{msg['bouton.annuler']}" immediate="true" action="#{personneManager.formatToCaller(true)}"/>

28. <p:commandButton value="#{msg['bouton.enregistrer']}" action="#{personneManager.saveOrUpdate()}"/>

29. <p:commandButton value="#{msg['bouton.supprimer']}" action="#{personneManager.delete()}" rendered="#{personneManager.autorisation('delete')}"/>

30. </f:facet>

32. <p:panelGrid>

33. <p:row>

34. <p:column>

35. <p:outputLabel for="civilite" value="#{msg['personne.civilite']}" styleClass="label required"/>

36. </p:column>

37. <p:column>

38. <p:selectOneMenu id="civilite" value="#{personneManager.personne.civilite}" required="false" converter="#{civiliteConverter}">

39. <f:selectItems value="#{civiliteRechercheDataModel.civilites}"  var="c" itemValue="#{c}" itemLabel="#{c.libelle}"/>

40. </p:selectOneMenu>

41. </p:column>

42. <p:column>

43. <p:outputLabel for="genre" value="#{msg['personne.genre']}" styleClass="label"/>

44. </p:column>

45. <p:column>

46. <p:selectOneMenu id="genre" value="#{personneManager.personne.genre}">

47. <f:selectItem itemValue="H" itemLabel="#{msg['personne.genre.homme']}"/>

48. <f:selectItem itemValue="F" itemLabel="#{msg['personne.genre.femme']}"/>

49. </p:selectOneMenu>

50. </p:column>

51. </p:row>

52. <p:row>

53. <p:column>

54. <p:outputLabel for="prenom" value="#{msg['personne.prenom']}" styleClass="label required"/>

55. </p:column>

56. <p:column colspan="3">

57. <p:inputText id="prenom" value="#{personneManager.personne.prenom}" required="false" style="width:400px"/>

58. </p:column>

59. </p:row>

60. <p:row>

61. <p:column>

62. <p:outputLabel for="nom" value="#{msg['personne.nom']}" styleClass="label required"/>

63. </p:column>

64. <p:column colspan="3">

65. <p:inputText id="nom" value="#{personneManager.personne.nom}" required="false" style="width:400px"

66. onkeyup="this.value = value.toUpperCase()"/>

67. </p:column>

68. </p:row>

69. <p:row>

70. <p:column style="height:10px"></p:column>

71. </p:row>

72. <p:row>

73. <p:column>

74. <p:outputLabel for="adresse" value="#{msg['personne.adresse']}" styleClass="label"/>

75. </p:column>

76. <p:column colspan="3">

77. <p:inputText id="adresse" value="#{personneManager.personne.adresse1}" style="width:400px"/>

78. </p:column>

79. </p:row>

80. <p:row>

81. <p:column>

82. </p:column>

83. <p:column colspan="3">

84. <p:inputText value="#{personneManager.personne.adresse2}" style="width:400px"/>

85. </p:column>

86. </p:row>

87. <p:row>

88. <p:column>

89. <p:outputLabel for="codePostal" value="#{msg['personne.codePostal']}" styleClass="label"/>

90. </p:column>

91. <p:column colspan="3">

92. <p:inputText id="codePostal" value="#{personneManager.personne.codePostal}"/>

93. </p:column>

94. </p:row>

95. <p:row>

96. <p:column>

97. <p:outputLabel for="ville" value="#{msg['personne.ville']}" styleClass="label"/>

98. </p:column>

99. <p:column colspan="3">

100. <p:inputText id="ville" value="#{personneManager.personne.ville}" style="width:400px"

101. onkeyup="this.value = value.toUpperCase()"/>

102. </p:column>

103. </p:row>

104. </p:panelGrid>

107. <p:dataTable id="list1" value="#{personneManager.personne.telephones}" var="t" style="margin-top:20px">

109. <f:facet name="header">

110. #{msg['personne.telephones']}

111. <p:commandButton value="#{msg['bouton.ajouter']}" actionListener="#{personneManager.addTelephone()}"

112. update="list1" style="margin-left:60px"/>

113. </f:facet>

114. <p:column headerText="#{msg['personne.telephone.type']}">

115. <p:selectOneMenu value="#{t.telephoneType}" converter="#{telephoneTypeConverter}" style="width:90%">

116. <f:selectItems value="#{telephoneTypeRechercheDataModel.types}" var="tt" itemValue="#{tt}" itemLabel="#{tt.libelle}"/>

117. </p:selectOneMenu>

118. </p:column>

119. <p:column headerText="#{msg['personne.telephone.numero']}">

120. <p:inputText value="#{t.numero}" style="width:90%"/>

121. </p:column>

122. </p:dataTable>

123. </p:panel>

124. </h:form>

125. </ui:define>

126. </ui:composition>

Lorsqu’on utilise une liste d’objets comme source de données d’un composant comme dans cet exemple avec <p:selectOneMenu>, n’oubliez pas qu’en HTML, seules les chaînes de caractères existent.

Il convient donc de passer par un converter pour transformer l’identifiant de la ligne sélectionnée en objet.

III-J - Module de gestion des civilités

Ce module permet de gérer les civilités de l’application.

Contrairement aux exemples précédents et au vu de la simplicité des données, la gestion se fait sur une seule page regroupant la liste de sélection et la boite de dialogue permettant d’ajouter ou de modifier un enregistrement.

III-J-1 - CiviliteRechercheManager

Comme la liste des civilités est placée dans un scope Application (voir plus bas CiviliteRechercheDataModel), tous les utilisateurs partagent la même liste.

Il convient donc, lors d’une modification, de copier l’élément de la liste dans un objet tampon pour éviter de propager des données non validées.

Cette opération est effectuée par le listener updateRow(SelectEvent) lié à l’événement de sélection d’une ligne du dataTable.

Manager

1. @Named

2. @ViewScoped

3. public class CiviliteRechercheManager extends AbstractManager

4. {

5. public static final long serialVersionUID = 1;

6. private DTOCivilite civilite;

7. @EJB

8. private MonProjetFacadeLocal facade;

9. @Inject

10. private CiviliteRechercheDataModel dataModel;

13. public DTOCivilite getCivilite()

14. {

15. return civilite;

16. }

18. public void setCivilite(DTOCivilite civilite)

19. {

20. this.civilite = civilite;

21. }

23. public String getTitre()

24. {

25. if (civilite == null)

26. {

27. return null;

28. }

29. if (civilite.getUid() == null)

30. {

31. return formatMessage("civilite.dialogue.titre.create", null);

32. }

33. return formatMessage("civilite.dialogue.titre.update", null);

34. }

36. public String display()

37. {

38. return formatURL(getPageURL(ApplicationPagesNamesEnum.CIVILITE_RECHERCHE), true);

39. }

41. public void create()

42. {

43. civilite = new DTOCivilite();

44. }

48. public void updateRow(SelectEvent event)

49. {

50. DTOCivilite dto = (DTOCivilite)event.getObject();

51. civilite = new DTOCivilite(dto.getUid(), dto.getAbrege(), dto.getLibelle());

52. }

53. public void delete(Integer uid)

54. {

55. try

56. {

57. facade.deleteCivilite(uid);

58. dataModel.reset();

59. PrimeFaces.current().ajax().update("form1:list1");

60. }

61. catch (Exception e)

62. {

63. sendFacesMessage(e, false);

64. }

65. }

66. public String saveOrUpdate()

67. {

68. try

69. {

70. civilite = facade.saveOrUpdateCivilite(civilite);

71. dataModel.reset();

72. PrimeFaces.current().executeScript("PF('createWidget').hide()");

73. PrimeFaces.current().ajax().update("form1:list1");

74. }

75. catch (Exception e)

76. {

77. sendFacesMessage(e, false);

78. }

79. return null;

80. }

81. }

III-J-2 - CiviliteRechercheDataModel

DataModel

1. @Named

2. @ApplicationScoped

3. public class CiviliteRechercheDataModel implements Serializable

4. {

5. public static final long serialVersionUID = 1;

6. private List<DTOCivilite> civilites;

7. @EJB

8. private MonProjetFacadeLocal facade;

9. public List<DTOCivilite> getCivilites()

10. {

11. if (civilites == null)

12. {

13. civilites = facade.rechercheCivilites(null, null, false, 0, 0, null,null).getRecords();

14. }

15. return civilites;

16. }

17. public void reset()

18. {

19. civilites = null;

20. }

21. }

III-J-3 - La page xhtml associée

Page

1. <ui:composition  xmlns="http://www.w3.org/1999/xhtml"

2. xmlns:h="http://java.sun.com/jsf/html"

3. xmlns:f="http://java.sun.com/jsf/core"

4. xmlns:ui="http://java.sun.com/jsf/facelets"

5. xmlns:p="http://primefaces.org/ui"

6. template="/templates/template.xhtml">

8. <ui:define name="title">

9. <h:outputText value="#{msg['menu.administration.civilites']}"/>

10. </ui:define>

12. <ui:define name="content">

14. <h:form id="form1" onkeypress="return avoidEnter(event)">

16. <p:commandButton id="creer" value="#{msg['bouton.nouveau']}" actionListener="#{civiliteRechercheManager.create()}"

17. update="createDialog"

18. oncomplete="PF('createWidget').show()"/>

20. <div style="width:600px">

21. <p:dataTable id="list1" value="#{civiliteRechercheDataModel.civilites}" var="c"

22. paginator="true" rows="20" paginatorPosition="top"

23. rowKey="#{c.uid}"

24. selectionMode="single">

26. <p:ajax event="rowSelect" listener="#{civiliteRechercheManager.updateRow}" update="createDialog"

27. oncomplete="PF('createWidget').show()"/>

29. <p:column headerText="#{msg['civilite.recherche.abrege']}" style="width:100px">

30. <h:outputText value="#{c.abrege}"/>

31. </p:column>

33. <p:column headerText="#{msg['civilite.recherche.libelle']}" style="width:300px">

34. <h:outputText value="#{c.libelle}" />

35. </p:column>

37. <p:column headerText="uid" style="width:50px; text-align:right">

38. <h:outputText value="#{c.uid}"/>

39. </p:column>

41. <p:column style="width:30px; text-align:center">

42. <p:commandButton icon="ui-icon-trash" actionListener="#{civiliteRechercheManager.delete(c.uid)}"/>

43. </p:column>

45. </p:dataTable>

46. </div>

48. </h:form>

51. <!-- Dialogue de création / modification d'un type de numéro de téléphone -->

53. <p:dialog id="createDialog" widgetVar="createWidget"

54. header="#{civiliteRechercheManager.getTitre()}" dynamic="true"

55. closable="true" closeOnEscape="true"

56. appendTo="@(body)" modal="false">

58. <h:form id="formDialog">

59. <p:panel styleClass="no-border">

61. <p:panelGrid columns="2">

63. <h:outputText value="#{msg['civilite.abrege']}" styleClass="label"/>

64. <p:inputText value="#{civiliteRechercheManager.civilite.abrege}"/>

66. <h:outputText value="#{msg['civilite.libelle']}" styleClass="label"/>

67. <p:inputText value="#{civiliteRechercheManager.civilite.libelle}" style="width:300px"/>

69. </p:panelGrid>

71. <f:facet name="footer">

72. <div style="text-align:right">

73. <p:commandButton id="save" value="#{msg['bouton.sauvegarder']}"

74. actionListener="#{civiliteRechercheManager.saveOrUpdate()}" />

75. </div>

76. </f:facet>

78. </p:panel>

79. </h:form>

80. </p:dialog>

81. </ui:define>

82. </ui:composition>

III-K - Module de gestion des types de téléphones

Ce module permet de gérer les types de téléphones d’une personne.

Le principe est exactement le même que pour la gestion des civilités, la liste est en scope Application, partagée par tous les utilisateurs de l’application.

Pour le détail des objets et de la page xhtml liée, je vous renvoie aux codes sources de l’application en pièce jointe.

IV - Conclusion et remerciements

Nous avons vu à quel point il était simple de réaliser une application web avec les standards EE8 et la bibliothèque de composants Primefaces.

Certaines problématiques n’ont pas été abordées ici, en particulier l’authentification JAAS et la propagation du Prinicipal à la couche EJB, le test des rôles autorisés par annotations, etc.

Le but étant de montrer quelque chose de suffisamment abouti tout en restant simple, ces aspects feront l’objet d’autres publications.

Je tiens à remercier f-leb pour sa relecture avisée et Mickael Baron pour son suivi dans la mise au point de ce document.