Académique Documents
Professionnel Documents
Culture Documents
Cours JEE 1
Cours JEE 1
Rdacteurs : Alexandre Baillif, Philippe Lacomme et Raksmey Phan Date : juillet 2010 Avertissement : ce document est une reprise dune partie dun document crit par Serge Tah. En particulier la base de donnes utilise.
Ce support de cours concerne la mise en place dune application JEE avec un client. La prsentation comprend 5 parties : Partie 1. Cration dune base de donnes sous MySQL. Partie 2. Cration dun conteneur EJB Partie 3. Cration un conteneur Web pour accder lEJB Partie 4. Cration dune Entreprise Application Partie 5. Cration dun client web.
La base de donnes sappellera base_medecin. JDBC : cette couche gre la connexion avec la (ou les) base(s) de donnes. Ici on utilisera la notion de pool de connexion. Un pool de connexion est un ensemble de connexions avec la base de donnes dj instancies. Cela permet aux requtes de sexcuter plus rapidement. On peut venir connecter plusieurs couches JPA sur la couche JDBC si ncessaire. JPA : la couche JPA (Java Persistence Annotation) est une couche dabstraction de la couche JDBC. Elle permet notamment de faire du Mapping Relationnel-Objet (ORM, Object-Relationnal Mapping en anglais) qui consiste modliser la base de donnes sous forme dobjets pour une manipulation plus simple travers le code Java (requtes pr-crites, gestion des liens entre les tables,). Gnralement la couche JPA contient une classe (entit) par table, des contrleurs (fonctions de base implmentes) et des gestionnaires dexceptions. DAO : Cette couche reprsente lintelligence de lapplication. Elle est compose dun ensemble dinterfaces locales (local) et distantes (remote). Les DAO (Data Access Object) permettent daccder aux objets et proposent des mthodes de CRUD (Create, Read, Update, Delete). Un EJB (Entreprise Java Bean) sera pilot partir dune autre application distante ou locale (client EJB). Web Services : Cette couche a pour but de dfinir des services qui pourront tre appels selon le protocole SOAP. Ainsi les informations pourront circuler entre les applications sous forme de messages XML. Cela peut servir faire communiquer deux applications qui peuvent tre codes dans deux langages diffrents, en local ou distance. 1
1) Tlchargement de MySQL
Nous utilisons une base de donnes MySQL. Site : http://www.mysql.com/ Utiliser la section Download.
Choisir ensuite votre systme dexploitation. Par exemple Windows 32 bits et lancer le tlchargement.
Ou vous pouvez cliquer sur le lien No thanks, just take me to the downloads!
1.2. Installation de MySQL Conserver les rglages par dfaut et valider les diffrents crans dinstallation. Utiliser le compte root et le mot de passe admin.
Remarquons que pendant linstallation, nous avons accs au numro de port (par dfaut 3309).
Si linstallation se passe bien elle devrait se terminer par lcran qui suit :
1.3. Tlchargement et Installation de MySQL WorkBench Cet outil nest pas indispensable mais trs efficace et permet de manipuler MySQL de manire trs simple. Il est vivement recommand de linstaller. Cette interface graphique est en fait une couche de manipulation de MySQL.
Lancer linstallation
1.4. Ensemble des outils MySQL Dans le menu Dmarrer, dans le sous-menu MySQL se trouvent : - WorkBench - MySQL Serveur.
En cliquant sur Add Table on peut ajouter une table qui par dfaut porte le nom table1.
Modifions ensuite le nom de la table en EMPLOYE et validons. Nous pouvons ensuite facilement ajouter les champs NOM, PRENOM et AGE.
Sauvegarder le modle.
10
1.5. Cration dune base de donnes laide dun script Revenez dans longlet Home . Faites New Connection .
Utilisez le numro de port par dfaut donn lors de linstallation de MySQL (3306, 3309,). Puis tester la connexion.
11
Au retour sur lcran principal, double-cliquez sur localhost . Une nouvelle fentre de SQL Query souvre.
12
Valider les diffrentes tapes. La base_medecin apparat ensuite dans la colonne de gauche.
13
14
15
1.6) Tlcharger et Installer Netbeans Avant de tlcharger Netbeans, il est important dinstaller un JDK sur sa machine. Il sagit dun ensemble de librairie Java pour le dveloppement. Pour ce tutorial, nous avons utilis la version 1.6.21 du JDK : fc.isima.fr/~phan/WebService/jdk-6u21-windows-i586.zip Comme utilitaire de dveloppement, nous allons utiliser NetBeans 6.9. Il sera ncessaire davoir au minimum la version Java (avec le serveur Glassfish intgr). Lien pour le tlchargement : fc.isima.fr/~phan/WebService/netbeans-6.9-ml-java-windows.exe.zip Suivez le guide dinstallation jusqu lendroit o lon vous demande de choisir un rpertoire dinstallation de Glassfish. ce moment l prenez soin de prciser un chemin daccs sans espace. Pour les utilisateurs de Windows nous conseillons : C:\glassfish3 (Ceci permettra dviter un bug des versions rcentes de Glassfish et Java).
16
1.7) Configurer Netbeans Dmarrer NetBeans. Aller dans Services. En fonction de la machine sur laquelle vous tes, de la version de Netbeans et de Glassfish ainsi que des ventuelles bases de donnes dj installes vous devriez obtenir quelque chose ressemblant ce qui se trouve ci-dessous :
Dans la section Drivers, choisir MySQL et par un clic droit faire Connect Using.
17
18
19
2.1. Cration dun conteneur EJB Crer un nouveau projet EJB Module qui se nomme EJBModule1.
20
21
2.2. Cration dune ressource JDBC au serveur Glassfish Il sagit de la premire tape.
22
Maintenant nous allons donner un nom JNDI (Java Naming and Directory Interface) notre ressource. Ce nom sera celui utilis par le serveur dapplication pour retrouver la ressource. Afin dviter toute confusion, le nom JNDI sera jdbc/base_medecin_JNDI:
23
Dautre part, le pool de connexion sera nomm : base_medecin_pool. Pour cela, faire dans un premier temps Next>.
Pensez choisir la connexion correcte. Ici base_medecin. Et donnez lui le nom du base_medecin_pool.
24
25
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE resources PUBLIC "-//Sun Microsystems, Inc.//DTD Application Server 9.0 Resource Definitions //EN" "http://www.sun.com/software/appserver/dtds/sun-resources_1_3.dtd"> <resources> <jdbc-resource enabled="true" jndi-name="jdbc/base_medecin_JNDI" object-type="user" poolname="connectionPool"> <description/> </jdbc-resource> <jdbc-connection-pool allow-non-component-callers="false" associate-with-thread="false" connection-creation-retry-attempts="0" connection-creation-retry-interval-in-seconds="10" connection-leak-reclaim="false" connection-leak-timeout-in-seconds="0" connection-validationmethod="auto-commit" datasource-classname="com.mysql.jdbc.jdbc2.optional.MysqlDataSource" fail-allconnections="false" idle-timeout-in-seconds="300" is-connection-validation-required="false" isisolation-level-guaranteed="true" lazy-connection-association="false" lazy-connectionenlistment="false" match-connections="false" max-connection-usage-count="0" max-pool-size="32" maxwait-time-in-millis="60000" name="connectionPool" non-transactional-connections="false" pool-resizequantity="2" res-type="javax.sql.DataSource" statement-timeout-in-seconds="-1" steady-pool-size="8" validate-atmost-once-period-in-seconds="0" wrap-jdbc-objects="false"> <property name="URL" value="jdbc:mysql://localhost:3309/base_medecin"/> <property name="User" value="root"/> <property name="Password" value="admin"/> </jdbc-connection-pool> </resources>
26
Elle va configurer la couche JPA. Dans notre cas, nous allons utiliser limplmentation propose par Eclipse.
Dans un premier temps nous allons crer une unit de persistance (faire Clic Droit sur EJBModule1 et choisir New->Others).
Choisir ensuite comme Data Source : base_medecin_JNDI. Comme fournisseur de service de persistance EclipseLink.
27
Attention ne pas choisir une stratgie englobant la gnration des tables. Elles existent dj grce au script SQL que nous avons utilis au dpart.
28
<?xml version="1.0" encoding="UTF-8"?> <persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"> <persistence-unit name="EJBModule1PU" transaction-type="JTA"> <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider> <jta-data-source>jdbc/base_medecin_JNDI</jta-data-source> <exclude-unlisted-classes>false</exclude-unlisted-classes> <properties/> </persistence-unit> </persistence>
29
Dans un deuxime temps, nous allons crer des entits JPA. Comme prcdemment faire Clic Droit / New / Other.
30
31
32
Etant donn quil sagit de la gnration dentits JPA, on peut choisir jpa comme nom de package.
Veuillez bien choisir java.util.List pour Collection Type (pour avoir plus de lisibilit).
Rappel : 33
java.util.Collection : il sagit de la classe racine de la hirarchie. java.util.List : il sagit dune extension de collection fournissant les mthodes pour manipuler des listes ordonnes.
Les entits JPA gnres apparaissent. Une entit pour chaque table de la base de donnes
Dans la classe Rv nous ajoutons un nouveau constructeur permettant de crer un rendez vous en donnant une date, un client et un jour.
public Rv(Date jour, Clients client, Creneaux creneau) { this.jour = jour ; this.clients = client ; this.creneaux = creneau ; }
Afin dviter davoir des rfrences circulaires qui peuvent gnrer des boucles infinies (notamment lors de la conversion en XML par les web services), il est ncessaire dajouter le mot cl transient dans les classes Creneaux, Medecins et Clients, lendroit o elles mappent avec dautres objets sous forme de listes.
34
Clients.java
Medecins.java
Creneaux.java
2.4. Cration dune classe spciale de traitement des exceptions Crer un nouveau package nomm par exemple medecin.exception.
Dans ce package, crer ensuite une classe java nomm par exemple : MedecinException.
35
36
Elle va utiliser la couche JPA. Dans notre cas, nous allons utiliser limplmentation propose par EclipseLink.
37
38
39
Cet ensemble de classes, contient des interfaces distantes et locales pour implmenter les mthodes du CRUD. Rappelons que CRUD dsigne les quatre oprations de base pour la persistance des 40
donnes, en particulier le stockage d'informations en base de donnes. Soit : Create, Read (ou Retrieve), Update et Delete (ou Destroy). Enfin nous allons crer un package nomme dao, qui reprsente linterface de lEJB pour laccs aux donnes.
41
Ajoutons une Session Bean dans le package dao. Cette interface va permettre davoir plusieurs mthodes sur une seule interface (contrairement aux classes du package ejb qui sont en fait une interface par entit).
Demandons en plus une interface locale et distante de type stateless. Rappels : Stateless : Ltat du Bean nest pas conserv. Sa dure de vie correspond la dure de vie dune requte utilisateur (ex : Calculatrice). Stateful : Ltat du Bean est conserv. Sa dure de vie correspond la dure de vie dune session utilisateur (ex : Panier dachat).
42
Nous allons complexifier un peu ce schma : - en ajoutant une nouvelle classe java DaoJpa qui contiendra une implmentation de IdaoLocal et IdaoRemote - en considrant que le fichier Idao est juste une interface.
43
Le fichier Idao.java 44
public interface Idao { // liste des clients public List<Clients> getAllClients(); // liste des Mdecins public List<Medecins> getAllMedecins(); // liste des crneaux horaires d'un mdecin public List<Creneaux> getAllCreneaux(Medecins medecin); // liste des Rv d'un mdecin, un jour donn public List<Rv> getRvMedecinJour(Medecins medecin, String jour); // trouver un client identifi par son id public Clients getClientById(Long id); // trouver un client idenbtifi par son id public Medecins getMedecinById(Long id); // trouver un Rv identifi par son id public Rv getRvById(Long id); // trouver un crneau horaire identifi par son id public Creneaux getCreneauById(Long id); // ajouter un RV public Rv ajouterRv(String jour, Creneaux creneau, Clients client); // supprimer un RV public void supprimerRv(Rv rv); }
IdaoLocal.java
package dao; import javax.ejb.Local; @Local public interface IdaoLocal extends Idao{ }
IdaoRemote.java
package dao; import javax.ejb.Remote; @Remote public interface IdaoRemote extends Idao { }
DaoJpa.java
package dao; import javax.ejb.Stateless; import javax.*; import jpa.*; import java.util.*; import javax.ejb.*; import javax.persistence.*; import java.text.*; //import javax.transaction.Transaction; import medecin.exception.*; @Stateless(mappedName = "Interface") @TransactionAttribute(TransactionAttributeType.REQUIRED) public class DaoJpa implements IdaoLocal, IdaoRemote { @PersistenceContext private EntityManager em;
45
// liste des clients public List<Clients> getAllClients() { try { return em.createQuery("select c from Clients c").getResultList(); } catch (Throwable th) { throw new MedecinException (th, 1); } } // liste des mdecins public List<Medecins> getAllMedecins() { try { return em.createQuery("select m from Medecins m").getResultList(); } catch (Throwable th) { throw new MedecinException (th, 2); }
} // liste des crneaux horaires d'un mdecin donn // medecin : le mdecin public List<Creneaux> getAllCreneaux(Medecins medecin) { try { return em.createQuery("select c from Creneaux c join c.medecin m where m.id=:idMedecin").setParameter("idMedecin", medecin.getId()).getResultList(); } catch (Throwable th) { throw new MedecinException (th, 3); } } // liste des Rv d'un mdecin donn, un jour donn // medecin : le mdecin // jour : le jour public List<Rv> getRvMedecinJour(Medecins medecin, String jour) { try { return em.createQuery("select rv from Rv rv join rv.creneau c join c.medecin m where m.id=:idMedecin and rv.jour=:jour").setParameter("idMedecin", medecin.getId()).setParameter("jour", new SimpleDateFormat("yyyy:MM:dd").parse(jour)).getResultList(); } catch (Throwable th) { throw new MedecinException (th, 4); } } // ajout d'un Rv // jour : jour du Rv // creneau : crneau horaire du Rv // client : client pour lequel est pris le Rv public Rv ajouterRv(String jour, Creneaux creneau, Clients client) { try { Rv rv = new Rv(new SimpleDateFormat("yyyy:MM:dd").parse(jour), client, creneau); em.persist(rv); return rv; } catch (Throwable th) { throw new MedecinException (th, 5); } } // suppression d'un Rv // rv : le Rv supprim public void supprimerRv(Rv rv) { try { em.remove(em.merge(rv)); } catch (Throwable th) { throw new MedecinException (th, 6); } } // rcuprer un client donn public Clients getClientById(Long id) { try { return (Clients) em.find(Clients.class, id); } catch (Throwable th) { throw new MedecinException (th, 7); } } // rcuprer un mdecin donn public Medecins getMedecinById(Long id) {
46
try { return (Medecins) em.find(Medecins.class, id); } catch (Throwable th) { throw new MedecinException (th, 8); } } // rcuprer un Rv donn public Rv getRvById(Long id) { try { return (Rv) em.find(Rv.class, id); } catch (Throwable th) { throw new MedecinException (th, 9); } } // rcuprer un crneau donn public Creneaux getCreneauById(Long id) { try { return (Creneaux) em.find(Creneaux.class, id); } catch (Throwable th) { throw new MedecinException (th, 10); } } }
Avant de compiler assurez-vous que les librairies EclipseLink sont incluses dans le projet :
Enfin il faut crer un fichier de configuration de JNDI nomm : jndi.properties. Le plus simple est de crer un package nomm Configuration. Ensuite il suffit de faire Clic Droit / New / Others / empty File
47
48
49
4.3. Dployer
Ensuite, le dploiement a russi et on peut constater que lEJB a t ajout la partie Applications du serveur Glassfish.
50
51
52
Parmi les frameworks installs vous pouvez par exemple choisir Java Server Faces ou ne rien choisir (il ny aura pas dexemple dutilisation du framework dans ce tutorial).
3.2. Utilisation de lEJB Faire un clic droit sur la partie librairies de lapplication Web et choisir Add Jar Choisir ensuite EJBModule1.jar.
53
Il est possible de stocker cette classe dans un package rendezvous par exemple. 54
Utilisez le bouton parcourir pour slectionner linterface sur laquelle on va crer le service web.
Slectionner DaoJpa.
55
Utilisons comme nom WSDaoJpa. Valider le choix pour revenir la dfinition du web service.
56
Pour crer le web service, nous allons faire une couche devant la partie DaoJpa de lEJB. Rappelons que la partie DaoJpa contient un ensemble de mthodes contrlant laccs aux donnes.
57
package rendezvous; import import import import import import javax.ejb.EJB; javax.jws.*; jpa.*; dao.*; dao.IdaoLocal; java.util.*;
@WebService() public class WSDaoJpa implements Idao { @EJB private IdaoLocal dao; // web service numero 1 // liste des clients @WebMethod public List<Clients> getAllClients() { return dao.getAllClients(); } // web service numero 2 // liste des clients @WebMethod public List<Medecins> getAllMedecins() { return dao.getAllMedecins(); } // liste des crneaux horaires d'un mdecin donn // medecin : le mdecin @WebMethod public List<Creneaux> getAllCreneaux(Medecins medecin) { return dao.getAllCreneaux(medecin); } // liste des Rv d'un mdecin donn, un jour donn // medecin : le mdecin, jour : le jour @WebMethod public List<Rv> getRvMedecinJour(Medecins medecin, String jour) { return dao.getRvMedecinJour(medecin, jour); } // ajout d'un Rv, jour : jour du Rv // creneau : crneau horaire du Rv, client : client pour lequel est pris le Rv @WebMethod public Rv ajouterRv(String jour, Creneaux creneau, Clients client) { return dao.ajouterRv(jour, creneau, client); } // suppression d'un Rv, rv : le Rv supprim @WebMethod public void supprimerRv(Rv rv) { dao.supprimerRv(rv); } // rcuprer un client donn @WebMethod public Clients getClientById(Long id) { return dao.getClientById(id); } // rcuprer un mdecin donn @WebMethod public Medecins getMedecinById(Long id) { return dao.getMedecinById(id); } // rcuprer un Rv donn @WebMethod public Rv getRvById(Long id) { return dao.getRvById(id); } // rcuprer un crneau donn @WebMethod public Creneaux getCreneauById(Long id) { return dao.getCreneauById(id); } }
58
3.3. Test du web service Vrifier que ni lEJB ni la web application nest dploy dans les services. Si ce nest pas le cas, supprimer toutes les applications dployes.
59
Puis, faire un clic droit sur WsDaoJpa dans le projet WebApplication1. Choisir Test WebService.
Ceci permet de tester les web services directement partir dun navigateur !
60
61
62
Il peut arriver que cette partie ne fonctionne pas soit parce que vous navez pas dploy correctement, soit parce que le port est dj utilis par une autre application. Dans ces cas, vous aurez le message suivant
Si cest un problme de dploiement, il faut vrifier tous les paramtres prcdemment entrs. Si cest un problme de port, il suffit de changer le port de glassfish. Pour sassurer que cest bien un problme de port, on va entrer localhost:8080 (cf. message derreur) dans un navigateur.
63
Par exemple, nous avons obtenu ceci sur une machine de test :
Cela indique que le port est occup par oracle. Il faut donc dire Glassfish dutiliser un autre port. Ajouter un nouveau serveur :
64
Puis valider les options par dfaut. On retrouve ce serveur dans la liste des serveurs Glassfish disponibles :
En regardant dans la proprit des serveurs, on remarque que le nouveau domaine nutilise plus le port 8080 :
Il faut alors configurer le web service pour quil utilise le nouveau serveur (et pareillement pour les autre applications si besoin).
65
66
Ensuite reconfigurer lEJB pour quil utilise le mme nouveau serveur glassfish.
67
Enfin, redployer le web service. A moins que le nouveau port soit aussi utilis, normalement, vous navez plus de problme de port.
68
69
LEJB et la WebApplication que nous venons de crer doivent tre inclus dans lapplication entreprise que nous venons de crer. Un clic droit sur le package Java EE Modules fait apparatre un menu contextuel qui recense les projets actuellement connus de NetBeans et rfrencs dans la partie projet.
Vrifier que vous avez slectionn le mme serveur glassfish pour la web application lEJB, et lEntreprise application.
70
71
4.2. Tester le web service (again) Penser arrter Glassfish et connecter la base de donnes base_medecin avant de poursuivre.
72
Dans un deuxime temps, il faut dployer le projet EntrepriseApplication1. Avant de dployer lapplication assurez-vous davoir enlev lEJB dploy et/ou le Webservice afin dviter des conflits (Services Servers Glassfish Application EJB Clic droit Undeploy).
73
Finalement, faire un clic droit sur WsDaoJpa dans le projet WebApplication1. Choisir Test WebService.
74
Ceci permet de tester les web services directement partir dun navigateur !
75
76
Il peut arriver que cette partie ne fonctionne pas soit parce que vous navez pas dploy correctement, soit parce que le port est dj utilis par une autre application. Dans ces cas, vous aurez le message suivant
Si cest un problme de dploiement, il faut vrifier tous les paramtres prcdemment entrs. Si cest un problme de port, il suffit de changer le port de glassfish. Pour sassurer que cest bien un problme de port, on va entrer localhost:8080 (cf. message derreur) dans un navigateur.
77
Par exemple, nous avons obtenu ceci sur une machine de test :
Cela indique que le port est occup par oracle. Il faut donc dire Glassfish dutiliser un autre port. Ajouter un nouveau serveur :
78
Puis valider les options par dfaut. On retrouve ce serveur dans la liste des serveurs Glassfish disponibles :
En regardant dans la proprit des serveurs, on remarque que le nouveau domaine nutilise plus le port 8080 :
Il faut alors configurer le web service pour quil utilise le nouveau serveur (et pareillement pour les autre applications si besoin).
79
80
Ensuite reconfigurer lEJB pour quil utilise le mme nouveau serveur glassfish.
81
Enfin, redployer le web service. A moins que le nouveau port soit aussi utilis, normalement, vous navez plus de problme de port.
82
83
84
85
86
Ceci donne :
87
Ce qui donne :
88