Packages

Travail de semestre
Document sur les packages
Packages ..................................................................................................................................... 2
1. Introduction .................................................................................................................... 2
2. Construction du projet .................................................................................................... 3
3. Compilation .................................................................................................................... 4
4. Execution ........................................................................................................................ 5
5. Options de build.bat ....................................................................................................... 5
Bulloni Cédric
Page 1 sur 5
Septembre 2003
Travail de semestre
Document sur les packages
Packages
1. Introduction
Un packages correspond à un ou plusieurs répertoires du disque dur. Ils permettent d'organiser
les fichiers du projet.
Il faut tout d'abord créer l'arborescence du projet et mettre les fichiers nécessaire dans les
dossiers comme indiqué ci-dessous.
Exemple:
Ici le répertoire lpj-Fusxml contient 2 répertoires, lib et src.
-
lib contient les fichiers nécessaire à la compilation comme les fichiers .jar de ant,
JDOM, velocity, jaxp,… Ils sont dans le dossier ant et checkstyle.
-
src contient le fichier batch "build.bat" qui permet de construire le projet (et d'autre
options, voir plus bas) et le fichier build.xml qui s'exécute selon les options du fichier
".bat"
src contient également 3 sous-dossiers : docs, java et script.
Docs comprendra les fichiers de documentations une fois crée (voir plus bas)
Java contient le(s) fichier(s) ".java" du projet.
Enfin le dossier script contient un fichier batch qui permet de lancer l'application ainsi
que les fichiers externes que le programme utilise. Voici le contenu du fichier batch :
@echo off
rem
rem $Header: e:/CvsRepository/lpj/lpj-tutorial/lpjhelloworld/src/script/RunClass_helloworld.bat,v 1.4 2002/06/07 15:09:37 huguenin
Exp $
rem $Revision: 1.4 $
rem $Date: 2002/06/07 15:09:37 $
rem
===================================================
====
rem
rem copyright (C) 2002 Isnet24, Tous droits réservés.
rem <http://www.isnetne.ch>
Bulloni Cédric
Page 2 sur 5
Septembre 2003
Travail de semestre
Document sur les packages
rem
SET VELOCITY_PATH=..\lib\velocity-1.3.jar;..\lib\jdom.jar;..\lib\velocity-dep-1.3.jar
SET MY_CLASSPATH=..\classes;%VELOCITY_PATH%
SET MY_MAINCLASS=lpj.fusion.Fusxml
SET MY_PARAMS=
java -classpath %MY_CLASSPATH% %MY_MAINCLASS% %MY_PARAMS%
pause
Ce fichier crée les variables nécessaire a la compilation, comme le répertoire ou les fichiers
".jar" sont stockés ainsi que le répertoires ou se trouve la classe principale Fusxml.class.
La variable MY_PARAMS n'est pas affecté car Fusxml ne prend pas de paramètres.
Ensuite on lance le programme avec la commande "java" et on y ajoute les variables en
paramètres
2. Construction du projet
Afin de créer le projet et de pouvoir exécuter le programme, il faut indiquer dans le code
source la ligne suivante :
package lpj.fusion;
Ensuite dans le répertoire src, le fichier build.bat est présent. Il se
présente comme ceci :
@echo off
rem
rem $Header: e:/CvsRepository/lpj/lpj-tutorial/lpjhelloworld/src/build.bat,v 1.7 2003/01/27 10:13:50 huguenin Exp $
rem $Revision: 1.7 $
rem $Date: 2003/01/27 10:13:50 $
rem =======================================================
rem
rem copyright (C) 2002 Isnet24, Tous droits réservés.
rem <http://www.isnetne.ch>
rem
set LIB_DIR=..\lib
set ANT_HOME=%LIB_DIR%\ant
set
ANT_LIB=%ANT_HOME%\ant.jar;%ANT_HOME%\jaxp.jar;%ANT_HOME%\crimson.jar;%ANT_
HOME%\jakarta-ant-1.4.1-optional.jar
set CHECKSTYLE_LIB=%LIB_DIR%\checkstyle\checkstyle-all-2.4.jar
set ANT_CLASSPATH=%ANT_LIB%;%JAVA_HOME%\lib\tools.jar;%CHECKSTYLE_LIB%
%JAVA_HOME%\bin\java -classpath "%ANT_CLASSPATH%" -Dant.home=%ANT_HOME%
org.apache.tools.ant.Main %1 %2 %3 %4
La première et deuxième ligne du fichier après l'entête spécifie l'endroit ou sont stockés les
fichiers ".jar"
Bulloni Cédric
Page 3 sur 5
Septembre 2003
Travail de semestre
Document sur les packages
La 3ème, 4ème et 5ème ligne du fichier indiquent quels fichier ".jar" le programme doit utiliser
Enfin la dernière ligne lance la compilation avec les différents fichier ".jar" qu'on a choisi.
3. Compilation
Une fois choisi toutes les options, il suffit de double-cliquer sur le fichier bat pour construire
le projet.
On peut voir qu'un répertoire "build" est apparu. Il contient 2 répertoires :
-
bin qui contient les fichiers qui se trouvaient dans le dossier script ainsi qu'un fichier
bat qui permet d'exécuter le programme.
classes qui contient le fichier .class du programme dans le répertoire fusion.
Bulloni Cédric
Page 4 sur 5
Septembre 2003
Travail de semestre
Document sur les packages
4. Execution
Pour exectuer le programme, il suffit de double-cliquer sur le fichier bat crée qui se trouve
dans build/bin.
5. Options de build.bat
Build.bat possède plusieurs options, en voici quelques-unes :
Voici la syntaxe :
Build.bat [option]
[aucune] : Permet de construire le projet normalement.
clean : permet d'effacer le répertoire build crée lors de la construction.
doc : Crée la documentation sous forme html de l'API du projet
dist : Créer un dossier dist avec tout les fichiers nécessaire (y compris la documentation) à la
distribution du projet.
Bulloni Cédric
Page 5 sur 5
Septembre 2003