Dossier de Réalisation

Transcription

1 MAURICE Géraldine Dossier de Réalisation Programmation J2EE Documentation PartageWeb IUT de Nice, avec M. AYAS Année 2007 / 2008

2 Sommaire Introduction Conclusion 1 Cahier des Charges détaillé 2 Nouvelle Technologie : J2EE 3 Environnement de Développement 3.1 Installer Eclipse 3.2 Installer Tomcat (serveur applicatif) 3.3 Installation du driver mysql-connector 3.4 Installation de Mysql 3.5 Installer Mysql Front 4 L architecture Technique 4.1 Schéma de l architecture technique (utilisateurs) Schéma de l architecture technique (administrateurs) 4.3 Description des composants de l architecture La couche Présentation La couche Métier La couche Persistance Les Pages JSP Spécificités des navigateurs et composants 5 Architecture Applicative détaillée 5.1 Schéma de l architecture applicative détaillée 5.2 Les composants utilisés 6 Dictionnaire de données 7 Schéma des relations entre les tables de la base de données 8 Copies d écran de l ensemble des fonctionnalités de l application

3 Introduction PartageWeb est un projet (application) J2EE permettant l échange de fichiers entre différents utilisateurs ayant des profils différents. PartageWeb a été développé avec l environnement Eclipse en J2EE, tomcat, et MySQL-Front. L application fonctionne parfaitement avec Internet Explorer (jusqu à la dernière version, ainsi que Firefox et le navigateur intégré à Eclipse. Vous trouverez dans cette documentation toutes les informations nécessaires concernant l élaboration de l application, cela va du cahier des charges, en passant par l installation d Eclipse, tomcat, driver MySQL, MySQL Front Mais aussi des renseignements sur l architecture technique et applicative qui seront détaillées avec le dictionnaire de données du SGBD. Et enfin la présentation du projet complète et détaillée illustrée par des screenshot.

4 1- Cahier des Charges détaillé Objectif : L objectif du projet consiste à mettre en œuvre une application de partage de fichiers entre des utilisateurs via le Web avec des administrateurs modérant le tout. L application met en œuvre différents types de composants proposés par la plateforme J2EE tels que les JSP, les Servlets et les WebServices. Spécifications Techniques : L application doit permettre de gérer par l intermédiaire d une base de données les fonctionnalités suivantes : - Création d une base de données - Connexion (Authentification) comme utilisateur et Déconnection - Connexion (Authentification) comme administrateur et Déconnection - Listage des fichiers, répertoires et sous répertoires - Navigation : déplacement dans les répertoires et sous répertoires avec retour au répertoire parent - Indication à l utilisateur de sa position dans l arborescence - Mise en partage de fichiers la où on le souhaite (à la racine, dans un répertoire ou sous répertoire) - Téléchargement sur sa machine des fichiers mis en partage - Gestion du profil, un utilisateur peut modifier son mot de passe - Module d administration : Gestion des Fichiers : o Listage des répertoires et fichiers o Mise en partages de fichiers o Téléchargement de fichiers o Suppression de fichiers quelque soit la position dans l arborescence o Suppression de répertoires quelque soit la position dans l arborescence o Création de répertoire où on le souhaite Gestion des Utilisateurs : o Ajout d un utilisateur (création d un répertoire pour l utilisateur automatique) o Modification d un utilisateur (listage des utilisateurs) o Suppression d un utilisateur dans la base de données et du répertoire lui correspondant Gestion des Administrateurs :

5 o Ajout d un administrateur (création d un répertoire pour l administrateur automatique) o Modification d un administrateur (listage des administrateurs) o Suppression d un administrateur dans la base de données et du répertoire lui correspondant - Recherche d un fichier - Fonctionnalités de tris de recherche - Internationalisation : Français / Anglais Contraintes Graphiques : - L aspect Graphique de l application devra contenir un minimum de recherche, d esthétisme et surtout d ergonomie - Utiliser une résolution adaptée afin que tous les utilisateurs puissent voir l application de la même façon sans décalage dans l apparence et la mise en page - La présentation doit être claire, concise et simple Contraintes Techniques : Libertés : - Lors de la conception du projet, respecter une certaine arborescence - Utiliser Eclipse et Tomcat - Utiliser les styles CSS pour la mise en page de l application - La navigation doit être simple, logique et intuitive - Mettre l entête (header) des fichiers *.jsp dans un include - La mise en page (Choix des couleurs, positions des éléments, choix des images) Ressources fournies : (par Mr AYAS) Langue : Délais : - Les icones servant pour la présentation du projet (images des différents types de document listés) - Les classes java (qui ont étés améliorées par la suite) suivantes : - Français - Anglais Fichier.java User.java ConnectDB.java (complètement modifié par la suite) AppPartageWeb.java - Deux mois et demi

6 2.1 - Principes de J2EE 2 Nouvelle Technologie : J2EE Java 2 Enterprise Edition - Plate-forme de développement d'applications entreprises multi-tiers basées sur des composants standards et modulaires. Elle identifie et donne les spécifications des composants de l application : - composants logiciels ou beans (EJB), - conteneur - serveurs - clients Les beans sont installés dans la partie serveur d une application J2EE. Les conteneurs et serveurs implémentent les mécanismes de bas niveau utilisés par les applications : - transactions, - persistance, - gestion de la mémoire, - sécurité Un composant est une unité logicielle de niveau applicatif. En plus des JavaBeans, qui font partie du J2SE, J2EE supporte les types de composants suivants : - applets, - application clientes, - composants Enterprise JavaBeans (EJB), - composants Web, - composants adaptateurs de ressource

7 Composants J2EE Servlets Une servlet est un composant qui étend les fonctionnalités d'un serveur web de manière portable. Un serveur web héberge des classes Java servlets qui sont exécutées à l'intérieur du container web. Le serveur web associe une ou plusieurs URL à chaque servlet et lorsque ces URL sont appelées via une requête HTTP de l'utilisateur la servlet est déclenchée. Quand la servlet reçoit une requête du client, elle génère une réponse, éventuellement en utilisant la logique métier contenue dans des EJB ou en interrogeant directement une base de données. Elle retourne alors une réponse HTML au demandeur. On utilise l'api servlet pour : - Initialiser et finaliser la servlet - Accéder à l environnement de la servlet - Recevoir ou rediriger les requêtes et envoyer les réponses - Interagir avec d'autres serlvets ou composants - Maintenir les informations de sessions du client - Filtrer avant ou après traitement les requêtes et les réponses

8 2.3 - JavaServer Page La technologie JavaServer Pages(JSP) fournit un moyen simple et extensible pour générer du contenu dynamique pour le client web. Une page JSP est un document texte qui décrit comment traiter la requête d'un client et comment créer une réponse. Une page JSP contient : - Des informations de formatage (modèle) du document web, en HTML. On peut modifier cette partie de la page sans affecter les parties dynamiques. Cette approche permet de séparer la présentation du contenu dynamique. - Des éléments JSP et de script pour générer le contenu dynamique du document Web. La plupart des pages JSP utilise aussi des JavaBeans et/ou des Enterprise JavaBeans pour réaliser les opérations complexes de l'application. Les JSP permettent en standard d'instancier des beans, de modifier ou lire leurs attributs et de télécharger des applets. La technologie JSP est extensible en utilisant des balises personnalisées qui peuvent être encapsulées dans des bibliothèques de balises personnalisées (taglibs) 2.4 Application Web Détails application web Java DataBase Connectivity (JDBC) Cette API est développée par Sun en collaboration avec les grands éditeurs de SGBD. Les tâches assurées par JDBC sont : Gestion des connexions et transactions Préparation de requêtes SQL Accès aisé aux résultats JDBC est une architecture bas niveau, qui est utilisée dans les applications J2EE pour assurer les fonctions de persistance des données.

9 L utilisation typique de JDBC dans une classe java est la suivante : - Chargement du driver - Connexion à la base (classe Connexion) - Expression d une requête (classes Statement et PreparedStatement) - Analyse du résultat (classe ResultSet) Servlets Les servlets sont des classes Java exécutées par le serveur web en réponse à une requête du client (en utilisant le protocole http). Les servlets sont définies dans les packages suivants : - javax.servlet, contient les classes génériques (indépendantes du protocole) des servlets. La classe HTTPServlet utilise la classe ServletException de ce package pour indiquer un problème de servlet. - javax.servlet.http, contient la classe de serlvet conçue pour le protocole HTTP (classe HttpServlet). En général les servlets utilisent aussi le package java.io pour les entrées/sorties système. La classe HttpServlet utilise la classe IOException de ce package pour signaler les erreurs d'entréesortie. Java Server Pages La technologie JavaServer Page (JSP) permet de mettre des fragments de code java dans une page HTML statique. Lorsque la page JSP est chargée par un navigateur web, le code java est exécuté sur le serveur. La servlet retourne une page HTML qui peut alors être transmis au client ou subir d autres traitements. Une page JSP est un document texte qui décrit comment créer un objet réponse (response) à partir d un objet requête (request) pour un protocole donné. Le traitement d une page JSP peut entraîner la création et/ou l utilisation d autres objets. Couche Métier C est la couche principale de toute application. Elle s occupe aussi bien des accès aux différentes données qu aux traitements de celles-ci au niveau métier. Ce sont les classes java. Couche Présentation Correspondant à l'interface homme-machine (IHM). Couche Persistance C'est un ensemble de classes qui décrivent les tables du SGBD (user, admin, ).

10 3 Environnement de Développement Installer Eclipse : (SDK) Eclipse IDE est un environnement de développement intégré libre (le terme Eclipse désigne également le projet correspondant, lancé par IBM) extensible, universel et polyvalent, permettant potentiellement de créer des projets de développement mettant en œuvre n'importe quel langage de programmation. Eclipse IDE est principalement écrit en Java (à l'aide de la bibliothèque graphique SWT, d'ibm), et ce langage, grâce à des bibliothèques spécifiques, est également utilisé pour écrire des extensions. La spécificité d'eclipse IDE vient du fait de son architecture totalement développée autour de la notion de plug-in (en conformité avec la norme OSGi) : toutes les fonctionnalités de cet atelier logiciel sont développées en tant que plug-in. (Définition de Wikipédia) SDK : Standard Development Kit. Il désigne l'ensemble des outils nécessaires au développeur Java. Celui-ci contient : - Un JRE, - Les bibliothèques de développement, - Le compilateur (ou pré-compilateur) - Divers outils Marche à suivre : o Il faut télécharger Eclipse à l adresse suivante : et choisir Eclipse SDK o L installation est très simple, il suffit de décompresser l archive téléchargée dans le dossier C:\Program Files par exemple :

11 o Eclipse est installé. Il s agit d un simple exécutable. Vous obtenez donc quelque chose comme ceci dans C:\Program Files\eclipse : o Eclipse est donc maintenant installé, afin de lancer eclipse, double cliquez sur l icône eclipse.exe. Eclipse se lance et vous demande de choisir un «workspace», il s agit d un répertoire dans lequel vous allez travailler et créer vos projets. Créer un dossier «C:\ workspace» sur votre ordinateur o Une fois ce répertoire créé, cliquer sur «OK» o Vous pouvez créer un raccourci du fichier «eclipse.exe» vers le bureau afin de simplifier le lancement d eclipse.

12 3.2 - Installer Tomcat : (serveur applicatif) Afin de pouvoir ouvrir un projet J2ee tel que l application de partage de fichier PartageWeb, il faut installer un serveur d application tel que TOMCAT afin de pourvoir lancer le projet avec éclipse. o Télécharger tomcat sur le site d apache ici : choisir une version de tomcat par exemple la 5.5, choisissez la version.zip o Décompresser l archive vers C:\Program Files ou simplement C:\ peut importe o Dans eclipse, dans le menu où se trouvent «File»«Edit», aller dans «Window», puis «Open Perspective»,«Other». Une fenêtre s ouvre, il faut choisir «Java EE» puis faire «OK» o En bas d eclipse, il y a une fenêtre avec plusieurs onglets, cliquez sur l onglet «Servers» o Faire clique droit, puis «New» et «Server» o Choisir le répertoire ou a été décompressé l archive de Tomcat, puis valider. o Le serveur Tomcat apparait dans la fenêtre Servers et il est stoppé, pour le démarrer il suffit de faire clique droit dessus puis Start.

13 o Maintenant que le serveur d application est installé il faut créer un projet J2EE, voici la marche à suivre : «File», «New», «Project», choisir dans Web, «Dynamic Web Project», puis donner un nom au projet et le projet est maintenant créé, il apparait dans la liste des projets à gauche dans eclipse (fenêtre Package Explorer) Installation du driver mysql-connector Afin de mettre en place le projet PartageWeb, il est nécessaire d installer le driver pour MySQL. o Télécharger le driver MySQL Connector sur le site de MySQL : (il s agit d une archive zip) o Récupérer le.jar et le placer dans votre projet dans eclipse dans le répertoire lib : WebContent/WEB-INF/lib/ : Le driver est maintenant installé. Il faut maintenant installer le SGBD MySQL Installation de MySQL o Télécharger la dernière version du SGBD MySQL : o Décompresser l archive dans le un répertoire temporaire, et exécuter le fichier setup.exe. Lors de l installation, préciser au programme d'installation le répertoire par défaut C:\mysql comme destination des fichiers, voici le résultat :

14 o Pour démarrer le serveur, depuis une fenêtre console DOS : (se placer préalablement dans le répertoire C:\mysql\bin), puis taper mysqld --console o Pour arrêter le serveur, faire deux fois de suite Ctrl+C ou bien, depuis une autre console DOS, taper : C:\mysql\bin\mysqladmin -u root shutdown 3.5 Installer MySQL Front MySQL est un serveur de bases de données relationnelles SQL. Dans le cadre du projet PartageWeb, l utilisation d une base de données est nécessaire. Afin donc de disposer d une interface graphique pour gérer la base de données, il faut utiliser un logiciel tel que MySQL Front. o Télécharger MySQL Front : o Exécuter le programme d'installation Setup.exe o Garder le répertoire par défaut C:\Program Files\MySQL-Front comme destination des fichiers o Lancer l'outil graphique d'administration MySQL-Front (icône sur le bureau). Voici comment remplir chaque champ (évidemment le serveur MySQL doit être lancé) :

15 o Un fois Connecté, aller dans le menu en haut : «Tools», puis «Create DataBase» ensuite choisir un nom pour la base de données par exemple webpartage. La base de donnée est maintenant créée voici ce que vous obtenez : o Ensuite, il faut créer les tables dont ont va avoir besoin, il faut aller dans «Tools», «Create Table» puis donner un nom a la table et la définir suivant ce qu elle va contenir. Dans le cadre de ce projet il n est pas nécessaire de recréer entièrement toutes les tables. Il faut simplement importer le fichier *.sql qui contient toutes les tables du projet déjà définies et remplies. 4 L architecture Technique

16 4.1 - Schéma de l architecture Technique (UTILISATEUR) Client - Formulaire de Connexion - Formulaire d envoie de fichier - Formulaire de recherche et tri - Formulaire de modification de Profil - Navigation HTTP HTTP Serveur Applicatif Conteneur EJB Base de données JDBC Conteneur Web ServletAction Utilisateur Connecté Listage fichiers et répertoires Upload (Envoi) de fichiers Sauvegarde des fichiers envoyés Récupération informations fichiers Récupération Profil (infos) User Enregistrement Sessions

17 4.2 - Schéma de l architecture Technique (ADMINISTRATEUR) Client - Formulaire de Connexion - Formulaire d envoie de fichier - Navigation - Formulaire création utilisateur et Administrateur - Formulaire de modification d utilisateur et Admin - Formulaire de suppression d utilisateur et Admin HTTP HTTP Serveur Applicatif Conteneur EJB Base de données JDBC Conteneur Web ServletAction Admin Connecté Listage fichiers et répertoires Upload (Envoi) de fichiers Utilisateur / Admin modifié Fichier supprimé Utilisateur / Admin supprimé Sauvegarde des fichiers envoyés Repertoire User supprimé Récupération informations fichiers Utilisateur/Admin créé Repertoire utilisateur créé Nouveau répertoire créé Enregistrement Sessions

18 4.3 Description des composants de l architecture L application PartageWeb est composée de nombreux composant que nous allons détailler et expliquer ci dessous : La couche de présentation La servlet (ServletAction.java) : Elle gère toutes (ou presque) les fonctionnalités de l application. Elle propose les fonctionnalités suivantes : o Connexion pour les Utilisateurs / Administrateurs o Inscription d un Utilisateur / Administrateur o Modification d un Utilisateur / Administrateur o Suppression d un Utilisateur / Administrateur et du répertoire correspondant à l utilisateur o Modification du profil d un utilisateur o Upload de fichiers pour un utilisateur et un administrateur + stockage dans BDD. o Création d un répertoire o Suppression de fichiers o Téléchargement forcé des fichiers o Suppression de répertoires La couche métier ConnectionManager.java : Cette classe permet la connexion d un utilisateur et d un administrateur, on regarde dans la base de données si le login et le mot de passe saisi existent bien. On trouve donc dans cette classe les deux méthodes suivante : connectionuser(string userlogin,string userpwd) et connectionadmin(string adminlogin,string adminpwd). GestionFichier.java : Cette classe permet de gérer les fichiers on retrouve dedans la méthode qui permet de supprimer un répertoire récursivement avec tous les fichiers et répertoires qu il contient, la méthode est : deletedirectory(file path). AppPartageWeb.java : Cette classe permet de : - Connecter à la base de données un utilisateur : connexion(string userid,string userpwd) en l ajoutant à la liste des utilisateurs connectés.

19 - Créer un utilisateur avec l objet User : CreerUtilisateur(String userlogin,string userpwd) en faisant appel à creeruser() de la classe User(.java) - Supprimer un utilisateur avec l objet User : SupprimerUtilisateur(String userid,string userlogin,string userpwd,string userprofile,string userquota) en faisant appel à supprimeruser() de la classe User. - Déconnecter un utilisateur : deconnection(user user), supprime de la liste des utilisateurs connectés celui qui vient de se déconnecter. - Connecter à la base de données un administrateur : connexionadmin(string adminid,string adminpwd) en l ajoutant à la liste des administrateurs connectés. - Créer un administrateur avec l objet Admin : CreerAdministrateur(String adminlogin,string adminpwd) en faisant appel à creeradmin() de la classe Admin(.java) - Déconnecter un administrateurr : deconnectionadmin(admin admin), supprime de la liste des administrateurs connectés celui qui vient de se déconnecter La couche de persistance ConnectDB.java : Cette classe permet de : - Se connecter à la base de données via le driver jdbc grâce à la méthode : connexionbase(), - Se déconnecter de la base de données avec la méthode : deconnexionbase(), - Faire des requêtes SQL avec la méthode : requetesql(string ordre_sql) qui utilise executeupdate() et retourne un int. (Elle sert par exemple pour les INSERT, UPDATE, DELETE), - Et enfin, faire des requêtes de type SELECT : requeteselect(string ordre_sql) qui utilise executequery() et renvoie un ResultSet. User.java : Cette classe permet de gérer les utilisateurs. On peut : - Ajouter un utilisateur à la BDD avec : creeruser(), - Modifier un utilisateur dans la Base de donnée avec : modifieruser(), - Modifier le profil d un utilisateur dans la base de données : modifierprofil(),

20 - Supprimer un utilisateur de la base de données : supprimeruser(), - Lister les fichiers d un utilisateur en fonction du propritétaire du fichier : listefichiersuser(), - Lister tous les utilisateurs contenus dans la table table_user : listeruser(), Admin.java : Cette classe permet de gérer les administrateurs. On peut : - Ajouter un administrateur à la BDD avec : creeradmin(), - Modifier un administrateur dans la Base de donnée avec : modifieradmin(), - Supprimer un administrateur de la base de données : supprimeradmin(), - Lister tous les administrateurs contenus dans la table table_admin : listeradmin(), Fichier.java : Cette classe permet de gérer les fichiers. On peut : - Ajouter un fichier à la BDD avec : ajoutfichier(), - Lister tous les fichiers contenus dans la table table_fichier : listerfichier(), - Lister un répertoire à l aide d un vecteur : listerepertoire(), - Récupérer la taille exacte d un fichier (en octets, Ko, Mo) : settaille(), - Récupérer le type de fichier (répertoire ou fichier) : settype(), - Récupérer le type de document (jpg,pdf,doc,txt ) en attribuant suivant le type un icône et le libellé Les pages JSP Connexion d un utilisateur (connection.jsp): Permet à l utilisateur d accéder au partage de fichier en s identifiant. Lorsqu on clique sur «Valider», cela fait appel à la ServletAction qui récupère le pseudo et le mot de passe qui ont étés rentrés par l utilisateur. Elle se connecte à la base de données à la table table_user grâce au fichier ConnectionManager.java et à la fonction connectionuser qui lui-même fait appel au fichier ConnectDB.java qui établit la connexion avec la base. On vérifie que le login et le mot de passe existent et si oui l utilisateur est envoyé sur son espace de partage de fichiers (exploreur.jsp), sinon il est renvoyé sur la page d accueil pour s identifier correctement.

21 Connexion d un administrateur (connecadministration.jsp): Permet à l administrateur d accéder au système de gestion de l application (back office). Lorsqu on clique sur «Valider», cela fait appel à la ServletAction qui récupère le pseudo et le mot de passe qui ont étés rentrés par l administrateur. Elle se connecte à la base de données à la table table_admin. On vérifie que le login et le mot de passe existent et si oui l administrateur est envoyé sur l accueil de l administration de PartageWeb (administration.jsp), sinon il est renvoyé sur la page d accueil pour s identifier correctement. Navigation et listage des fichiers (exploreur.jsp): La navigation et le listage des fichiers et répertoire ne passent pas par la Servlet, ces deux fonctionnalités sont gérées par exploreur.jsp. C est-à-dire que lorsqu on rentre dans un répertoire en cliquant dessus, cela fait appel à exploreur.jsp, on réactualise la page en listant les fichiers contenu dans le répertoire ou sous-répertoire. Tout d abord, on récupère le chemin vers la racine, puis on récupère le répertoire vers lequel on veut aller, on créer une variable qui va stocker le répertoire courant ce qui nous permet de garder le chemin si on est dans un sous répertoire, on créer aussi une variable qui va récupérer le répertoire complet et va donc nous permettre de lister le contenu du répertoire. Ensuite on teste la où on se trouve afin d initialiser chaque variable et donc lister les bon répertoires. - Si il n y a pas de répertoire cible cela signifie que l on se trouve à la racine donc la variable du répertoire complet s initialise au répertoire Racine. - Sinon, si le répertoire cible équivaut au répertoire «parent» alors on découpe la chaine du répertoire courant au niveau du dernier caractère «/» et grâce à lastindexof("/"), on supprime le dernier répertoire de la chaine, on met donc la nouvelle valeur du répertoire courant dans la variable stockant le répertoire complet. - Sinon, on à un répertoire cible, alors on récupère le chemin courant auquel on ajoute un «/» ainsi que le nom du répertoire cible. Le répertoire complet prend donc la valeur du répertoire Racine + le répertoire courant. A chaque fois on enregistre la nouvelle valeur du répertoire courant et du répertoire (chemin) complet (à l aide de sessions). A la suite de ce teste, il nous faut lister les fichiers et répertoires présents dans le répertoire où nous nous trouvons actuellement. Pour ce faire, on crée un File auquel on passe le répertoire complet (chemin complet). On créer un vecteur qui récupère la liste des fichiers du répertoire grâce à listerepertoire de Fichier.java (parcoure le répertoire). Puis, on récupère le vecteur dans un iterator. Et enfin, pour chaque élément présent dans l iterator (grâce au hasnext()) on créer un objet de type Fichier (de Fichier.java). On affiche cette liste avec un icône différent suivant le type de fichier ou s il s agit d un répertoire.

22 Téléchargement forcé d un fichier (exploreur.jsp formulaire telecharger): - On récupère le chemin complet du dossier qui contient le fichier à télécharger, - On récupère le nom du fichier, - On ouvre un inputstream sur le fichier pour récupérer son contenu, et on remplit un servletoutputstream avec ce contenu. - On permet l enregistrement du fichier ou l ouverture grâce à une boîte de dialogue qui s ouvre. Upload (exploreur.jsp formulaire upload): Permet à un utilisateur de charger un fichier sur le serveur. Lorsqu on clique sur «Envoyer», cela fait appel à la ServletAction (upload). On récupère dans une session le répertoire complet de l endroit où on se trouve au niveau de l arborescence ainsi que le pseudo de la personne qui envoie le fichier. On crée un FileItemFactory qui récupère un objet de type DiskFileItemFactory que l on créer, puis on créer un ServletFileUpload qui récupère le factory précédemment créé. On en fait une liste d item que l on récupère dans un iterator afin de pouvoir parcourir cette liste d item. Récupération du fichier passé en paramètre dans un fieldname puis on sauvegarde le fichier sur le serveur au bon endroit grâce à la session repcomplet que l on avait récupéré et on lui donne le même nom de fichier qu il avait à l origine. Et enfin on est renvoyé sur la page exploreur.jsp. Gestion du profil (profil.jsp) : Permet à l utilisateur de changer son mot de passé. - On récupère le login et le mot de passe de l utilisateur connecté grâce aux sessions et on les affiche dans des input type text. Lors de l envoie de la modification sur mot de passe on appel la ServletAction (modifierprofil), - On créer un nouvel objet User de User.java en passant le nouveau mot de passe, - On fait appel à la méthode modifierprofil de User.java qui se connecte à la base de données et qui met à jour les champs dans la base de données. Moteur de recherche (moteurrecherche.jsp et resultatrecherche.jsp): Permet à un utilisateur de chercher un fichier par nom, propriétaire ou taille de fichier. Une fois la recherche soumise (après avoir cliqué sur «Rechercher») la recherche est traitée par le fichier resultatrecherche.jsp. - On récupère ce que souhaite chercher l utilisateur dans une variable (passé en paramètre) ainsi que où il souhaite chercher (nom de fichier, propriétaire, taille de fichier ) car ça va déterminer l endroit, la table, ou on va chercher ce que cherche l utilisateur (fichier_nom ou fichier_proprietaire, ou fichier_taille),

23 - On initialise une variable qui va comptabiliser le nombre de fichier trouvé qui va s auto incrémenter à chaque fois qu il y aura un fichier qui correspondra à la recherche, - On affiche les fichiers correspondant à la recherche avec toutes les informations les concernant + la possibilité de télécharger le fichier car le répertoire complet de l endroit où en enregistrer le fichier sur le serveur est stocké dans la base de données, - On affiche le nombre de résultats trouvés grâce à la variable qui d auto incrémente. Inscription d un utilisateur (ajouteruser.jsp): Permet à un administrateur de crée un utilisateur. Cette action fait appel à la ServletAction (inscription). On récupère les paramètres login, mot de passe, on créer un utilisateur grâce au fichier User.java et on l insère dans la base de donnée grâce à AppPartageWeb.java et User.java. Et on créer un répertoire portant le nom de login de l utilisateur avec la classe File. Redirection sur la page d accueil de l administration car il n y a que les administrateurs qui peuvent créer des comptes utilisateurs. Inscription d un administrateur (ajouteradmin.jsp): Permet à un administrateur de crée un administrateur. Cette action fait appel à la ServletAction (inscriptionadmin). On récupère les paramètres login, mot de passe, on créer un utilisateur grâce au fichier Admin.java et on l insère dans la base de donnée grâce à AppPartageWeb.java et Admin.java. Redirection sur la page d accueil de l administration. Modification d un utilisateur (modifieruser.jsp) : Tout d abord, on liste les utilisateurs enregistrés dans la base de données avec toutes les informations concernant chaque utilisateur. On se connecte à la base de données (table_user) on liste tous puis une fois que l administrateur à cliqué sur le bouton «modifier», par l intermédiaire de la ServletAction (modifieruser) et de AppPartageWeb.java, on récupère tout les paramètres concernant l utilisateur qu on réaffiche dans des input type text. Une fois les modifications faites, elles sont envoyées dans la base de données. Modification d un administrateur (modifieradmin.jsp) : Tout d abord, on liste les administrateurs enregistrés dans la base de données avec toutes les informations concernant chaque administrateur. On se connecte à la base de données (table_admin) on liste tous puis une fois que l administrateur à cliqué sur le bouton «modifier», par l intermédiaire de la ServletAction (modifieradmin) et de AppPartageWeb.java, on récupère tout les paramètres concernant l administrateur qu on réaffiche dans des input type text. Une fois les modifications faites, elles sont envoyées dans la base de données.

24 Supprimer un utilisateur (supprimeruser.jsp) : Comme pour la modification, on commence par lister tous utilisateurs ainsi que les informations les concernant. On créer un Utilisateur (User) grâce à User.java puis on fait appel à la fonction listeruser du fichier User.java. Ce dernier établit une connexion avec la base de données et récupère tout les utilisateurs de la table table_user qui sont ensuite listés dans la jsp. A côté de chaque ligne correspondant à un utilisateur il y a une croix rouge permettant de supprimer l utilisateur. Lorsqu on clique sur cette croix, le formulaire est envoyé à (traité par) la ServletAction, on récupère tous les paramètres concernant l utilisateur que l on souhaite supprimer (id, login, mot de passe, profil, quotas), on créer un Utilisateur à l aide de User.java avec en paramètre toutes les informations sur l utilisateur et on fait appel à supprimeruser de User.java qui se connecte à la base de données et qui supprime la ligne qui correspond à cet utilisateur. D autre part, on supprime le répertoire correspondant à cet utilisateur en récupérant le chemin de la racine ainsi que le nom du répertoire en l occurrence le login de l utilisateur, on créer un File et avec la fonction deletedirectory(string nomdurepertoire) qui se trouve dans GestionFichier.java on supprime récursivement le répertoire ainsi que son contenu. Si la suppression à fonctionnée l administrateur est alors redirigé vers la page d accueil de l administration (administration.jsp) sinon il est renvoyé sur supprimeruser.jsp. Supprimer un administrateur (supprimeradmin.jsp) : Il s agit du même procédé que pour supprimer un utilisateur, cependant, on ne se sert pas de la classe User.java mais Admin.java et de la table table_admin. Navigation et Listage des fichiers partie administration (adminfichiers.jsp) : La navigation et le listage des fichiers sont faits exactement de la même manière que pour le fichier explorer.jsp des utilisateurs. Cependant, il y a en plus la possibilité de supprimer un fichier ou un répertoire complet (récursivement). Pour la suppression d un répertoire (dans la ServletAction => supprrepindep) : - On récupère le chemin du répertoire qui contient le dossier que l on souhaite supprimer, - On récupère le nom du répertoire à supprimer qui est passé en paramètre, - On crée un objet File dans lequel on récupère le chemin complet ainsi que le nom du répertoire à supprimer, - On fait appel à GestionFichier.java qui contient la méthode deletedirectory qui nous permet du supprimer un répertoire récursivement en parcourant tout les fichiers contenus dans ce répertoire à supprimer et en les supprimant un à un, il en est de même pour les dossiers, - Redirection sur la page administration.jsp. Pour la suppression d un fichier :

25 - On récupère le chemin complet qui contient le dossier à supprimer ainsi que le nom du fichier à supprimer (il est passé en paramètre), - On créer un objet File auquel on passe le chemin complet + le nom du fichier, - On supprime le fichier grâce à la méthode delete() - Redirection sur la page administration.jsp. Création d un répertoire (adminfichier.jsp formulaire creerrep) Une fois le nom du répertoire saisi et que l on à cliqué sur «Ok» cela fait appel à la ServletAction (creerrep). On récupère le chemin de l endroit où doit être placé le répertoire (par exemple, à la racine ou dans un répertoire déjà existant) ainsi que le nom du répertoire passé en paramètre. On créer un File auquel on passe le chemin complet et le nom du répertoire à créer. Puis on fait un répertoire à partir du file avec mkdir, si la création du répertoire n a pas réussie alors on écrit «Répertoire non créé» et si ce répertoire existe déjà on écrit «Le répertoire existe déjà». Et enfin, on est redirigé sur adminfichier.jsp (la page de gestion des fichiers). Internationalisation (langue.jsp + tous les fichiers.jsp) Permet de gérer l anglais et le français grâce à des fichiers.properties. On initialise la langue à «français» (FR). Si la langue est égale à FR alors on utilise langue_fr.properties sinon si la langue est égale à EN (anglais) alors on utilise langue_en.properties. Le choix de la langue se fait par un simple clique sur chaque page, sur le drapeau correspondant à la langue que l on souhaite utiliser. Cela fait appel à langue.jsp avec en «paramètre» : EN ou FR Spécificités des navigateurs et composants Internet Exploreur 6 et 7 : Pour consulter les caractéristiques techniques : Mozilla Firefox : Pour consulter les caractéristiques techniques :

26 Tomcat : Serveur d application : L'ensemble de la documentation sur le serveur d'application se trouve sur le site Apache, ici : Le serveur d'application, c est ce qui permet de déployer l'application. MySQL : Le SGBD : MySQL est un système de gestion de base de données libre. MySQL fait partie des logiciels de gestion de base de données les plus utilisés au monde, autant par le grand public (application web,...) que par des professionnels, au même titre que Oracle ou Microsoft SQL Server. MySQL AB a été acheté le 16 janvier 2008 par Sun Microsystems pour un milliard de dollars américains. Caractéristiques MySQL est un serveur de bases de données relationnelles SQL développé dans un souci de performances élevées en lecture, ce qui signifie qu'il est davantage orienté vers le service de données déjà en place que vers celui de mises à jour fréquentes et fortement sécurisées. Il est multi-thread, multiutilisateurs. C'est un logiciel libre développé sous double licence en fonction de l'utilisation qui en est faite : dans un produit libre (open-source) ou dans un produit propriétaire. Dans ce dernier cas, la licence est payante, sinon elle est libre ce type de licence double est utilisé par d'autres produits. Systèmes Supportés MySQL fonctionne sur beaucoup de plates-formes différentes, incluant AIX, BSDi, FreeBSD, HP-UX, Linux, Mac OS X, NetWare, NetBSD, OpenBSDr, OS/2 Warp, SGI Irix, Solaris, SunOS, SCO OpenServer, SCO UnixWare, Tru64 Unix, Windows 95, 98, NT, 2000, XP et Vista. Les bases de données sont accessibles en utilisant les langages de programmation C, C++, C#, Delphi / Kylix, Eiffel, Java, Perl, PHP, Python, Ruby et Tcl ; une API spécifique est disponible pour chacun d'entre eux. Une interface ODBC appelée MyODBC est aussi disponible. En Java, MySQL peut être utilisé de façon transparente avec le standard JDO. Utilisation MySQL fait partie du quatuor LAMP : Linux, Apache, MySQL, PHP. Le couple PHP/MySQL est très utilisé par les sites Web et proposé par la majorité des hébergeurs. Wikipédia ainsi que de nombreuses autres entreprises et services utilisent MySQL tels que Google, Yahoo, YouTube, Adobe, AIRBUS, Alstom, Crédit Agricole, Linden Lab (Second Life), RATP, URSSAF, AFP, Reuters, BBC News, Leader Price, Système U, Cap Gemini Ernst & Young, Alcatel-Lucent et d'autres [.

27 MySQL étant jeune, il grossit avec le temps au fils de ses versions. Depuis la version 5 il est possible d'utiliser le PL/SQL originairement développé par Oracle afin d'utiliser des procédures et fonctions stockées ainsi que des triggers. Par ailleurs MySQL supporte la norme SQL2 (utilisation des JOIN), ce qui fait de lui un SGBD sûr puisque la conformité à cette norme garantira sa compatibilité avec les requêtes normalisés. Historique La première version de MySQL est apparue le 23 mai Il a d'abord été créé pour un usage personnel à partir de msql en s'appuyant sur le langage de bas niveau ISAM qu'ils trouvaient trop lent et trop rigide. Ils ont créé une nouvelle interface SQL en gardant la même API que msql. MySQL est passé en licence GPL à partir de la version (juin 2000) Version 4.0 : première version en octobre 2001, stable depuis mars 2003 Version 4.1 : première version en avril 2003, stable depuis octobre 2004 Version 5.0 : première version en décembre 2003, stable depuis octobre 2005 Version 5.1 : première version en novembre 2005, Release Candidate distribuée depuis septembre 2007 Version 5.2 : distribuée en avant-première (ajout du nouveau moteur de stockage Falcon) en février 2007, cette ligne a ensuite été renommée 6.0 Version 6.0 : première version alpha en avril 2007 En 2003, MySQL AB et SAP concluent un accord. Le résultat s appellera MaxDB. Il est issu de l'intégration du système de SAP (SAP DB) dans MySQL 5 L architecture Applicative détaillée 5.1 Schéma de l architecture applicative détaillée

28 Schéma de l architecture applicative Couche présentation Couche métier Couche Persistance Connection.jsp connecadministration.jsp ajouteruser.jsp ServletAction Action* == connexion Action* == inscription ConnectionManager connectionuser(){ } connectionadmin(){ } User Fichier modifieruser.jsp Action* == modifieruser Admin ajouteradmin.jsp Action* == inscriptionadmin GestionFichier ConnectDB supprimeruser.jsp Action* == suppruser deletedirectory(){ } supprimeradmin.jsp Action* == modifieradmin modifieradmin.jsp Action* == suppradmin AppPartageWeb Navigation profil.jsp exploreur.jsp adminfichiers.jsp moteurrecherche.jsp Action* == connecadmin Action* == modifierprofil Action* == upload Action* == uploadadmin connexion (){ } CreerUtilisateur (){ } SupprimerUtilisateur (){ } deconnection (){ } Base de données resultatrecerche.jsp *Action correspond à la variable choix Action* == creerrep Action* == supprfichier Action* == telechfichier Action* == supprrepindep connexionadmin (){ } CreerAdministrateur (){ } deconnectionadmin (){ }

29 5.2 Les composants utilisés : MysqlConnector.jar C'est la librairie qui Fournit un ensemble de classes et d interfaces permettant l utilisation sur le réseau d un ou plusieurs SGBDR à partir d un programme Java. D autre part, l API est adaptée à la connexion avec les bases de données relationnelles (SGBDR). MySQL Connector permet la gestion de la base de données par l intermédiaire de l'application PartageWeb. Chaque base de données utilise un pilote (driver) qui lui est propre et qui permet de convertir les requêtes JDBC dans le langage natif du SGBDR. Nous avons choisi d utiliser Mysql Connector car nous connaissions bien déjà son fonctionnement (suite aux TP précédent de M ITEY Patrick) Il était donc plus facile pour nous de faire la connexion à la base de donnée en utilisant ce driver. Il est connu pour fonctionner avec de nombreux produits tel que: Les serveurs d application : Apache Tomcat JBoss Weblogic IBM WebSphere Les Outils de Mapping Objet/Relationnel : Hibernate Apache ObjectRelationalBridge CocoBase Kodo Les Environnements de Développement : Eclipse Borland JBuilder IBM WebSphere Studio Exemples d utilisation de Mysql Connector avec des explications : CommonsFileUpload.jar (et CommonsIo.jar) Nous avons choisi d utiliser cet ensemble de classes (couplé à CommonsIo.jar car FileUpload dépend de Common IO) afin de pourvoir mettre en œuvre dans notre application de partage de fichiers l envoie de fichiers par un utilisateur ou administrateur quelque soit sa

30 position dans l arborescence du répertoire Racine. CommonsFileUpload.jar permet donc l envoie de fichier vers le serveur. Le package Commons FileUpload rend plus facile et performant la capacité d envoie de fichier pour les servlets et Web applications. FileUpload analyse les requêtes HTTP qui sont conformes à la norme RFC 1867, «à base de formulaires en HTML File Upload". Autrement dit, si une demande HTTP est présenté en utilisant la méthode POST, et avec un contenu de type "multipart / form-data", alors FileUpload peut analyser cette demande, et rendre les résultats disponibles d'une manière facilement exploitable par l'appelant. Le Guide d utilisation (avec explications) de Commons FileUpload est disponible ici : Les composants de l architecture : Nous avons plusieurs types de composants, il y a ceux qui font partis de la couche métier, ceux qui font partis de la couche de persistance, ceux qui font partis de la couche de présentation et enfin les JSP. L utilisation de «couches» permet l élaboration d une architecture «complexe», voici les avantages que l on peut en tirer : Structure de l application propre Modularité de l application Evolution de l application beaucoup plus facile La Classe de Présentation Contient la Servlet (ServletAction), Java Servlet est une application Java qui permet de générer dynamiquement des données au sein d'un serveur HTTP. Ce programme Java s'exécute dynamiquement sur le serveur web et permet l'extension des fonctions de ce dernier, typiquement : accès à des bases de données, transactions d'ecommerce, etc. Une servlet peut être chargée automatiquement lors du démarrage du serveur web ou lors de la première requête du client. Une fois chargées, les servlets restent actives dans l'attente d'autres requêtes du client. L'utilisation de servlets se fait par le biais d'un conteneur de servlets côté serveur. Celui-ci constitue l'environnement d'exécution de la servlet et lui permet de persister entre les requêtes des clients. L'API définit les relations entre le conteneur et la servlet. Le conteneur reçoit la requête du client, et sélectionne la servlet qui aura à la traiter. Le conteneur fournit également tout un ensemble de services standards pour simplifier la gestion des requêtes et des sessions.

31 Les Classes métier C est la couche principale de toute application. Elle s occupe aussi bien des accès aux différentes données qu aux traitements de celles-ci au niveau métier. Ce sont des javabeans : des classes java classiques qui permettent de donner des fonctionnalités à l'application. Les Classes de Persistance Ce sont les classes qui décrivent les tables de la base de données. Chaque élément de la table est associé à un attribut dans la classe correspondante. On trouve dans chacune des classes des méthodes qui permettent de faire les opérations de base de type SELECT UPDATE DELETE INSERT. La couche persistance sert de médiateur entre la couche présentation et la couche métier et contrôle l enchaînement des tâches. Elle est chargée de connaître l état des sessions des clients. Les JSP Les JSP sont utiles pour toute la partie présentation (génération du HTML à envoyer au client). Elles ne doivent pas êtres utilisés à la place du contrôleur. Par exemple, pour traiter un formulaire, on utilise une servlet plutôt qu une page JSP. Les JSP doivent avoir qu un minimum de code Java afin d être optimale.

32 6 Dictionnaire de données La base de données utilisée pour l application PartageWeb est nommée webpartage et contient 3 tables. La première est la table User qui permet de stocker tous les utilisateurs inscris (donc les informations concernant les utilisateurs), ce qui va nous permettre de récupérer ses informations pour la connexion d un utilisateur, pour la modification, suppression etc, la table Admin qui va nous permettre de stocker le login et le mot de passe de chaque administrateur afin qu ils puissent s identifier. Et enfin, la table Fichier (qui n est pas utilisée faute de temps) qui permet de stocker toutes les informations concernant les fichiers. Illustration de la base de données : Table User Illustration de table_user : Données de la table_user : Détails : Nom Type Description User_id Int Identifiant de l utilisateur qui s incrémente automatiquement à chaque fois qu un utilisateur est ajouté dans la base de données User_login Varchar Nom (Pseudo) de l utilisateur, permet de s identifier User_pwd Varchar Mot de passe de l utilisateur, permet de s identifier User_profile Varchar Profile, identité de l utilisateur User_quota Int Quota d envoie de fichier (non utilisé, mais présent

33 Table Admin en vue d une amélioration de l application) Illustration de table_admin : Données de la table_admin : Détails : Nom Type Description Admin_id Admin_login Admin_pwd Int Varchar Varchar Identifiant de l administrateur qui s incrémente automatiquement à chaque fois qu un administrateur est ajouté dans la base de données Nom (Pseudo) de l administrateur, permet de s identifier Mot de passe de l administrateur, permet de s identifier Table Fichier Illustration de table_fichier : Données de la table_fichier :

34 Détails : Nom Type Description Fichier_id Int Identifiant du fichier, qui s auto incrémente à chaque fois que l on ajoute un fichier dans la base de données Fichier_nom Varchar Nom du fichier Fichier _taille Varchar Taille du fichier Fichier _repertoire Varchar Répertoire (chemin complet) où est stocké le fichier Fichier _propriètaire Varchar Propriétaire du fichier Fichier _droits Varchar Droits sur le fichier Les droits sur les fichiers ne sont pas gérés faute de temps. 7 Schéma des relations entre les tables de la base de données ADMIN TABLE_USER USER_ID USER_LOGIN USER_PWD USER_PROFILE USER_QUOTAS TABLE_ADMIN ADMIN_ID ADMIN _LOGIN ADMIN _PWD TABLE_FICHIER FICHIER_ID FICHIER _NOM FICHIER _TAILLE FICHIER _REPERTOIRE FICHIER _PROPRIETAIRE FICHIER_DROITS Ces trois tables n ont pas de relation les unes avec les autres, elles sont indépendantes. Cependant, il est possible d envisager une relation en entre la table TABLE_USER et TABLE_FICHIER dans le cas ou on souhaiterais gérer les droits sur les fichiers en fonction du propriétaire ou bien en fonction d une liste de personnes (utilisateurs) qui pourrait avoir accès à certains fichiers et pas d autre par exemple.

35 Page d Accueil (index.jsp) 8 Copies d écran de l ensemble des fonctionnalités de l application Lorsqu'on arrive sur la page d'accueil, on a un petit texte présentant l'application avec un message de bienvenue dans lequel il y a un lien (mailto) sur le mot «administrateur» car il faut contacter l'administrateur pour obtenir un compte utilisateur pour plus de sécurité (par la suite il sera possible de changer le mot de passe créé par l'administrateur). En haut, il y a un menu qui permet, soit de revenir à la page d'accueil, soit d'accéder à la page d'identification en tant qu utilisateur ou d'accéder à la page d'identification en tant qu administrateur. Et il y a aussi deux drapeaux qui permettent de changer la langue de la page (Français ou Anglais). Page d Accueil (index.jsp) VERSION ANGLAISE

36 Nous avons choisi de développer cette application en gérant l internationalisation, il est donc possible sur chaque page de passer de l anglais au français par un simple clique sur le drapeau correspondant. Les menus, contenus et liens sont entièrement traduits. Page d identification des Utilisateurs (connection.jsp) Sur cette page, on a deux champs à remplir, le login et le mot de passe afin de se connecter à l'application. Si le mot de passe ou le login est incorrect alors l'utilisateur est redirigé sur la page d'accueil, sinon on arrive sur la page «explorer» (le partage de fichier en lui même, nous verrons cette page un peu plus bas). Il y a aussi les petits drapeaux pour changer la langue de la page. Page d identification des Administrateurs (connecadministration.jsp)

37 Comme pour la page de connexion des utilisateurs, on a deux champs à remplir, le login et le mot de passe afin de se connecter au «Back Office» (module d'administration). Si le mot de passe ou le login est incorrecte alors l'administrateur est redirigé sur la page d'accueil, sinon on arrive sur la page général de l'administration (nous verrons cette page un peu plus bas). Il y a aussi les petits drapeaux pour changer la langue de la page. Page Exploreur des utilisateurs (exploreur.jsp) Sur cette page, le menu horizontal en haut est différent maintenant que l'on est connecté. En haut on peut donc accéder aux rubriques : Explorer qui est l'explorateur de fichier (la page sur laquelle on est actuellement), upload qui est un simple lien vers une ancre c'est-àdire un lien qui renvoie sur la page où on est mais qui nous positionne directement sur la partie «upload». Ensuite il y a la rubrique moteur de recherche qui renvoie sur une autre page ou se trouve le moteur de recherche (ce que nous regarderons un peu plus bas). Puis le lien Profil pour modifier son mot de passe (nous verrons ceci aussi plus tard). Et enfin, il y a le bouton

38 Quitter qui permet de quitter la session et de revenir sur la page d'accueil de l'application (index.jsp). En dessous, l utilisateur est situé au niveau de l arborescence grâce à l indication «Vous êtes ici :../» cela signifie que l on se trouve à la racine et lorsqu on rentre dans un répertoire (par exemple le répertoire «cool» on obtient ceci : Puis, l'arborescence du répertoire «Racine» est affichée, listée. On voit donc tous les répertoires et les fichiers et il est possible de rentrer dans un répertoire ainsi que dans un sous répertoire etc... et de lister chaque fichier et répertoire quel que soit l endroit où l on est dans l'arborescence. Suivant le type du fichier on affiche une icône différente (ex : word, pdf...) et s il s'agit d'un répertoire on a le petit icône qui correspond aux répertoires sous windows, on affiche aussi la taille du fichier ainsi que le libelle (type de document). Il est aussi possible de télécharger un fichier en cliquant simplement sur l'image «télécharger» se trouvant sur la même ligne que le fichier qui nous intéresse. Lorsqu on souhaite télécharger un fichier, une fenêtre s ouvre comme ceci (car le téléchargement est forcé) : Partie Upload de fichiers (exploreur.jsp #upload)

39 Sur cette même page(exploreur.jsp), en dessous du listage des fichiers nous avons la partie Upload. Il suffit de cliquer sur parcourir de choisir le fichier que l'on souhaite envoyer et de cliquer sur envoyer. Si on fait cette opération en étant à la racine, alors le fichier se trouvera à la racine, si on rentre dans un répertoire et que l'on envoie un fichier le fichier se trouvera dans le répertoire et il en est de même avec les sous-répertoires. Lorsqu'on upload un fichier il n'est pas seulement envoyé sur le serveur, toutes les informations sur le fichier sont stockées dans la base de données. Page Moteur de Recherche (moteurrecherche.jsp) En haut, nous avons toujours le menu horizontal qui reste le même. Il y a un champ input de type text qui permet de saisir le texte ou mot clé que l'on souhaite rechercher (on n est pas obliger de taper un mot en entier, on peut taper seulement une partie du mot voir même une seule lettre ou chiffre cela suffit). Si on ne choisi rien dans le select d à côté, c'est-àdire qu'on laisse «Choisir Par» vide, la recherche sera faite dans tous les champs de la base de données. Si on choisi «Nom de Fichier» le mot clé ne sera cherché que dans les nom de fichier. Si on choisi «Propriétaire» le mot clé ne sera cherché que dans la colonne FICHIER_PROPRIETAIRE de la base de données et enfin si on choisi «Taille de Fichier» le mot clé ne sera cherché que dans la colonne FICHIER_TAILLE. Exemple : Nous cherchons le mot clé «nox» par «Propriétaire». Une fois que l'on a cliqué sur «Rechercher», la recherche est traitée par la page qui affiche les résultats de la recherche (resultatrecherche.jsp).

40 Page Résultat de la Recherche (resultatrecherche.jsp) En haut, nous avons toujours le menu horizontal qui reste le même. Les résultats sont listés on a le nom du fichier, sa taille, son propriétaire ainsi que la possibilité de le télécharger (le chemin d'accès au fichier étant stocké dans la base de données). D'autre part, le nombre de réponse trouvée est affiché en bas de la page. Ici par exemple, deux fichiers ont un propriétaire qui contient une partie du mot «nox». Page Profil (profil.jsp)

41 En haut, nous avons toujours le menu horizontal qui reste le même. Un utilisateur peut grâce à cette page modifier son mot de passe (puisque lorsqu'un administrateur créer un utilisateur il lui administre un mot de passe au hasard et l'utilisateur le change ensuite). Le champ contenant le pseudo de l'utilisateur est «grisé» (en disabled) afin qu'il ne puisse pas le modifier car en principe quelque soit le site où on est inscrit on ne modifie pas son pseudo. Cependant, il est tout de même possible de modifier son mot de passe en changeant l'ancien qui est rentré par le nouveau et de cliquer sur «Modifier». Page d Accueil de l Administration (administration.jsp) Lorsqu un administrateur est identifié, il a la possibilité de gérer, soit les fichiers, soit les utilisateurs, soit les administrateurs (en ajouter ou en supprimer). Le menu horizontal en haut sera toujours comme cela lorsqu il sera identifié, avec un lien pour retourner à l accueil, un pour aller voir les fichiers listés (suppression, création de répertoire ), un pour voir les utilisateurs (modification, suppression, création), et un autre pour voir les administrateurs. Il y a toujours les drapeaux pour changer la langue et «Quitter» pour se déconnecter.

42 Page Gestion des fichiers en Administrateur (adminfichiers.jsp) Lorsque l administrateur a cliqué sur fichiers, il se trouve sur cette nouvelle page qui lui permet de voir tous les fichiers présents sur le partage web. Les noms des fichiers, leur taille, et le libellé (s il s agit d un répertoire, d un document texte ou pdf ) sont affichés. Une phrase en haut des fichiers permet à l administrateur de savoir où il en est dans l arborescence des fichiers. Dans ce cas là, il se trouve à la racine et voit donc tous les répertoires et fichiers. Ensuite, il peut soit rentrer dans les répertoires en cliquant dessus, soit les supprimer, soit télécharger les fichiers ou les supprimer également. D autre part, la suppression d un répertoire complet est aussi possible. Le menu en haut est toujours le même que précédemment. Et quand la liste des fichiers est longue, en bas de page il y a un lien pour retourner directement en haut de page.

43 En dessous il y a la possibilité d uploader un fichier comme pour la partie utilisateur. Puis encore en dessous il y a la possibilité de créer un répertoire à la Racine ou dans un répertoire on peut donc créer des répertoires, sous-répertoires Il suffit de rentrer dans le champ texte le nom que l on souhaite donner au répertoire puis de faire «Ok». Page Gestion des utilisateurs - Accueil (adminutilisateurs.jsp) L administrateur se trouve alors sur cette page lorsqu il a cliqué sur utilisateurs dans le menu du haut. Donc ici il a la possibilité d ajouter un utilisateur, de le modifier (mot de passe, profile ) ou de le supprimer. Gestion des utilisateurs Page Ajouter un utilisateur (ajouteruser.jsp)

44 Cette page s ouvre lorsque l administrateur a cliqué sur «ajouter un utilisateur». Il apparait alors un formulaire pour inscrire le pseudo et le mot de passe du nouveau venu. C est donc l administrateur qui décide de ça, ensuite l utilisateur a la possibilité de changer son mot de passe. Si le pseudo qu il choisi est déjà utilisé, un message d erreur apparait. Enfin, il peut valider ou bien effacer ce qu il a écrit s il ne veut plus ajouter d utilisateur. A chaque ajout d un utilisateur un répertoire à la racine est créé, ce répertoire porte le nom (login) de l utilisateur, c est en quelque sorte son répertoire personnel. Gestion des utilisateurs Page Modifier un utilisateur (modifieruser.jsp)

45 Cette page s ouvre lorsque l administrateur a cliqué sur «modifier un utilisateur». Il y a la liste de tous les utilisateurs inscrits sur le partage web avec tous les détails leur correspondant (pseudo, mot de passe ). A droite de toutes ces données, il y a une petite icône où il faut cliquer pour accéder à la page pour modifier les paramètres de l utilisateur, comme ceci : Lorsqu il a cliqué sur l icône, il apparait cette nouvelle page avec un formulaire pour changer les données personnelles de l utilisateur sélectionné. Les anciennes données sont encore inscrites dans les champs du formulaire donc l administrateur fait les modifications et pour valider il clique sur modifier.

46 Gestion des utilisateurs Page Supprimer un utilisateur (supprimeruser.jsp) Cette page s ouvre lorsque l administrateur a cliqué sur «supprimer un utilisateur». Elle affiche la liste des utilisateurs inscrits avec tous les détails leur correspondant comme sur la page pour modifier un utilisateur. Au lieu de l icône pour modifier, il y a cette fois une croix rouge qui supprime l utilisateur et toutes ses données. De plus, lorsqu on supprime un utilisateur, le répertoire qui avait été créé lors de son inscription est totalement supprimé ainsi que tous les fichiers contenus dans ce même répertoire. Page Gestion des administrateurs - Accueil (adminadministrateurs.jsp)