guide pratique edi netbeans pratique edi... · voir les méta-données du projet et les résultats...

Guide Pratique EDI NetBeansCopyright 2005 Sun Microsystems, Inc. All rights reserved.

Table des MatiresCration d'un Projet ....................................................................................................................... 1Fentre Projects.............................................................................................................................. 3Configuration du Classpath............................................................................................................. 3Cration d'un Sous-Projet............................................................................................................... 5Cration et Edition de Fichiers........................................................................................................ 6A Propos de l'diteur de Source..................................................................................................... 7Configuration et Modification de Paquetage Java.......................................................................... 9Compilation et Construction............................................................................................................ 9Voir les Mta-Donnes du Projet et les Rsultats de la Construction........................................ 10Positionnez dans le Source les Erreurs de Compilation............................................................... 11Excution...................................................................................................................................... 11Cration et Execution des Tests................................................................................................... 12Dboguer l'Application.................................................................................................................. 12Intgration Commandes Contrle de Version............................................................................... 13Gestion des Fentres de l'EDI...................................................................................................... 15

Essentiels EDI NetBeans

Ce chapitre fournit un aperu gnral du workflow de l'EDI et des parties clefs de l'EDI. Une fois que vous aurez termin ce chapitre, vous devriez avoir une comprhension solide des principes de l'EDI et tre capable de tirer profit des fonctionnalits principales de l'EDI.

Si vous tes dj familiaris avec l'EDI NetBeans (4.0 ou plus), vous pouvez probablement survoler ce chapitre ou carrment le sauter. Les chapitres qui suivent vont revenir sur la plupart des points abords ici, mais plus en profondeur pour rpondre aux questions plus complexes, et fournir des dtails supplmentaires que vous pouvez utiliser pour arracher plus de productivit de l'EDI.

Cration d'un Projet Avant que vous ne puissiez faire un travail srieux dans l'EDI, vous devez dfinir un projet. Le

projet dfinit essentiellement un contexte dans lequel vous pouvez crire, compiler, tester et

Guide Pratique EDI NetBeans, Essentiels EDI NetBeans, 1

dboguer vos applications. Ce contexte comprend le classpath, les dossiers avec vos sources et tests, et un script Ant avec les targets pour la compilation de l'application, l'excution des tests, la cration de fichiers JAR (ou d'autres types de fichiers d'archive distribuables).

Vous pouvez choisir parmis une varit de catgories de modles de projet, qui sont regroups selon la technologie sur laquelle vous bas votre application (exemple: standard Java, J2EE Web tier, J2EE Enterprise tier, J2ME).

Dans les catgories de modles, vous avez des modles pour de nouvelles applications, et pour instaurer un projet EDI pour des applications existantes sur lesquelles vous travaillez. L'assistant New Project fournit une description pour chaque modle.

Les modles With Existing Sources de chaque catgorie vous permet d'instaurer des projets EDI standards autours des applications que vous avez dvelopps dans un environnement diffrent.

Les modles With Existing Ant Script de chaque catgorie vont une tape plus loin et vous permet d'instaurer un projet entirement bas sur un script Ant existant. Cette approche requiert quelques configuration manuelle pour que certaines fonctionnalits (comme le dbogage) fonctionne avec le script Ant. Mais le rsultat est que vous avez un EDI qui fonctionne avec tout type de structure de projet, mme s'il n'adhre pas aux conventions d'un projet standard de l'EDI.

Pour instaurer un projet:

[nl] Choisissez File | New Project.[nl] Dans l'assistant, slectionnez un modle pour votre projet, et completer l'assistant.

Les champs qui vons sera demand de completer dpendent du modle. Typiquement, vous avez besoin de spcifier un emplacement pour le projet (ou, dans le cas d'un projet qui utilise des sources existantes, l'emplacement de ces sources). Les projets Web, Entreprise, et Mobilit incluent galement des champs apprpris pour ces types spcifiques d'applications.

Illustration 2-1

Assistant New Project, Modle Web Application, Page Name and Location

Lorsque vous crez un projet, typiquement l'EDI va faire les choses suivantes pour vous:


