TP Dojo

Introduction

Pour ce premier contact avec Dojo, vous allez tout d'abord installer Dojo sur un serveur, soit dans Tomcat soit dans Glassfish. Puis vous ouvrirez un projet netbeans contenant de nombreux exemples...

Installation de Dojo 1.3.2 sur les serveurs Tomcat et Glassfish

Note du 15/3/2010 : la version actuelle est 1.4.x mais la version que je vous propose ici vient avec des démos et des tests que je vous ai préparé. Tout fonctionne pareil avec dojo 1.4 mais la distribution officielle ne vient pas avec les tests et les démos. En résumé : si vous voulez faire du dojo 1.4 (je déconseille pour ce tp, pour ne pas vous compliquer la vie), tout le code de ce tp et des exemples fournis marchera pareil, il faudra juste changer quelques chemins d'inclusion dans les scripts. (M.Buffa)

Installer Dojo sur vos serveur : dezipper l'archive "dojo-release-1.3.2 avec demos et tests.rar" dans le docroot de vos serveurs. Je donne ici les répertoires que j'ai sous windows, cherchez l'équivalent sous Linux, pour ceux qui utilisent ce système, et remplacez évidemment "michel" par votre nom d'utilisateur. J'ai donné les répertoires comme exemple. Avec netbeans, pour connaitre le répertoire exact où se trouve le docroot, allez dans Tools/Server/Glassfish et regardez le répertoire d'installation.

Ouvrez l'explorateur windows et copiez dojo dans le sous-répertoire domain1/docroot (pour glassfish) par exemple. Chez moi, avec ma configuration, c'est dans :

• Pour tomcat dans : C:\Program Files\Apache Software Foundation\Apache Tomcat 6.0.18\webapps\ROOT

• Pour Glassfish v3.0.1 : dans C:\Program Files\glassfish-3.0.1\glassfish\domains\domains1\docroot

Mais selon votre OS, selon votre installation, ces chemins peuvent différer. Suivez la démarche proposée (regarder le chemin depuis netbeans, etc)

Avec mes répertoires, cela donne :

• C:\Program Files\glassfish-3.0.1\glassfish\domains\domain1\docroot\dojo-release-1.3.2 pour Glassfish v3,
• dans le répertoire dojo-release1.3.2, quatre répertoires : demos, dojo, dijit et dojox

Lancer le premier projet contenant de nombreux exemples

• Dezipper le projet netbeans "TP2 Dojo 1.3.2.rar" quelque part, par exemple là où vous stockez les projets netbeans... et ouvrez le projet dans netbeans. Si vous avez "missing server problem", faites bouton de droite/resolve missing server, sur le projet et choisissez glassfish ou tomcat. Le projet est ancien et cherche une vieille version de tomcat par défaut. Vous pouvez aussi aller dans les propriétés du projet/run (ou exécuter) et cocher "deploy on save" pour que le ctrl-s déploie incrémentalement le projet (glassfish 3 seulement).

• Faites run du projet, une page html avec un menu doit s'afficher. Ce sont des démos et des exemples à étudier.

• Etudiez les exemples, en particulier les exemples 2, 3, 9 et 10, et la démo sur les formulaires.

Je vous recommande de passer du temps surtout sur les exemples 2 et 3 utilisant les appels ajax XhrGet et XhrPost, regardez en particulier le 3 qui montre comment Dojo facilite la gestion de formulaires en ajax, avec l'envoi automatique des champs du formulaire. La démo sur les formulaires montre la même chose mais avec des widgets Dojo évolués.

Modifiez cet exemple (XhrForm) pour rajouter de nouveaux champs de formulaire (Nom et Prénom par exemple), modifiez la JSP correspondant à l'appel Ajax pour qu'elle récupère l'ensemble des valeurs et les affiche dans la chaine de caractère résultatnte.

REMARQUE : Certains exemples utilisent la bibliothèque dojo qui est installée sur le serveur (regardez les exemples 2, 3 et 4), les autres une version de Dojo qui est déployée avec l'application (les autres). C'est 100% équivalent, seule la manière dont on déclare les librairies diffère, regardez d'ailleurs ce qui change lors de l'insertion du sci. Il vaut mieux utiliser la version sur le serveur car cela accélère le temps de déploiement.
 

Etude du format JSON et de la manière dont Dojo gère le MVC

Etudiez maintenant les exemples 9 et 10 qui montrent comment Dojo sait manipuler le format JSON et faire du MVC à l'aide des différents "stores" (modèles) qu'il peut associer à des widgets comme des tableaux (grid, qui sont des vues).

Etude d'un projet simple de gestion d'annuaire en JSON

Travail à faire :

1. Dezippez le projet "AnnuaireDojoBienAE.rar" là où vous mettez les projets netbeans. Ouvrez le projet, exécutez-le.
2. Maitenant étudiez le code. Regardez la page save.jsp qui sauvegarde la base de données (un simple fichier .json), regardez sa simplicité. Cet exemple utilise un ItemFileWriteStore, soit un modèle de données en lecture ecriture.
3. modèle : identifiez la ligne (un div) qui crée le modèle au début du fichier index.html
4. vue : identifiez la déclaration de la table (de type dojoType="dojox.grid.DataGrid") dans le fichier index.html, voyez que le modèle est référencé. 
   
5. Regardez à la fin du fichier include.jsp comment sont reliés les événements lorsque on clique sur un bouton, etc les lignes sont à la fin,
6. Regardez les fonctions qui permettent d'envoyer les requêtes ajax et mettre à jour la table,
7. regardez comment est créé la fenêtre de dialogue pour les insertions de nouvelles entrées dans l'annuaire,

Le même projet mais avec une BD, une classe Entity et un web service REST (Pour ceux qui s'ennuient. Demander de l'aide au prof pour installer et faire tourner)

Pour les plus curieux, vous pourrez regarder le projet "ProjetAnnuaireTelephoniqueDojo_REST_entity_DB.rar" qui est le même que le précédent mais avec une base de donnée et un web service REST en frontal, construit automatiquement à partir d'une classe entity. Cd démo du prof...