Installations
Liste des installations
- Installer le J2SDK 1.4 ou supérieur (Java 2 Standard Development Kit) de Sun (java.sun.com)
- Dézipper le MelbaLab (télécharger ici)
- Eventuellement installer un moteur de servlets si vous souhaitez une architecture Client / Servlet /
Base de données. Tomcat de
Apache par exemple
- Installer un des SGBD (Serveur de Base de données) supportés, avec son pilote ODBC ou JDBC.
Note : il est possible d'utiliser le J2SDK 1.3.1 mais il vous faut alors une bibliothèque de
programmation implémentant les parseurs XML JAXP et SAX, telle que crimson d'Apache.
Opérations à effectuer dans le répertoire ‹melbalab-home›
Modifier le fichier <melbalab-home>/s2m[.bat] pour :
- Définir le chemin d'accès au répertoire <java-home>/bin/.
- Si vous souhaitez construire des servlets, définir le chemin d'accès au package javax.
Modifier le fichier <melbalab-home>/d2s[.bat] pour :
- Définir le chemin d'accès au fichier Jar de votre pilote JDBC.
Générer l'application de démonstration DemoContact
Pour vérifier que votre installation est complête, je vous propose de créer l'application "DemoContact" dont les fichiers sont disponibles dans <melbalab-home>/samples/. Cette application requiert la base de données DemoContact. Je donne la procédure d'installation sous MySQL. Si vous avez un autre SGBD, vous trouverez le script SQL de création des tables à la fin du fichier <melbalab-home>/samples/democontact_fr.xml.
Création de la base de données DemoContact
- Sous Windows, il est nécessaire de lancer le serveur MySQL manuellement. Dans un shell, aller dans le
répertoire <mysql-home>/bin/, puis exécuter :
mysqld -b=<mysql-home> –language=<mysql-home>\share\french –datadir=<mysql-home>\data
- Lancer le shell MySQL. Pour cela, exécuter : <mysql-home>/bin/mysql
- Pour créer la base de données DemoContact, saisissez la commande : create database DemoContact;
- Pour travailler dans DemoContact, saisissez la commande : use DemoContact;
- Faire un copier/coller du script SQL contenu à la fin du fichier
<melbalab-home>/samples/democontact_fr.xml dans le shell MySQL. Sous Windows, vous pouvez coller le
texte en cliquant sur l'icône en haut à gauche de votre fenêtre DOS.
- Pour quitter : exit. Votre base est créée.
Génération de l'application DemoContact
- Copier le fichier <melbalab-home>/samples/democontact_fr.xml vers le répertoire <melbalab-home>/src_xml/
- Ouvrir une boîte DOS / un shell
- Aller dans le répertoire <melbalab-home>/
- Exécuter : s2m democontact_fr
- Le résultat de cette commande est un fichier : democontact_fr.jar qui est placé dans <melbalab-home>/result/
- Exécuter le fichier democontact_fr.jar en double-cliquant dessus ou avec la commande :
java -jar result/AppliDemoContact_fr/guiDemoContact_fr/GuiDemoContact_fr.jar.
Vous pouvez désormais consulter le tutoriel sur Sashipa qui utilise la base DemoContact comme exemple.
Générer le source par défaut pour votre base de données
Voyons maintenant comment générer le source de l'interface pour votre application. Le programme
Database2Sashipa en crée un pour vous à partir d'une connexion à votre base de données et d'hypothèses par défaut. Il est donc nécessaire que la base de données existe.
L'interface graphique pour ce programme est en cours de développement. Voici donc les opérations à faire avec la version en ligne de commande :
- Ouvrir une boîte DOS / un shell
- Aller dans le répertoire <melbalab-home>/
- Vérifiez que votre pilote JDBC est supporté par Database2Sashipa (grille de compatibilité), puis entrez la commande qui suit :
d2s
Cette commande vous affiche les options de connexion disponibles. Relancez-là avec les informations de connexions vers votre SGBD. Par exemple, avec la base DemoContact sous PostGreSQL :
d2s -s postgresql -db DemoContact -u chocolat -p "70%" -cn "//localhost/DemoContact" -f "src_xml/democontact_auto.xml" -l fr
- Le résultat de cette commande est un fichier : democontact_auto.xml qui
est placé dans <melbalab-home>/src_xml/.
Vous pouvez dès maintenant générer votre application avec la commande : s2m democontact_auto.