TP :

construction dune application Web au dessus dune base de donnes : mini annuaire dentreprise

Objectifs .................................................................................................................................... 2 Lapplication dvelopper ....................................................................................................... 2

Description de lapplication ................................................................................................. 2

Travail raliser ........................................................................................................................ 3

Installation Apache Tomcat version 4.1.12 ......................................................................... 3 Premire partie : installation de lapplication et comprhension de sa structure ............ 4 Fichiers de lapplication Web ............................................................................................... 4 Installation de lapplication .................................................................................................. 5 Deuxime partie : dveloppement des nouvelles fonctionnalits ..................................... 5 Rechercher une personne dans lannuaire ............................................................................ 5 Afficher la liste des dpartements ........................................................................................ 6 Rechercher un dpartement dans lannuaire ......................................................................... 6 Partie administration : fonctionnalits dinsertion de nouvelles personnes et de nouveaux dpartements ....................................................................................................................... 7

ENST Bretagne

08/03/06

Objectifs
Dvelopper une application Web Java (3-tier) en utilisant : o la technologie JSP ; o une connexion une base Oracle par lintermdiaire dun driver JDBC.

Lapplication dvelopper
Description de lapplication
Lapplication simule laccs un annuaire dentreprise. Sa consultation seffectue par lintermdiaire du Web laide dun ensemble de JSP et de pages HTML constituant une application Web 3-tier. o Le stockage des donnes de lapplication se fait sur une base oracle qui est accde grce JDBC. Au dbut du TP, les donnes sont stockes dans une unique table employe qui stocke les ID, nom, prnom, fonction et tlphone de chacune des entres de lannuaire. Mis part lidentifiant, numrique (number), chaque colonne de la table est stocke sous la forme dune chane de caractres (varchar2). Ces chanes ont une taille maximale quil faut imprativement respecter lors des insertions. Description de la table :
SQL> desc employe Name ----------------------------------------ID NOM PRENOM FONCTION TELEPHONE Null? -------NOT NULL NOT NULL Type ---------------------------NUMBER VARCHAR2(15) VARCHAR2(15) VARCHAR2(15) VARCHAR2(10)

La page daccueil de lapplication affiche deux menus (utilisation et administration) qui permet deffectuer des actions sur lannuaire :

ENST Bretagne

08/03/06

Seul le premier item du menu utilisation est ralis et fonctionnel, il permet dafficher la liste complte des personnes rfrences dans la base :

Ultrieurement dans le TP, lapplication grera aussi les dpartements dans lequel travaillent les employs.

Travail raliser

Installation Apache Tomcat version 4.1.12

Tomcat est le moteur de servlets/JSP distribu par Apache. Cette version est entirement gratuite et respecte les spcifications sur les applications Web dfinies par Sun. Le fichier dinstallation est disponible ladresse suivante : http://candle.enst-bretagne.fr/download/CNAM/TOMCAT_TP1_CNAM.zip Dcompressez le fichier ZIP localement. Ce fichier comporte la fois le serveur Tomcat et lbauche de lapplication dvelopper dans ce TP. Une fois dcompress, un rpertoire nomm TOMCAT_TP1_CNAM doit apparatre. Pour fonctionner, Tomcat ncessite quune variable denvironnement nomme JAVA_HOME soit positionne. Cette variable pointe vers le rpertoire dinstallation du JDK. Pour la positionner sous Windows (ou vrifier quelle existe dj) : o Panneau de configuration > Systme > onglet Avanc > bouton Variables denvironnement o Si vous ntes pas administrateur de la machine, crez cette variable pour votre compte (attention la casse) o Exemple de valeur possible (vrifiez sur votre installation locale) : C:\Program Files\Java\jdk1.5.0_06 Le lancement de Tomcat seffectue par lintermdiaire du script startup.bat situ dans le rpertoire TOMCAT_TP1_CNAM\bin. Tomcat dispose de son propre serveur Web lanc par dfaut sur le port 8080 (et non le port classique 80). Vrifier que le serveur soit correctement lanc en testant grce un navigateur lURL : http://localhost:8080/ Si tout fonctionne la page suivante doit apparatre :
3 08/03/06

ENST Bretagne

Premire partie : installation de lapplication et comprhension de sa structure

