ObjectWeb - Wiki - Main - frinstall 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. -1- ObjectWeb - Wiki - Main - frinstall 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, -2- ObjectWeb - Wiki - Main - frinstall 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 -3- ObjectWeb - Wiki - Main - frinstall 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 -4-