IV. Création de l'archive et déploiement de l'application▲
IV-A. Modification du fichier build.xml▲
Pour générer l'archive web résultant de notre application, le plugin utilise ant qui est une sorte de make pour Java.
Pour pouvoir créer l'archive web complète, nous allons devoir effectuer quelques petites modifications au fichier build.xml pour intégrer tous les fichiers nécessaires au bon fonctionnement de Struts.
Vous trouverez ce fichier dans le répertoire webApplication.
Je vais d'abord vous présenter le squelette de ce fichier.
<?xml version="1.0"?>
<project
name
=
"Web App build"
default
=
"install"
basedir
=
"."
>
<!-- build.properties hold the properties that can be customized -->
<property
file
=
"D:\Development\Eclipse\workspace\FirstStruts\..\\FirstStruts\classes/../build.properties"
/>
<property
name
=
"src.dir"
value
=
"."
/>
<property
name
=
"classes.dir"
value
=
"D:\Development\Eclipse\workspace\FirstStruts\..\\FirstStruts\classes"
/>
<property
name
=
"dist.dir"
value
=
"D:\Development\Eclipse\workspace\FirstStruts/output"
/>
<property
name
=
"dist.webapps.dir"
value
=
"${dist.dir}/wars"
/>
<property
name
=
"lib.dir"
value
=
"${jonas.root}/lib"
/>
<property
name
=
"verbose"
value
=
"false"
/>
<!-- The classpath to be used to compile examples -->
<path
id
=
"base.classpath"
>
<pathelement
location
=
"${classes.dir}"
/>
<fileset
dir
=
"${lib.dir}"
>
<include
name
=
"jonas.jar"
/>
</fileset>
</path>
<target
name
=
"init"
>
<!-- directories building -->
<mkdir
dir
=
"${dist.dir}"
/>
<mkdir
dir
=
"${dist.webapps.dir}"
/>
</target>
<target
name
=
"clean"
description
=
"Removes all the generated files or directories"
>
<!-- Delete the generated directories -->
<delete
dir
=
"${dist.dir}"
/>
</target>
<target
name
=
"war"
description
=
"Build the war file"
depends
=
"init"
>
<war
destfile
=
"${dist.webapps.dir}/FirstStruts.war"
webxml
=
"WEB-INF/web.xml"
>
<zipfileset
dir
=
"."
prefix
=
""
>
<exclude
name
=
"build.xml"
/>
<exclude
name
=
"WEB-INF/web.xml"
/>
</zipfileset>
<classes
dir
=
"${classes.dir}"
>
<include
name
=
"**/*.class"
/>
</classes>
</war>
</target>
<target
name
=
"install"
description
=
"Build and install the webapps"
depends
=
"war"
>
<copy
todir
=
"${jonas.base}/webapps/"
>
<fileset
dir
=
"${dist.webapps.dir}"
>
<include
name
=
"*.war"
/>
</fileset>
</copy>
</target>
</project>
Voici à présent les modifications à apporter pour que ce fichier soit complètement opérationnel.
Premièrement, dans la section property ajoutez la ligne suivante.
<property
name
=
"prop.dir"
value
=
"D:\Development\Eclipse\workspace\FirstStruts\source"
/>
Pensez à remplacer « D:\Development\Eclipse » par le répertoire d'installation d'Eclipse.
Ajouter ensuite cette partie qui va vous permettre de copier le fichier ApplicationResources.properties dans le répertoire classes
<target
name
=
"copy"
description
=
"copy ApplicationResources.properties file in classes file"
>
<copy
todir
=
"${classes.dir}"
>
<fileset
dir
=
"${prop.dir}"
>
<include
name
=
"*.properties"
/>
</fileset>
</copy>
</target>
Pour ajouter le fichier « properties » de l'application dans l'archive, ajoutez la ligne <include name=« **/*.properties »/> dans la portion suivante :
<classes
dir
=
"${classes.dir}"
>
<include
name
=
"**/*.class"
/>
</classes>
Pour terminer, remplacez la ligne suivante :
<copy
todir
=
"${jonas.base}/webapps/"
>
par celle-ci.
<copy
todir
=
"${jonas.base}/webapps/autoload/"
>
IV-B. Création et déploiement de l'application▲
Nous pouvons enfin déployer notre application.
Pour ce faire, rien de plus simple.
- Choisissez votre projet dans l'arborescence d'Eclipse.
- Faites un clic droit.
- Choisissez Jonas project --> Create and deploy War file.
Si tout s'est bien passé, voici normalement ce que la console a dû vous afficher.
Buildfile: D:\Development\Eclipse\workspace\FirstStruts\webApplication\build.xml
init:
war:
[war] Building war: D:\Development\Eclipse\workspace\FirstStruts\output\wars\FirstStruts.war
install:
[copy] Copying 1 file to D:\Development\jonas\webapps\autoload
BUILD SUCCESSFUL
Total time: 1 second
Dès à présent vous êtes prêt à mettre en production votre application.
IV-C. Test de l'application▲
La première chose à faire est de démarrer JOnAS.
Pour cela rien de bien compliqué, vous n'avez juste qu'à appuyer sur le 2e bouton fourni par le plugin.
Si tout se passe bien, Eclipse devrait changer de perspective et passer en mode debug.
Après le démarrage de JOnAS, la console a affiché une série de messages.
Vérifiez que vous apercevez le message suivant :
2004-05-18 14:24:17,431 : AbsJWebContainerServiceImpl.registerWar :
War /D:/Development/jonas/webapps/autoload/FirstStruts.war available at the context /FirstStruts.
Cette ligne explique que l'application a été démarrée et est disponible dans le contexte /FirstStruts.
Il ne vous reste plus qu'à tester votre application.
Ouvrez votre navigateur et tapez l'adresse suivante: http://localhost:8080/FirstStruts/
Voici normalement la page qui devrait apparaître :
Et maintenant la page affichée après avoir rentré des données valides :
Voilà, l'article est terminé, en espérant que vous aurez réussi à faire tourner votre application.
Pour toute suggestion ou amélioration, veuillez me contacter par mail à l'adresse suivante :