[lb] Crer une arborescence de source avec une classe squelette dedans.[lb] Crer un dossier pour les tests unitaires.[lb] Crer un script Ant (build.xml), qui contient les instructions que l'EDI utilise

lorsque vous excutez des commandes sur votre projet, comme la compilation de fichiers sources, l'excution de l'application, l'excution des tests, dbogage, gnration de la documentation Javadoc, et des fichiers JAR.

Vous pouvez trouver plus d'information quant la configuration des projets dans le Chapitre 3.

Fentre ProjectsLa fentre Projects est essentiellement le centre de commande de votre projet. Il est organis comme une arborescent de noeuds qui reprsentent des parties de votre projet. Il fournit un point d'entre pour vos fichiers ainsi que les options de configuration pour l'application que vous dveloppez.

En plus d'afficher des noeuds pour les fichiers dans l'application que vous dveloppez, il affiche galement des noeuds pour les bibliothques significatives pour votre application. Les noeuds de bibliothque montrent la version de JDK pour laquelle vous dveloppez ainsi que les autres bibliothques sur lesquelles votre projet se base.

La fentre Projects vous prsente votre projet sous une forme logique. C'est dire qu'il reprsente les lments de votre application conceptuellement (plutt que littralement). Par exemple, les sources Java sont regroups en packages, sans noeuds pour chaque niveau de hirarchie de fichier. Les fichiers que vous ne devez normallement pas voir, comme les classes Java compiles et les fichiers de mta-donnes du projet sont cachs. Cela simplifie l'access aux fichiers sur lesquels vous travaillez rgulirement. De plus, la fentre Projects fournit un noeud Libraries, qui vous donne une vue de votre classpath.

Si vous dsirez naviguer dans la structure physique du projet, y compris les mta-donnes du projet, les classes compiles, les fichiers Jar et d'autres fichiers crs lors du build, ouvrez la fentre Files.

Configuration du ClasspathLorsque vous crez un projet, l'EDI dfinit un classpath par dfaut pour vous, bas sur le

modle de projet que vous avez slectionn. Si vous avez d'autres choses ajouter votre classpath, vous pouvez le faire via le noeud Libraries du projet.

En fait, l'EDI fait la distinction entre plusieurs types de classpath, selon le type de projet, comme le classpath de compilation, le classpath de compilation des tests, le classpath d'excution, et le classpath d'excutio des tests. Le classpath de compilation sert typiquement de base pour les autres classpaths (c'est dire que les autres classpaths hritent de ce qui a dans le classpath de compilation).

Pour ajouter un lment au classpath de compilation (et donc galement aux autres classpaths), cliquez-droit sur le noeud Libraries du projet et choisissez Add JAR/Folder.


Illustration 2-2

Fentre Projects. Ajout d'un fichier JAR au classpath.Conseil EDI NetBeansLorsque vous cliquez-droit sur le noeud Libraries, vous pouvez galement rajouter Add Project ou Add Library. Lorsque vous rajoutez un projet, vous ajoutez le rsultat du projet (comme un fichier JAR) au classpath.

You can edit other classpaths in the Properties dialog box for a project. To open the Project Properties dialog box, right-click the project's node in the Projects window and choose Properties. In the dialog box, click the Libraries node and use the customizer in the right panel to specify the different classpaths.

Si vous choisissez Add Library, vous pouvez rajouter une des libraries reconnues par le gestionnaire de bibliothques de l'EDI. Dans ce contexte, les bibliothques sont essentiellement juste un moyen de regrouper un ou plusieurs fichiers JAR, leurs sources et/ou leur documentation Javadoc. Vous pouvez grer des bibliothques existantes et en concevoir de nouvelIes dans le Gestionnaire de Bibliothques, que vous pouvez ouvrir en choisissant Tools | Library Manager.


Illustation 2-3Bote de Dialogue Project Properties, page Libraries.

Cration d'un Sous-ProjetBien qu'il n'y ait pas de distinction explicite dans l'EDI entre un projet et un sous-projet,

vous pouvez crer une hirarchie de projets en spcifiant des dpendances entre les projets. Par exemple, vous pouvez crer un projet Application Web ombrelle qui chapeaute un ou plusiers projet Java Class Library. Pour des applications plus larges, vous pourriez avoir plusieurs niveaux de dpendance de projet.

