ECOM Installation Main Page

Année 2006-2007, M2PGI & RICM3

Fabienne Boyer & Didier Donsez

 Université Joseph Fourier – UFR IMA

 

 

Il est conseillé de stocker votre projet ECOM sur un support de stockage qui vous est propre (type clé USB) afin de vous permettre de travailler dans différents contextes.

 

1) Récupération du projet

Le projet peut être récupéré en sélectionnant le lien download depuis la page d’acceuil du projet ECOM. Le fichier que vous téléchargez via ce lien fournit à la fois une installation complète de JOnAS sur PC ainsi qu’une partie de l’application de commerce électronique.

 

Après avoir décompréssé le fichier chargé (unzip), vous obtenez une arborescence composée des répertoires suivants :

 

Le répertoire racine (appelons le ECOM_PROJECT) contient un fichier nommé ecom_setenv.bat, qui est un script Windows permettant de positionner les variables d'environnement requises. Vous devez mettre à jour ce fichier en fonction de votre environnement de travail. Vous devrez exécuter ce script dans chaque invite de commande Windows avant de lancer une commande JOnAS (tapez ecom_setenv, ou bien ecom_setenv.bat, ou encore ./ecom_setenv.bat dans votre invite de commandes).

2.1 Le répertoire JONAS_xx

Le répertoire JONAS_xx contient entre autres les sous-répertoires suivants :

 

2.2 Le répertoire ECOM

Le répertoire ECOM contiendra tous les fichiers définissant l’application ecom :  les beans, les pages html, les servlets, etc.

 

3) Installation et lancement de JOnAS

Une fois téléchargé et décompréssé, JonAS est prêt à fonctionner. Il suffit de lui fournir des applications à exécuter, qui doivent préalablement avoir été compilées, packagées et placées dans un répertoire dédié (JONAS_xx/ejbjars ou JONAS_xx/ejb3s par exemple). Nous allons commencer par exécuter des applications qui sont des exemples basiques fournis par JOnAS.

 

 

Vous pouvez expérimenter l’outil d’administration graphique fourni par JonAS en lanceant un brower à l’URL http://localhost:9000/jonasAdmin (user: jonas et mot de passe: jonas).

 

Dans les exemples il y a deux types de clients (lourd via RMI, et léger via des servlets). Vous testerez le bon fonctionnement du client léger pour l’exemple stateful.  Vous pouvez lancer un browser et accéder à l’url http://<hostname>:9000/<nom  de l’application>/<nom de fichier>.html (dans le cas de l’exemple stateful, l’url est http://<hostname>:9000/stateful/index.html).

 

4)  L’exemple programmez-EasyBeans-JonAS

Dans le répertoire JONAS_xx/ejb3s/programmez, se trouve l’exemple d’application EJB3 considéré dans la documentation EJB3 qui vous servira de support tout au long de ce projet. Il est demandé de comprendre cette application et de l’exécuter, en suivant les informations données dans cette documentation à partir du chapitre 3.

 

5) L’application ECOM

Vous êtes maintenant prêts à développer votre propre application ECOM en  EJB3. Il vous faut maintenant proposer un modèle de conception, en suivant les instructions données dans la documentation ECOM.

Les sources de l’application ECOM qui vous sont fournis comprennent un fichier build.xml vous fournit les commandes principales suivantes :

 

6) Téléchargements supplémentaires (si nécessaire)

5.1 ANT

L’usage de ANT est obligatoire pour déployer le serveur d’application JOnAS. Si vous ne disposez pas déjà d’une installation de ANT supérieure ou égale à la version Jakarta ANT 1.5.4, vous pouvez télécharger le logiciel ANT, depuis http://ant.apache.org/.
En cas de téléchargement, il faut dans certains cas ajouter  le jarfile bcel.jar de http://apache.crihan.fr/dist/jakarta/bcel/binaries/bcel-5.1.zip dans le répertoire  %ANT_HOME%\lib.

Dans tous les cas, il faut modifier le fichier ecom_setenv en conséquence (variable  ANT_HOME).

 

5.2 JOnAS

A tout moment, vous pouvez récupérer une version de JonAS  depuis le site ObjectWeb à l‘url de téléchargement de JOnAS : http://jonas.objectweb.org/download/index.html.