TP1 : Les outils de développement en java

Ce premier tp à pour but de vous familiariser avec les outils de bases connexes à java. Nous allons traiter dans ce tp :

Exercice 1 : Installation du kit de développement java

Pour pouvoir compiler votre programme, ( sous Linux, Machintosh ou Windows ), vous devez installer les outils de développement de java. Les outils de développement de java proposés par Sun sont regroupés sous la dénomination JDK (Sun Java Developement Kit).

Sous Linux, lorsque vous êtes administrateur de votre machine, une seule commande suffit. Par exemple, sous la distribution Debian :

sudo apt-get install sun-java6-jdk

Par contre, si vous n'êtes pas administrateur de votre machine ou si vous êtes sous Windows, vous devez aller chercher les outils de développement manuellement sur le site de Sun et les installer.

Si le kit de développement 1.6 n'est pas installé sur votre machine, installez le kit de développement de java sur votre machine.

Selon votre système d'exploitation, configurez les variables d'environnement de votre machine pour que le répertoire de fichier exécutable du kit de développement java soit dans les chemins d'accès consultés par défaut par votre machine.

Exercice 2 : Compilation et exécution

Écrire un programme qui afficher Hello World. Vous écirez ce programme dans le fichier HelloWorld.java. Compilez ensuite le code source en tapant la commande:

javac HelloWorld.java

Exécutez le programme en tapant la commande:

java HelloWorld

Exercice 3 : Génération automatique de la documentation

Lorsque vous écrivez un programme ou une librairie, il est conseillé de commenter systématiquement son code. En java, lorsque vos commentaires sont écrits suivant une certaine syntaxe, il est possible de générer une documentation web de manière automatique. Pour cela, il vous suffit de taper la commande :

javadoc -d documentation *.java

Un dossier documentation a été créé dans le répertoire courant. Il contient des pages HTML. Ouvrez la page index.html avec un navigateur web. Vous trouverez alors la documentation de l'ensemble de votre code. Vous y trouverez une partie concernant la classe HelloWorld, sa méthode public static void main(java.lang.String[] args) et sons constructeur HelloWorld().

En vous inspirant du code source suivant, créez des commentaires pour le HelloWorld de l'exercice précédent :

/**
  * Implémente les véhicules.
  */
public class Vehicule {
    /**
      * Le nombre de portes du véhicule.
      */
    private int nbPortes;
    /**
      * Le nombre de roues du véhicule.
      */
    public int nbRoues;

    /**
      * Modifie le nombre de portes du véhicule
      * @param nbPortes Nombre de roue du véhicule.
      * @param nbRoues Nombre de roue du véhicule.
      */
    public void setCaracteristiques( int nbPortes, int nbRoues ){
        this.nbPortes = nbPortes;
        this.nbRoues = nbRoues;
    }
    /**
      * Renvoie le nombre de portes du véhicule.
      */
    public int getNbPortes(){
        return this.nbPortes;
    }
    /**
      * Fonction executée au démarrage du programme.
      * @param args arguments passés en parametre au programme.
      */
    public static void main(String[] args) {
        Vehicule vehicule = new Vehicule();
        vehicule.setCaracteristiques(3,4);
        System.out.println( "Nombre de portes : " + vehicule.getNbPortes() );
    }
}

Vous trouverez sur le site suivant l'ensemble des conventions à respecter pour que vos commentaires soient ajouter dans la documentation automatique: http://java.sun.com/j2se/javadoc/writingdoccomments/index.html

Exercice 4 : Créer une archive

En java,il est possible d'archiver son code dans un seul fichier qui peut alors être facilement distribué. Pour créer une archive il suffit de taper la commande suivante :

jar c myArchive.jar Fichier1 Fichier2 Fichier3

On se sert de cet outils pour faire des bibliothèques de codes source compilés. En effet, une fois la bibliothèque réalisée, il devient très facile de la distribuer et de la déployer sur une machine.

Pour désarchiver une archive, il suffit de taper la commande

jar x myArchive.jar

Archivez votre programme dans une archive.

Il est possible d'exécuter du code se trouvant à l'intérieur d'une archive. Pour cela il suffit de taper :

java -classpath ./firstproject-20090528.jar YOUR_MAIN_CLASS

Essayer d'exécuter votre code à l'aide de votre archive.

Exercice 5 : Gérer votre projet java avec Ant

Ant est un outils similaire à make. Il permet de rassembler un ensemble de règles pour effectuer diverses tâches comme:

Ant est un outils incontournable. Il est utilisé dans beaucoup de projets. Par exemple, JGraphT qui est une libraire pour modéliser les graphes, JBullet qui est un moteur Physique 3D, et beaucoup d'autre ...

Dans un projet, il est possible d'exécuter chacune des tâches précédentes quand elles sont définies en exécutant la commande suivante :

ant NOM_DE_LA_TACHE

ant

pour exécuter la tâche par défaut

Les tâches sont définie dans le fichier build.xml.

Si ant n'est pas installé sur votre machine, installer le programme. Si vous n'est pas sous linux, vous devez aller sur le site officiel : http://ant.apache.org

Essayer de compiler, et d'exécuter le code du projet qui se trouve dans le fichier premier_projet.tar.gz. Faites de même pour la javadoc.

Essayer de compiler, et d'exécuter le code de la libraire JGraphT que vous téléchargerez sur le site : http://jgrapht.sourceforge.net/.

( optionel ) Faite de même avec la librairie JBullet que vous téléchargerez sur le site : http://jbullet.advel.cz/.

En vous inspirant du fichier build.xml associé au projet, créez votre propre projet utilisant ant.

Valid XHTML 1.1