Fichiers de lapplication Web
Les fichiers de lapplication ncessaires la ralisation du TP sont inclus dans larchive prcdemment dcompacte. Ils sont situs dans le rpertoire TOMCAT_TP1_CNAM\webapps\TP1CNAM La page daccueil de lapplication doit dj tre visualisable lURL : http://localhost:8080/TP1CNAM/index.html Le rpertoire TP1CNAM contient lensemble de lapplication Web. Sa structure est la suivante : o TP1CNAM
+-| +-| +-| | | | | | | | | | +-+-BD +-- install_base.sql (script dinstall de la base) styles +-- styles.css (styles de lappli Web) WEB-INF +-- classes | +-- Composant(s) compil(s) (vide | linitialisation) +-- lib | +-- classes12.jar (le driver JDBC dOracle) +-- src | +-- compile.bat (script de compilation) | +-- tp1cnam | | +-- ComposantBD.java (source du composant) +-- web.xml (fichier de dploiement) index.html (page daccueil) ListePersonnes.jsp (JSP aff. la liste complte)

ENST Bretagne

08/03/06

Installation de lapplication
Deux tapes : 1. Cration de la base de donnes ; 2. Mise jour les paramtres de connexion la base dans le composant ComposantBD. Pour la cration de la base, se connecter avec votre compte Oracle laide de SQLPLUS (login ? mot de passe ?) et excuter le script install_base.sql. Voir le script pour les commentaires. Cration de : o la table employe ; o la squence id_empl_seq pour lincrmentation des valeurs de la cl primaire de la table employe (colonne ID); o quelques insertions pour peupler la base. Les paramtres de connexion se mettent jour dans le fichier source du composant ComposantBD (ComposantBD.java) : o Mettre jour les attributs : username, password, host, numPort et base avec vos propres valeurs (se rfrer ventuellement au fichier tnsname.ora) o Compiler le composant laide du script compile.bat. Le rsultat de la compilation est automatiquement plac dans le rpertoire classes. Aprs compilation (ou recompilation), un arrt puis un redmarrage de Tomcat est ncessaire pour que les modifications soient prises en compte. Vrifier que laffichage de la liste des personnes fonctionne correctement. Laffichage doit correspondre la copie dcran de la page 3.

Deuxime partie : dveloppement des nouvelles fonctionnalits

Les fonctionnalits dvelopper sont prsentes (mais non effectives) dans la page daccueil de lapplication : Rechercher une personne dans lannuaire Afficher la liste complte des dpartements Rechercher un dpartement dans lannuaire Insrer une nouvelle personne Insrer un nouveau dpartement

Rechercher une personne dans lannuaire

Etapes principales : 1. Cration du formulaire Web de saisie du nom de la personne que lon recherche (fichier crer, par exemple RecherchePersonne.html). Dans un premier temps, la recherche seffectue sur le nom complet, une recherche avec le dbut du nom peut ventuellement tre dveloppe par la suite.
ENST Bretagne 5 08/03/06

2. Cration du JSP (RecherchePersonne.jsp) Rcupration du paramtre saisi dans le formulaire. Appel de la mthode de recherche de la personne par le JSP dans le composant ComposantBD. Affichage du rsultat (sil existe) par le JSP. 3. Cration de la mthode de recherche dans le composant.

Afficher la liste des dpartements

Il nexiste pas de structure de donnes (table Oracle) qui stocke les infos sur les dpartements. La premire tape consiste donc la crer. Les contraintes respecter sont nots dans le schma UML suivant :

Etapes principales : 1. Cration de la table departement et modification de la table employe (prise en compte de lappartenance obligatoire dun employ un dpartement et un seul : cl rfrentielle mettre en uvre). Mettre jour le script install_base.sql. 2. Modification des deux fonctionnalits existantes (liste des personnes et recherche dune personne) pour quelles prennent en compte cette nouvelle caractristique. 3. Sur le modle de laffichage de la liste des personnes, raliser laffichage de la liste des dpartements (cration du JSP et complment des fonctionnalits du composant ComposantBD).

Rechercher un dpartement dans lannuaire

Fonctionnalit raliser sur le mme modle que la recherche dune personne. Note : laffichage du dpartement recherch doit afficher aussi la liste des personnes qui le compose.

ENST Bretagne

08/03/06

Partie administration : fonctionnalits dinsertion de nouvelles personnes et de nouveaux dpartements

Etapes principales : 1. Cration des formulaires Web de saisie (InsertPersonne.html et InsertDepartement.html). 2. Cration des JSP (InsertPersonne.jsp et InsertDepartement.jsp). Rcupration des paramtres saisis dans les formulaires. Appel des mthodes dinsertion par les JSP dans le composant ComposantBD. Affichage dun message indiquant si linsertion a t ralise ou non. 3. Cration des mthodes dinsertion dans le composant.

ENST Bretagne

08/03/06