Créer un 'war' avec Eclipse et Ant

Dans la note précédente, il a été vu que l'on peut créer une archive 'jar' à partir d'un fichier de description 'jardesc' avec Eclipse. L'archive 'jar est utilisée pour exécuter une application JAVA sur une machine virtuelle JAVA (commande java sous DOS).

Dans le cas du déploiement d'une application 'web' JAVA, il convient d'exporter le projet Eclipse sous forme de WAR ( Web ARchive). L'archive peut ensuite être copiée dans le répertoire de déploiement d'un serveur Java. Dans le cas présent, la finalité sera de copier l'archive WAR dans le répertoire 'webapps' d'un serveur Tomcat.

Le format 'war' est en fait un 'jar' qui doit contenir un répertoire "WEB-INF" qui lui-même contient:

• un descripteur de déploiement 'web.xml'
• un répertoire 'classes' où sont placés les '.class' du code compilé
• un répertoire 'lib' où se trouvent les librairies externes 'jar'

L'archive 'WAR' peut être générée à l'aide d'ANT. Il existe en effet une tâche ANT dédiée à cette opération. Le nom de cette tâche est 'war'. L'attribut 'destfile' permet de préciser le nom de l'archive war à créer. Et l'attribut 'webxml' permet de spécifier le nom du fichier web.xml à utiliser pour déployer l'application web.

Pour constituer le contenu de l'archive on utilise divers tags:

• <classes> pour préciser où se trouvent le code compilé '.class'
• <lib> pour les libraires '.jar' externes
• <zipfileset> pour grouper des fichiers et des répertoires (dont on peut exclure des éléments)
  

Exemple de cible ANT pour la génération d'un WAR:

<property name="jsp.dir" value="WEB-INF/jsp" />   
<property name="css.dir" value="stylesheet" />   
<property name="xsl.dir" value="WEB-INF/stylesheet" />       
<property name="xml.dir" value="WEB-INF/xml" />   
<property name="tld.dir" value="WEB-INF/tld" />   
<property name="scripts.dir" value="scripts" />
<property name="onlineHelp.dir" value="help" />       
<property name="images.dir" value="images" />   

<target name="War">
<description>
Creates a War file to deploy on Tomcat 
</description>
<echo message="Creation du War" />

<war destfile="rep_destination/mon_appli.war" webxml="WEB-INF/web.xml">    
<classes dir="WEB-INF/classes"/>       
<lib dir="WEB-INF/lib" />
<fileset dir=".">
<include name="*.jsp" />
<include name="*.html" />
<include name="*.htm" />
</fileset>
<zipfileset dir="${jsp.dir}" prefix="WEB-INF/jsp" />                   
<zipfileset dir="${scripts.dir}" prefix="scripts" />
<zipfileset dir="${onlineHelp.dir}" prefix="help" />
<zipfileset dir="${images.dir}" prefix="images" />         
<zipfileset dir="${css.dir}" prefix="stylesheet" />   
<zipfileset dir="${tld.dir}" prefix="WEB-INF/tld" >
<exclude name="CVS" />             
</zipfileset>         
<zipfileset dir="${xsl.dir}" prefix="WEB-INF/stylesheet" />
<zipfileset dir="${xml.dir}" prefix="WEB-INF/xml" />         
</war>
</target>

 

Ressources:

• The J2EE tutorial: http://java.sun.com/j2ee/tutorial/1_3-fcs/doc/WCC3.html
• Ant manual / Core tasks: http://ant.apache.org/manual/CoreTasks/war.html

Auteur: Euan MATEO

Créer un 'jar' avec Eclipse

Pour Créer l'archive 'jar' à partir d'un projet Eclipse, il faut commencer par faire un clic droit puis sélectionner 'Export'. On accède alors à la fenêtre de création de l'archive (cf. capture écran).

Il est préférable de choisir un emplacement extérieur au projet pour sauvegarder le 'jar'. car le répertoire d'export doit être exclus du contenu du jar.

L'utilisation d'un fichier 'jardesc' permet de préciser et de sauvegarder les paramètres de création du jar d'un projet Eclipse. On gagne ainsi en simplicité et en fiabilité. Pour créer le fichier 'jardesc', il faut choisir l'emplacement du fichier dans la deuxième page du formulaire de création du jar (cf. capture écran):

La troisième page permet de choisir les options relatives au 'manifest' associée à l'archive jar. Pour rappel, le manifest d'un jar contient principalement le nom de la classe qui contient la méthode 'main()', soit le point d'entrée de l'application.

Une fois que le fichier  'jardesc' est créé, il suffit alors de faire 'clic droit sur le fichier jardesc > create jar'.

Le fichier 'jardesc' peut être édité et modifié. Les paramètres inclus dans le fichier 'jardesc' sont:

• L'emplacement pour le jar à exporter: <jar path="...">
  
• Les fichiers et répertoires à exporter: <selectedElements>
  
• Les options relatives au fichier 'manifest' du jar: <manifest>
• Et diverses options: <options>

Références:

• Java.net: http://today.java.net/pub/a/today/2005/03/02/eclipseStart...

Auteur: Euan MATEO

Ajouter un plugin Eclipse en ligne

La manière la plus propre d'ajouter un plugin pour Eclipse, est d'enregistrer le site distant avec  le gestionnaire de plugins en-ligne d'Eclipse. On peut y accéder par le menu Aide (fr) ou Help (en):

On ouvre alors la fenêtre d'installation qui permet de saisir l'url depuis laquelle il est possible de télécharger et mettre à jour le plugin. Pour enregistrer un nouveau site avec l'interface Eclipse en langue anglaise, il faut cliquer sur 'New Remote Site...'

On peut alors créer une nouvelle entrée dans la liste des sites distants, la nommer, et lui associer une url.

Quelques plugins interessants:

• CSSEditor - url plugin: http://csseditor.sourceforge.net/
• JSEclipse - SITE - url plugin: http://download.macromedia.com/pub/labs/jseclipse/autoins...

Auteur: Euan MATEO