Pour dfinir des dpendances entre les projets:

[nl] Cliquez-droit sur le noeud Libraries du projet et choisissez Add Project.Once you have established this dependency, the distributed outputs (such as JAR files) of the

added project become part of the other project's classpath.[nl] Dans la bote de dialogue qui apparait, naviguez jusqu'au dossier du projet dont

vous dsirez dpendre. Les dossiers du projet sont dsigns par l'icne .


Illustration 2-4Fentre Projects. Cre une dpendance d'un projet sur un autre.

Conseil EDI NetBeansIl n'y a pas de distinction visuelle entre projet et sous projets dans l'EDI, mais il y a un concept de projet principal. Le projet principal dans l'EDI est simplement celui que l'EDI traite comme le point d'entre pour les commandes principales comme Build Main Project and Run Main Project. Le project principal est indiqu avec une police en gras dans la fentre Projects.Il ne peut y avoir qu'un seul projet principal la fois, bien qu'il soit possible d'avoir de multiples projets ouverts en mm temps (y compris des projets ombrelles qui servent de points d'entre pour les autres applications que vous dveloppez).Vous pouvez faire d'un projet le projet principal en cliquant-droit sur son noeud dans la fentre Projects et en choisissant Set Main Project.

Cration et Edition de FichiersUne fois que vous avez dfini un projet, vous pouvez ajouter des fichiers votre projet et

commencer son dition. Vous pouvez ajouter des fichiers un projet en les crant depuis l'assistant Nouveau Fichier.

Pour ouvrir l'assistant Nouveau Fichier, faites l'une des choses suivantes:

[lb] Dans la fentre Projects, cliquez-droit sur le noeud Source Packages (ou l'un des noeuds de paquetage qu'il comprend) et choisissez un des modles depuis le sous-menu New. Si aucun des modles prsents ne vous convient, choisissez File/Folder (comme montr dans l'illustration 2-5) pour ouvrir un assistant avec une slection complete des modles disponibles.

[lb] Choisissez File | New File pour ouvrir l'assistant New File.

Illustration 2-5Fentre Projects. Cration d'un nouveau fichier


Dans l'assistant New File, vous pouvez nommer le fichier et spcifier un dossier. Pour les classes Java, vous pouvez dsigner un nom de paquetage comprenant des points (au lieu des barres obliques dlimitant les noms des dossiers).

Une fois que vous avez fini avec l'assistant, le fichier s'ouvre dans un onglet de l'aire d'dition, droite de la fentre Projects.

A Propos de l'diteur de SourceL'Editeur de Source est le point central de l'EDI, l o vous allez crirer et gnrer du code. L'diteur de Source est en fait une collection de diffrents types d'diteurs avec diffrents buts. Il y a des diteurs de texte pour diffrents types de fichiers, comme les fichiers Java, JSP (comme montr sur l'illustration 2-6), XML, HTML, et les fichiers textes. Illustration 2-6Fentre Editeur de Source avec fichier JSP ouvert.


Il y a galement des diteurs visuels pour les forms AWT et Swing, les descripteurs de dployement, et autres types de fichiers, bien qu'il est galement possible d'diter directement le source de ces types de fichier.

Par exemple, les modles GUI comme JPanel Form et JFrame Form s'ouvre dans un diteur visuel (comme montr dans l'illustration 2-7) avec les fentres Palette, Inspector, et Properties. Vous pouvez cliquez sur le bouton Source dans la barre d'outil pour accder au source du fichier.Illustration 2-7Editeur Visuel de Form dans la fentre d'diteur de Source.


Configuration et Modification de Paquetage JavaVous pouvez configurer un paquetage Java grce aux assistants New Project et New File.

Vous pouvez galement crer des paquetages sans utiliser ces assistants.Pour crer un nouveau paquetage, cliquez-droit sur le noeud Source Packages dans votre projet

et choisissez New | Java Package. Dans l'assistant, remplisser un nom de paquetage, dlimit par un point(exemple: com.masociete.monapplication).

