Creer une nouvelle classe JAVA de librairie

1. Choisir "File" > "New Project" (Ctrl-Shift-N). Dans l'onglet "Categories", selectionnez Java. Dans l'onglet "Projet", selectionnez "Java Class Librairie" et cliquer sur "Next".
2. Dans la case "Project name", entrez MyLib. Changer l'emplacement du projet pour n'importe quel repertoire de votre ordinateur. A partir de maintenant, ce cours fera reference a ce repertoire en tant que Projet_Netbeans.

   Note: Le chemin specifie ci dessus devrait apparaitre comme suit dans le champ "Project folder" de l'assistant: /Projet_Netbeans/MyLib/

3. Laissez la case a cocher "Use dedicated folder for storing librairies" non cochee. (Si vous utilisez Netbeans 6.0, cette option n'est pas disponible.)
4. Cliquez sur "Finish". Le projet "MyLib" s'ouvre a la fois dans la fenetre de projet mais aussi dans la fenetre des fichiers.

Creer une nouvelle application JAVA

1. Choisir "File" > "New project". Dans l'onglet "Categories", selectionnez JAVA. Dans l'onglet "Projects", selectionnez "JAVA application" et cliquez sur "Next".
2. Dans la case "Nom du projet", tapez MyApp. Assurez vous que l'emplacement du projet est bien Projet_Netbeans.
3. Laisser la case a cocher "Use dedicated folder for storing libraries" non cochee. (Si vous utilisez Netbeans 6.0, cette option n'est pas disponible.)
4. Entrez acrostic.Main comme nom de classe principale.
5. Assurez vous que les cases a cocher "Set as main project" et "Create main class" sont cochees.
6. Cliquez sur "Finish". Le projet "MyApp" s'affiche dans la fenetre de projet et Main.java s'ouvre dans l'editeur de source.

Configuration des chemins d'acces utilises durant la compilation

Puisque "MyApp" va avoir besoin d'une classe implementee dans "MyLib", vous devez ajouter "MyLib" dans la liste des chemins d'acces de "MyApp". En faisant cela, vous vous assurez que les classes du projet "MyApp" peuvent faire reference aux classes presentes dans le projet "MyLib" sans causer d'erreur de compilation. En plus, cela permettra a Netbeans de completer le code dans "MyApp" a l'aide du code base de "MyLib". Dans l'IDE, la liste des chemins d'acces est visuellement representee par le noeud des librairies.

Pour ajouter les classes de la librairie d'utilitaires dans les chemins d'acces du projet:

1. Dans la fenetre des projets, faites un clic droit sur le noeud des librairies pour le projet "MyApp" et choisissez "Add project...".
2. Naviguez jusqu'a Projet_Netbeans/ et selectionnez le repertoire MyLib. Le panneau des fichiers de projet JAR affiche les fichiers JAR files qui peuvent etre ajoutes au projet. Remarquez qu'un fichier JAR de "MyLib" est liste meme si vous n'avez pas encore construit le fichier JAR. Ce fichier JAR sera construit quand vous construirez et executerez le projet "MyApp".
3. Cliquez sur "Add project JA file".
4. Developpez le noeud des librairies de "MyApp". Le fichier JAR du projet "MyLib" et ajoute dans la liste des chemins d'acces declares.

Creer un package JAVA et un fichier de classe

1. Cliquez avec le bouton droit de la souris sur le noeud du projet "MyLib"et choisissez "New" > "Java Class". Tapez LibClass pour nom de la nouvelle classe, tapez org.me.mylib dans le champ "Package", et cliquez sur "Finish". LibClass.java s'ouvre dans l'editeur de source.
2. Dans LibClass.java, placez le curseur sur la ligne qui suit la declaration de la classe (public class LibClass {.
3. Tapez ou collez le code de la methode suivante:

    public static String acrostic(String[] args) {
        StringBuffer b = new StringBuffer();
        for (int i = 0; i < args.length; i++) {
            if (args[i].length() > i) {
                b.append(args[i].charAt(i));
            } else {
                b.append('?');
            }
        }
        return b.toString();
            }

4. Si le code que vous venez de coller n'est pas mis en forme correctement, appuyez sur Alt-Shift-F pour reformater l'ensemble du fichier.
5. Appuyez sur Ctrl-S pour sauvegarder le fichier.

Editer un fichier JAVA

Maintenant, vous allez ajouter du code a Main.java. En faisant cela vous verrez les fonctionnalites de completement du code et l'usage des abreviations.

1. Selectionnez l'onglet Main.java dans l'editeur de source. S'il n'est pas deja ouvert, developpez "MyApp > Source Packages > acrostic" dans la fenetre de projet et double cliquez sur Main.java.
2. Effacer le commentaire // TODO code application logic here dans la methode main.
3. A la place du commentaire, tapez le code suivant:

   String result = Li

   Positionnez le curseur immediatement apres Li. Dans l'etape suivante, vous utiliserez le completement du code pour changer Li en LibClass.

4. Appuyez sur Ctrl-Space pour ouvrir la boite de completement du code.

   Une courte liste des differentes possibilites de completement de ce que vous avez frappe apparait. La classe que vous voulez, LibClass pourrait ne pas etre presente.

5. Appuyez de nouveau sur Ctrl-Space pour agrandir la liste des possibilites offertes.

   LibClass devrait etre dans la liste.

6. Selectionnez LibClass et appuyez sur "Enter". L'IDE complete le reste du nom de la classe et cree automatiquement une ligne de code pour l'importation de la classe.

   Note: L'IDE ouvre aussi une boite au dessous de la boite de completement du code qui affiche des informations en provenance de la Javadoc pour la classe ou le package selectionne. Jusqu'ici, notre package n'a pas d'information Javadoc, la boite affiche "Cannot find Javadoc message" jusqu'a ce que vous atteignez une classe JAVA.

7. Dans la methode "Main", mettez un point apres LibClass. La boite de completement du code s'ouvre de nouveau.
8. Selectionnez la methode acrostic(String[]args) et appuyez sur "Enter". L'IDE rempli la methode acrostic et surligne le parametre args.
9. Appuyez sur "Enter" pour accepter args comme parametre.
10. Tapez un point virgule (;).

    La derniere ligne devrait ressembler a la ligne suivante.

    String result = LibClass.acrostic(args);

11. Appuyez sur "Enter" pour commencer une nouvelle ligne. Puis tapez sout et appuyez sur "Tab". L'abreviation sout se transforme en System.out.println(""); avec le curseur positionne entre les guillements. Tapez Result = a l'interieur des guillemets et + result apres le guillemet terminal.

    La derniere ligne devrait ressembler a la ligne suivante.

    System.out.println("Result = " + result);

12. Appuyez sur Ctrl-S pour sauvegarder le fichier.

Choisir la classe "Main" et les arguments d'execution

Le resultat de ce programme depend des arguments que vous lui fournissez a son lancement. Comme arguments, vous fournirez cinq mots, a partir desquels l'acrostiche "Hello" sera genere.

1. Faites un clic droit sur le noeud du projet "MyApp", choisissez "Properties", et selectionnez le noeud "Run" dans le panneau de gauche de la boite de dialogue. Notez que la classe "Main" est deja positionnee a acrostic.Main.
2. Entrez However we all feel zealous dans le champs des arguments et cliquez sur "OK".

Executer le projet principal

1. Choisisez Run > Run Main Project (F6) dans le menu "Run".
2. Double cliquez sur la fenetre "Output" afin de la maximiser, ce qui vous permettra de voir la totalite du resultat. Notez que Ant construit d'abord MyLib.jar puis compile ensuite "MyApp" en l'utilisant. Finalement, il affiche le resultat du programme, Result = Hello (l'acrostic de la phrase qui a ete transmise au programme comme argument).
3. Selectionnez la fenetre des fichiers et developpez le repertoire du projet "MyApp". Les fichiers de classe construits sont dans le repertoire build.
4. Appuyez sur F6 pour relancer le programme. Rien n'a besoin d'etre compile, le programme se lance simplement.

Nettoyer et construire le projet

Si vous construisez un projet puis ensuite modifiez des classes, il est bon d'enlever de votre systeme tous les residus des precedentes manipulations et de reconstruire l'application. Vous pouvez faire cela grece a la commande "Clean and Build".

1. Choisissez Build > Clean and Build Main Project (Shift-F11). Les deux projets, "MyApp" et "MyLib", sont nettoyes et reconstruits par cette action.
2. Faites un clic droit sur le noeud du projet "MyLib" dans la fenetre des projets et choisissez "Clean". Seul le projet "MyLib" est nettoye.

Construire un projet individuel

1. Faites un clic droit sur le noeud du projet "MyLib" dans la fenetre des projets.
2. Choisissez "Build" dans le menu contextuel.

Generer de la Javadoc

1. Selectionnez le projet "MyLib".
2. Choisissez Build > Generate Javadoc for "MyLib" dans le menu principal de l'IDE.

   L'IDE affiche la sortie Javadoc dans la fenetre "Output", et votre navigateur Internet s'ouvre en affichant la Javadoc.

Creer un test JUnit

1. Faites un clic droit sur le noeud LibClass.java dans la fenetre des projets et choisissez Tools >Create JUnit Tests (Ctrl-Shift-U).

   Si c'est la premiere fois que vous creez un test JUnit dans l'IDE, il vous sera demande de choisir la version de JUnit que vous souhaitez utiliser. Appuyez sur "Enter" pour selectionner JUnit 4.x et continuez avec la boite de dialogue "Create Tests".

2. Dans la boite de dialogue "Create Tests", cliquez sur "OK" pour lancer la commande avec les options par defaut. L'IDE cree le package org.me.mylib et le fichier LibClassTest.java dans un repertoire a part test folder. Vous pouvez trouver ce fichier en developpant le noeud "Test Packages" et le sous noeud org.me.mylib.
3. Dans LibClassTest.java, supprimez le corps de la methode public void testAcrostic().

   Note: Dans NetBeans IDE 6.0, cette methode est appelee acrostic.

4. A la place des lignes supprimees, tapez ou coller les lignes suivantes:

   System.err.println("Running testAcrostic...");
   String result = LibClass.acrostic(new String[]
                     {"fnord", "polly", "tropism"});
               assertEquals("Correct value", "foo", result);

5. Save the file by pressing Ctrl-S.

Executer le test JUnit

1. Selectionnez le noeud du projet "MyLib" et choisissez Test "MyLib" (Alt-F6). L'onglet "MyLib" (test) s'ouvre dans la fenetre de sortie. Les cas decrits dans le test JUnit test cases sont compiles et executes. Les resultat du test JUnit montre que le test est concluant.
2. Vous pouvez aussi lancer un fichier de test unique plutet que de tester la totalite du projet. Selectionnez l'onglet LibClass.java dans l'editeur de source et choisissez Run > Run File  > Test "LibClass.java" a partir du menu "Run".

La documentation de l'API de JUnit est disponible dans l'IDE. Choisissez Help > Javadoc References > JUnit API.

Vous pouvez approfondir vos connaissances sur JUnit en visitant http://www.junit.org

Deverminer le projet

1. Dans le fichier LibClass.java , allez a la methode acrostic et placez le point d'insertion sur la ligne b.append(args[i].charAt(i));. Puis appuyez sur Ctrl-F8 pour positionner un point d'arret.
2. Choisissez Run > Debug Main Project (Ctrl-F5). L'IDE ouvre la fenetre du devermineur et y execute le projet jusqu'a ce qu'un point d'arret soit atteint.
3. Selectionnez la fenetre de variables locales et developpez le noeud args. Le tableau de chaines de caracteres contient les phrases que vous avez entre comme arguments de commande.
4. Cliquez sur Step Into (F7) dans la barre d'outils pour avancer pas a pas dans le programme et voir l'acrostiche se construire.

   Quand le programme atteint la fin, la fenetre du devermineur se ferme.