Récupération du projet

Installation du projet eCOM
Installation du projet eCOM
Sommaire
•Récupération du projet
°Le répertoire jonas-osgi-version
°Le répertoire ecom-jonas
•Installation et lancement de JOnAS
•Exemples JOnAS
°Exemples EJB 3
°L'exemple Programmez-EasyBeans-JOnAS
•L'application ECOM
•Installations
°JOnAS
°Eclipse
°Ant
°SubVersion
°Maven
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.
Récupération du projet
Les sources nécessaires au démarrage du projet sont disponibles sur la forge
(http://forge.objectweb.org/projects/ecom/) du projet eCOM.
Les sources peuvent être récupérés par téléchargement de la release ECOM-SVN.zip sur la forge
(sélectionner l'onglet fichiers, ou bien aller directement à l'url
http://forge.objectweb.org/project/showfiles.php?group_id=312).
Les sources peuvent également être récupérés au moyen d'un client SubVersion (voir annexe).
La commande à exécuter est alors la suivante:
•mkdir ecom-project
•cd ecom-project
•svn checkout svn://svn.forge.objectweb.org/svnroot/ecom
Vous devez ensuite recupérer une version stable de JOnAS (voir la section Installations à la fin de ce
document).
Après avoir décompréssé le fichier chargé, vous obtenez l'arborescence suivante :
•ecom-projet/
°/jonas-osgi-version/ (version=numéro de version)
°/ecom-jonas/
Le répertoire racine (appelons le %ECOM_ROOT%) contient un fichier nommé ecom-jonas-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 de JOnAS (tapez ecom-jonas-setenv ou bien
ecom-jonas-setenv.bat dans votre invité de commandes). Si vous travaillez dans un environnement Unix,
vous devez taper source ecom-jonas-setenv.unix.
ObjectWeb - Wiki - Main - frinstall
-1-

Ce fichier positionne en effet les variables suivantes :
•ECOM_ROOT : la racine de votre environnement de travail ECOM
•JAVA_HOME : la racine de votre installation JDK. Cette racine contient en particuler le fichier tools.jar
dans son répertoire lib (vous pouvez donc chercher pour tools.jar pour retrouver le JAVA_HOME).
° Sous Windows, la JDK s'installe par défaut sous C:
Program Files
Java
° Sous Linux, la plupart des gestionnaires de packages installent Java sous /usr/lib/java
•JONAS_ROOT : la racine de votre installation JOnAS.
•JONAS_BASE : la racine de votre configuration JOnAS. Si vous ne définissez aucun JONAS_BASE,
la configuration dans JONAS_ROOT sera appliquée.
Le répertoire jonas-osgi-version
Après avoir récupéré et installé JONAS (voir section Installations ci-après), vous obtenez une organisation
arborescente avec un répertoire jonas-osgi-version qui contient entre autres les sous-répertoires suivants :
•bin : contient les scripts JOnAS
•conf : définit la configuration du serveur JOnAS. Quelques fichiers importants de configuration :
°jonas.properties : décrit la configuration de JOnAS
°trace.properties : définit les niveaux de traces souhaités
•deploy : contient toutes les archives Java EE que JOnAS deploiera sur le serveur.
°ASTUCE : si la propriété jonas.service.depmonitor.development du fichier jonas.properties est à
true (c'est la valeur par défaut), JOnAS vérifiera le répertoire deploy et déploiera
automatiquement chaque archive Java EE que vous mettrez. Donc, pour déployer vos
applications, il suffira de les placer dans le répertoire deploy de JOnAS.
•examples : contient des exemples :
° Des exemples de clustering, pour mettre en place une infrastructure HD (Haute Disponibilité)
°J2EE 1.4 : application J2EE 1.4, donc "à l'ancienne" (EJB2, pas d'annotations)
°Java EE 5 EAR sample : application Java EE 5, donc avec des EJB3 et des servlets modernes
•lib : contient les librairies requises par JOnAS
•logs : contient les fichiers de journal JOnAS. Vous y trouverez en particulier une copie de tous les
messages que vous avez eu dans la console JOnAS.
•repositories : contient les bundles OSGi, déployées par l'infrastructure OSGi JOnAS. Vous n'aurez
pas besoin d'y toucher dans le cadre du projet ECOM simple, mais ce répertoire vous sera très utile
pour des usages plus avancés (projet M2M, déploiement d'ESB légers, etc.)
•templates : fichiers de configuration de base pour créer des nouvelles configurations JOnAS.
•tutorial : des tutoriaux JOnAS :
°Exemple JAX-WS : décrit comment créer des services Web JAX-WS de façon simple (POJOs
annotés).
Le répertoire ecom-jonas
Le répertoire ecom-jonas contiendra tous les fichiers définissant l'application ecom : les entreprise beans,
les pages HTML, les servlets, les JSPs, etc.
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 le répertoire dédié aux
applications à déployer (JONAS_BASE/deploy). Nous allons commencer par exécuter des applications qui
sont des exemples basiques fournis par JOnAS.
• Ouvrir un invite de commandes et le configurer (ecom-jonas-setenv.bat)
• Lancer le serveur JOnAS s'il ne tourne pas déjà (commande jonas start)
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://your_hostname:9000/nom_de_l_application/nom_de_fichier_.html (dans le cas de l'exemple stateful,
ObjectWeb - Wiki - Main - frinstall
-2-

l'url est http://your_hostname:9000/stateful/index.html).
Exemples JOnAS
Dans le répertoire jonas-osgi-version/examples/javaee-earsample, vous trouverz un exemple d'application
Java EE avec des EJB3s et des servlets modernes. Ce dernier vous servira de support tout au long de ce
projet. Il est demandé de comprendre cette application et de l'exécuter :
• Pour comprendre l'application, lisez la documentation JOnAS :
° Si votre serveur JOnAS est lancé, directement via la documentation interne sur
http://localhost:9000/jonas-doc-en/doc-en/html/getting_started_guide.html
° Sinon, directement sur la documentation en ligne :
http://jonas.ow2.org/JONAS_5_1_0/doc/doc-en/html/getting_started_guide.html
• L'application est décrite dans la partie "javaee5-earsample EAR Sample Architecture" de la
documentation.
Exemples EJB 3
Testé sur JOnAS 5.2.1 : ejb3-examples-for-jonas5.tgz (Egalement utilisable sur d'anciennes versions de
JOnAS 5.x, à condition d'adapter si besoin les scripts ant). L'exemple Programmez-EasyBeans-JOnAS
Cet exemple d'application EJB3 a été initialement publié dans un magazine français appelé programmez
(voir http://sardes.inrialpes.fr/~boyer/cours/EJB/WEB/programmez/programmez.html). Il contient aussi une
très bonne introdutction aux EJB3, et a l'avantage d'être en français.
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 :
• ant install : compile l'application ECOM et l'installe dans JOnAS (copie les fichiers de l'application
ECOM dans %JONAS_BASE%/deploy).
• ant run.initdatabase : lance un programme permettant d'initialiser la base de données (en CMP2.0).
• ant run.customer : lance un programme permettant créant un client ECOM dont le comportement est
défini par la classe ecom.client.ExternCustomer.java.
• ant run.admin : lance un programme permettant créant un administrateur ECOM dont le
comportement est défini par la classe ecom.client.ExternCustomer.java.
Installations
JOnAS
A tout moment, vous pouvez récupérer une version de JonAS depuis le site OW2 à l'url de téléchargement
de JOnAS : http://jonas.objectweb.org/download/index.html.
JOnAS 5 est la version qui est livrée d'office avec le support Java EE 5 (EJB3s, servlets modernes, etc.)
Eclipse
L'installation d'Eclipse se fait assez simplement :
• Allez sur http://www.eclipse.org/downloads/
• Téléchargez Eclipse IDE for Java EE Developers, cette version contient des outils pour vous aider
dans la conception d'applications Java EE.
• Décompressez le fichier dans un répertoire de votre choix
• Lancez Eclipse avec la commande eclipse
ObjectWeb - Wiki - Main - frinstall
-3-

ASTUCE : Si vous voulez lancer Eclipse avec une JDK particulière, utiliser l'option -vm de la commande
eclipse. Par exemple, eclipse -vm "C:/Program Files/Java/jdk1.6.0_13"
Plugins utiles :
• JOPE : plug-in JOnAS pour Eclipse. Une fois ce plug-in installé, vous pourrez directement lancer le
serveur JOnAS via Eclipse, profiter du redeploiement à chaud des sous-parties de votre application,
etc. Pour installer, allez sur http://wiki.jonas.ow2.org/xwiki/bin/view/IDE+Support/ et une fois installé
regardez la partie "JOPE" qui sera automatiquement ajoutée dans l'aide Eclipse.
• Subclipse : pour utiliser SVN dans Eclipse. Voir : http://subclipse.tigris.org/install.html
• m2eclipse : intégration Maven-Eclipse. Voir :
http://m2eclipse.codehaus.org/Installing_Maven_2.0_plugin_for_Eclipse.html
Ant
L'usage de ANT est obligatoire pour compiler les exemples JOnAS ainsi que le projet ECOM. Si vous ne
disposez pas déjà d'une installation de ANT supérieure ou égale à la version Jakarta ANT 1.7.0, 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-jonas-setenv.bat en conséquence (variable
%ANT_HOME%). SubVersion Si vous êtes un fan de la commande en ligne, vous pouvez récupérer la
version commande en ligne de Subversion ici : http://subversion.tigris.org/
Sinon, si vous ne savez que cliquer, vous pouvez installer TortoiseSVN sur votre machine en le récupérant
ici : http://tortoisesvn.tigris.org/
Il existe aussi un plugin pour Eclipse Subclipse : http://subclipse.tigris.org/
Il est conseillé d'avoir les 3 ! Maven
Pour les développeurs habités à Maven, il est possible de construire votre projet ecom avec Maven2. Un
exemple est donnée dans la distribution de JOnAS. Remarque: Nous n'assurons pas le support sur Maven
cette année 2007-2008 !
Installation du projet eCOM (fr)
Creator: xwiki:XWiki.donsez Date: 2007/08/23 08:35
Last Author: xwiki:XWiki.gibello Date: 2011/09/19 13:11
Copyright (c) 2005-2006, ObjectWeb Consortium
ObjectWeb - Wiki - Main - frinstall
-4-