Vous pouvez ensuite dplacer des classes dans ce paquetage via couper/coller ou en dplaant leurs noeuds la souris.

Conseil EDI NetBeansLorsque vous dplacez des classes, la bote de dilaogue Refactor Code for Moved Class s'ouvre et propose de mettre jour le restant du code dans le projet pour refleter le changement d'emplacement de la classe. Cliquez sur Next pour obtenir un aperu des modifications dans la fentre Refactoring. Cliquez ensuite sur Do Refactoring pour effectuer les changements proposs.

Compilation et ConstructionLorsque vous avez dfini un projet, l'EDI lui fournit des paramtres par dfaut de classpath et

de compilation, pour que le projet soit prt compiler ds que vous avez ajout quelques classes au projet.


Vous pouvez compiler un fichier ou paquetage isolment en cliquant droit sur son noeud et en choisissant Compile. Mais gnralemetn, vous allez construire le projet dans son entiret. Slon le type de projet, sa construction consiste typiquement compiler les projets et sous-projets et crer les rsultats comme des fichiers JAR pour chacun de ces projets.

Pour construire votre projet, cliquez-droit sur le noeud du projet dans la fentre Projects et choisissez Build Project. Si ce projet est dsign comme projet principal (le nom du projet est en gras dans la fentre Projects), vous pouvez choisir Build | Build Main Project ou pressez F11. Si vous dsirez effacer les produits des builds prcdents avant de reconstrure, choisissez Build | Clean et Build Main Project ou pressez Shift-F11.

Lorsque vous initiez un build, l'EDI indique la progression de la construction dans la fentre Output sous la forme d'un output Ant.

Conseil EDI NetBeansVous pouvez spcifier les options de compilation dans la bote de dialogue Project Properties. Cliquez-droit sur le noeud du projet dans la fentre Projects et choisissez Properties. Ensuite, cliquez sur le noeud Compiling pour y introduire les options.

Voir les Mta-Donnes du Projet et les Rsultats de la Construction

Dans la fentre Files, vous pouvez voir la structure physique de votre projet, y compris les fichiers de classes compiles, les fichiers JAR, vos scripts Ant, et autres mta-donnes du projet.

Les commandes lies au projet (comme Build Project) ne sont pas disponibles depuis les noeuds dans la fentre Files, mais d'autres commandes de type Explorer comme Open, Cut, et Paste sont prsentes.

La fentre Files est trs utile si vous dsirez personnaliser le script pour votre projet ou si vous dsirez naviguer parmis les rsultats de votre projet. Vous pouvez galement examiner le contenu des fichiers JAR crs par votre projet.

L'illustration 2-8 montre la structure de l'application HelloWorld cre au Chaptre 1.


Illustration 2-8Fentre Files. Vue physique du projet HelloWorld

Positionnez dans le Source les Erreurs de CompilationSi des erreurs de compilation sont reportes lorsque vous compilez, vous pouvez placer le

curseur directement sur la ligne provoquant l'erreur de compilation en double-cliquant sur l'erreur apparaissant dans la fentre Output sous la forme d'un hyper-lien (comme montr dans l'illustration 2-9) ou en pressant F12.

Si vous avez plusieurs erreurs, vous pouvez utiliser F12 (Erreur Suivante) et Maj-F12 (Erreur Prcdente) pour vous dplacer d'une erreur l'autre.Illustration 2-9

Fentre Output montrant une erreur de compilation.

ExcutionVous pouvez excuter l'application que vous dveloppez depuis l'EDI en cliquant-droit sur le

noeud du projet et en choisissant Run Project ou en pressant F6.


Vous pouvez excuter un fichier individuellement en cliquant-droit sur le fichier dans l'Editeur de Source ou le noeud du fichier dans la fentre Projects et choisissant Run File ou en pressant Maj-F6.

Vous pouvez arrter une application qui s'excute en ouvrant la fentre Runtime, tendant le noeud Processes, et cliquant droit sur le noeud du processus qui s'excute pour finalement y choisir Terminate Process.

Si vous avez besoin de spcifier une classe principale pour le projet, ou si vous dsirez excuter le projet avec quelques arguments, vous pouvez les spcifier dans la bote de dialogue Project Properties.

To for the project to run in the IDE. You can do so by right-clicking the project's node in the Projects window, choosing Properties, selecting the Run node, and entering

Cration et Execution des TestsLes modles de projet de l'EDI sont conu avec les tests unitaires l'esprit. La plupart des

types de projets cre un dossier, cot de celui contenant vos sources, pour les test unitaires. Vous pouvez demander l'EDI de gnrer le squelette du code pour le test unitaire d'une classe et le placer dans le dossier de test avec une structure de paquetage correspondant celle de la classe tester.

Pour gnrer le code de test unitaire pour une classe:

[nl] Dans la fentre Projects, cliquez-droit sur la classe pour laquelle vous dsirez crer un test et choisissez Tools | JUnit Tests | Create Tests.

[nl] Dans la bote de dialogue Create Tests, indiquez un nom de classe et son emplacement, et spcifiez les options de gnration de code pour le test.Par dfaut, le nom de la classe est remplis pour vous et correspond au nom de la classe tester avec Test suffix au nom. Les classes de test sont places dans un dossier test qui a la mme structure de paquetage que vos sources.

Pour excuter les tests du projet slectionns, pressez Alt-F6 ou choisissez Run | Test NomDuProjet.

Pour excuter un test pour un fichier spcifique, slectionnez le fichier dans l'diteur de Source ou la fentre Projects et pressez Ctrl-F6 ou choisissez Run | Run File | Test nomDuFichier.

Dboguer l'ApplicationLe dbogueur de l'EDI vous permet de suspendre l'excution de votre programme des points

stratgiques (points d'arrt) et de vrifiez les valeurs de variables, le status des threads, etc. Une fois que vous avez suspendu l'excution un point d'arrt, vous pouvez avancer pas pas dans le code.

Pour dmarrer le dbogage d'un programme:

[nl] Assurez-vous que le programme que vous dsirez dboguer est bien dfini comme projet principal de l'EDI.


Le nom du projet principal est indiqu en gras dans la fentre Projects. Vous pouvez indiquer qu'un projet normal devienne le projet principal en cliquant-droit sur son noeud et en choisissant Set Main Project.

[nl] Dtermine le point dans votre code o vous dsirez commencer dboguer et dfinissez un point d'arrt sur cette ligne en cliquant dans la marge de gauche de cette ligne.L'icne apparat dans la marge de gauche pour marquer le point d'arrt. De plus, toute la ligne apparatra en rose.

[nl] Lancer le dbogueur en choisissant Debug Main Project ou en pressant F5.L'EDI construit (ou reconstruit) l'application et ensuite ouvre la console de dbogage en bas de l'EDI et les fentres Watches, Call Stack, et Local Variables windows sa droite.

[nl] Cliquez sur la fentre Local Variables(illustre sur l'Illustration 2-10) pour voir la valeur de n'importe quelle variable actuellement dans le scope du programme.

Illustration 2-10

Fentres du Dbogueur, avec la fentre Local Variables ayant le focus.

Intgration Commandes Contrle de VersionSi vous avez dj utilis un systme de version de contrle pour vos sources, vous pouvez

facilement intgrer ces commandes du systmes dans le workflow de l'EDI. L'EDI fournit le support pour travailler avec de nombreux systmes de contrle de version.

L'EDI agit comme un interface graphique pour l'application cliente de contrle de version que vous utilisez dj. Lorsque vous appelez les commande de version de contrle depuis l'EDI, l'EDI passe ces commandes au client du contrle de version, qui s'occupe des commandes. L'EDI affiche galement tout rsultat gnr par le client de contrle de version.

Dans l'EDI NetBeans 4.1, la dfinition de l'EDI pour travailler avec les sources versionnes est spare de la dfinition du projet. Si vous avez dj des sources provenant d'un systme de contrle de version et que vous dsirez que les commandes de contrle de version soient disponibles dans l'EDI pour un projet, vous devez faire connaitre le rpertoire de travail versionne l'EDI.

Conseil EDI NetBeans


If you are using a post-4.1 version of the IDE, this process might be streamlined, so that the registration of the version control system in the IDE is coupled with the creation of the project.

Pour indiquer l'EDI de travailler avec votre systme de contrle de version:

[nl] Choisissez Versioning | Versioning Manager.[nl] Dans la bote de dialogue Versioning Manager, cliquez sur Add.[nl] Slectionnez le systme de contrle de version que vous utilisez depuis la liste

droulante Profile et indiquez l'emplacement du rpertoire de travail.Si vous avez plusieurs projets dans le mme rpertoire de travail, vous pouvez slectionner le rpertoire racine pour faire connatre le contrle de version pour tous les projets en une seule opration.

[nl] Vrifiez les paramtres du serveur remplis par l'EDI et ajouter les paramtres manquants.Si vous utilisez CVS comme systme de contrle de version, vous avez l'option d'utiliser un client intgr plutt qu'un excutable CVS spar.

[nl] Cliquez sur Finish pour quitter l'assistant et cliquez ensuite sur Close pour quitter le Gestionnaire de Version.

[nl] Si vous ne l'avez pas encore fait, crez un projet dans l'EDI pour vos sources via l'assistant New Project pour que vous puissez dveloppez ces sources dans l'EDI.Conseil EDI NetBeansSi aucun profile n'est disponible dans l'assistant pour le systme de contrle de version que vous utilisez, vous pourriez trouver un profile en-ligne l'adresse http://vcsgeneric.netbeans.org/profiles/index.html.Vous pouvez galement crer votre propre profile en choisissant le profile Empty dans le Gestionnaire de Version en ensuite le personnaliser pour qu'il fonctionne avec votre systme de contrle de version. Voyez la page http://vcsgeneric.netbeans.org/doc/profiles/index.html pour des informations sur la cration de profile pour votre systme de contrle de version.Voir Chapitre 3: Configurer un Projet pour Travailler avec Contrle de Version pour plus d'informations sur le contrle de version avec l'EDI, y compris les informations sur comment mettre vos mta-donnes de projet sous contrle de version.

Une fois que vous avez configurer un rpertoire de travail sous un contrle de version de cette manire, la fentre Versioning apparait l'endroit occup par la fentre Projects. Vous pouvez excuter des commandes de contrle de version depuis cette fentre. Cependant, vous ne pouvez pas excuter des commandes lies au projet ou faire des choses de type Explorer avec les fichiers comme Ouvrir, Copier, ou Coller.

Si vous avez dj dfini un projet EDI pour ces sources, un sous-menu avec les commandes de contrle de version apparatra dans le menu contextuel (disponible via un clic droit) de tous les noeuds du projet dans la fentre Projects.


http://vcsgeneric.netbeans.org/doc/profiles/index.html

Gestion des Fentres de l'EDILe systme de fentrage de l'EDI est conu pour fournir un layout cohrent et non intrusif des

nombreuses fentres dont vous avez besoin tout en vous permettant d'ajuster le layout sans trop d'effort selon vos besoins. Voici certaines choses que vous pouvez faire:

[lb] Redimensionner les fentres en cliquant sur un bord de la fentre et la tirer jusqu' ce qu'elle atteigne la taille que vous dsirez.

[lb] Agrandir une fentre dans l'EDI en double-cliquant sur son onglet (vous pouvez revenir son apparence prcdente en double-cliquant nouveau sur l'onglet). Vous trouverez cette fonctionnalit particulirement intressante dans l'diteur de Source.

[lb] Dplacer une fentre vers une autre partie de l'EDI en cliquant sur son onglet et en la lachant dans un autre coin de l'EDI.

[lb] Utiliser Tirer/Lcher pour dcouper une fentre en deux.[lb] Rendre une fentre coulissante en cliquant sur son bouton . Lorsque vous

cliquez sur son bouton, la fentre est minimise avec un bouton reprsentant cette fentre place sur l'un des bords de l'EDI. Vous pouvez mettre le curseur de la souris sur le bouton pour afficher temporairement la fentre, ou vous pouvez cliquer sur le bouton pour ouvrir la fentre.


guide pratique edi netbeans pratique edi... · voir les méta-données du projet et les résultats...

Documents