Table des Matires

Dveloppement Applications Web.................................................................................................. 2 Reprsentation d'Applications Web dans l'EDI.......................................................................... 3 Vue Project des Applications Web....................................................................................... 3 Vue des Fichiers d'Applications Web................................................................................... 3 Structure Application Web.................................................................................................... 4 Ajout de Fichiers et Bibliothques Votre Application Web...................................................... 5 Cration de Pages Web et Autres Fichiers Publics.............................................................. 7 Cration des Classes, Servlettes et Autres Fichiers Privs.................................................. 7 Ajout de Ressources Externes Votre Projet....................................................................... 8 Ajout de Tags et Bibliothques de Tag................................................................................. 9 Edition et Refactoring Fichiers Applications Web.................................................................... 10 Completion de Tags............................................................................................................ 10 Extension des Abbrviations pour les fichiers JSP............................................................. 12 Edition Manuelle du Descripteur de Dployement.............................................................. 13 Refactoring Composants Web............................................................................................ 14 Dploiement d'une Application Web........................................................................................ 15 Personnalisation Contenu d'un Fichier WAR...................................................................... 15 Non-Dployement d'une Application Web.......................................................................... 16 Redployer une Application Web....................................................................................... 16 Cration d'un Fichier WAR................................................................................................. 16 Dployement vers un Autre Serveur Tomcat..................................................................... 16 Test et Dbogage de Votre Application Web........................................................................... 17 Vrification des Erreurs JSP............................................................................................... 18 Visualiser la Servlette d'un Fichier JSP.............................................................................. 18 Visualiser un Fichier dans un Navigateur Web................................................................... 18 Passage de Paramtres de Requte une Application Web............................................. 19 Dbogage JSP et Fichiers Tag........................................................................................... 19 Cration et Dployement d'Applettes...................................................................................... 19 Cration d'une Applette...................................................................................................... 20 Excution et Dbogage d'une Applette dans l'Applet Viewer............................................. 20 Excution d'une Applette dans un Navigateur Web........................................................... 21 Mettre l'Applet dans un Fichier JAR................................................................................... 21 Mettre l'Applet dans un Fichier WAR.................................................................................. 21 Dfinition des Permissions de l'Applette............................................................................. 22 Modification du Navigateur Web par Dfaut de l'EDI.............................................................. 22 Monitoring Transactions HTTP................................................................................................ 23 Mise En Place du Moniteur HTTP...................................................................................... 23 Mise En Plce du Moniteur HTTP Pour les Serveurs Dmarrs En Dehors de l'EDI...........24 Analyse des Donnes Rcoltes........................................................................................ 26 Rejouter des Requtes HTTP............................................................................................. 29

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 1

Dveloppement Applications Web

L'EDI NetBeans est un environnement idal pour le dveloppement d'applications Web. L'EDI limine tout un tas de nuisances que vous auriez normallement rencontrs, particulirement dans la dfinition de l'application et dans les tapes entre le codage, dployement, dbogage et redployement de votre application. Et parce que Ant est la base de l'automatisation, il n'y a pas de mystres propritaires que vous devez refaire si vous dsirez faire que votre projet fonctionne sans l'EDI comme intermdiaire. Voici une liste de choses que l'EDI fait pour simplifier le dveloppement d'Applications Web: [nl] [nl] [nl] [nl] Fournit un serveur Web Tomcat pour dployer, tester et dboguer vos applications. Dfinit le fichier et la structure de dossier d'une application web pour vous. Gnre et maintient le contenu des descripteurs de dployement, y compris l'enregistrement de toutes servlettes que vous rajoutez votre projet. Gnre et maintient un script Ant avec les targets (commandes) pour la compilation, nettoyage, test, cration de fichier WAR et dployement sur un serveur. Ce script vous vite d'avoir copier manuellement les fichiers dans le serveur Web. S'assure que les fichiers de configuration qui apparaissent dans le dossier WEBINF de votre application ne sont pas effacs lorsque vous excutez la commande Clean pour enlever les rsultats des builds prcdents. Fournit une coloration syntaxique, completion de code, et d'autres aides pour l'dition de servlettes, JSP, HTML et fichiers de bibliothque de tag. Fournit la commande Compiler JSP, qui vous permet de dtecter les erreurs de syntaxe dans les fichiers JSP avant de dployer vers votre serveur, que l'erreur survienne la compilation ou durant la traduction du fichier JSP en une servlette. Fournit un support de dbogage comprhensif, incluant le mode pas pas dans les fichiers JSP et le traage des requtes HTTP.

[nl]

[nl] [nl]

[nl]

Most of the topics in this chapter assume that you are using the Tomcat Web server, but it is also possible to use the Sun Java System Application Server, which supports enterprise-tier applications and provides broader support for Web services. See Chapter XXX for more information on working with the Sun Java System Application Server and XXX for information on developing, exposing, and consuming Web services. Ce chapitre se focalise sur les problmes spcifiques aux applications Web, comme la cration et l'dition de composants Web, le dbogage des transactions HTTP, etc., mais ne fournit aucune information sur la cration de projet. Consultez le Chapitre 3 pour obtenir des informations quant la cration de projets.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 2

Reprsentation d'Applications Web dans l'EDI

Les applications Web sont base sur une architechture quelque peu complexe o le layout des fichiers au moment du dveloppement diffre de celui de l'application compile. L'EDI vous aide contrler ce processus en : [lb] Fournissant une vue oriente dveloppement de votre projet dans la fentre Projects. Cette vue vous donne un accs ais vos sources et informations concernant votre classpath, mais cache les rsultats du build et les mta-donnes du projet. Peut-tre le point le plus important, le fait de travailler dans la fentre Projects asure qu'aucun des fichiers que vous crez ne seront effacs par inadvertance lorsque vous excutez la commande Clean sur votre projet. Fournissant une vue oriente Fichier de votre projet dans la fentre Files. Cette fentre est particulirement utile pour accder et personaliser vos scripts de dployement et pour naviguer parmis ce qui rsulte de votre projet, comme le fichier WAR de votre projet et son contenu. Crant et maintenant un script Ant, qui est utilis lorsque vous excutez desz commandes typiques comme Build Project et Run Project. Entre autres choses, le script Ant automatise le placement de vos fichiers dans l'application built, la packaging de ces fichiers dans un fichier WAR, et le dployement vers le serveur spcifi.

[lb]

[lb]

Vue Project des Applications Web La fentre Projects fournit une reprsentation logique de la structure de source de l'application, avec des noeuds pour les objets suivants: [lb] [lb] [lb] [lb] [lb] [lb] [lb] Web Pages (pour les fichiers HTML, JSP, et images auxquels les utilisateurs de l'application pourront directement accder via leur navigateur Web) Source Packages (pour les paquetages des sources Java, qui contiendra les servlettes et d'autres classes Java). Test Packages (pour les test unitaires) Configuration Files (pour vos descripteurs de dployement et d'autres fichiers) Web Services (o vous pouvez crer et enregistrer des services Web voir le chapitre XXX pour plus de dtails sur le dveloppement de Web Services) Libraries (o vous pouvez ajouter des bibliothques ou inclure les rsultats d'autres projets de l'EDI) Test Libraries (o vous pouvez ajouter toutes bibliothques ncessaires l'excution des tests unitaires de votre application)

Vue des Fichiers d'Applications Web Si vous ouvrez la fentre Files, vous verrez l'organisation physique des fichiers sur le disque (comme montr sur l'illustration 6-1) et trouverez que cette organisation est aligne sur les recommendation d'Apache pour l'organisation des fichiers sources (voir Structure d'Application Web la page 4). L'EDI ajoute galement les dossiers nbproject (pour accueillir les mtadonnes du projet) et test (pour les tests unitaires), mais ils ne sont pas inclus dans le rsultat final de l'application.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 3

Illustration 6-1 Fentre Files avec une structure de dossiers d'une application Web Lorsque vous faites un build de l'application, que ce soit via l'EDI ou en excutant directement Ant, un dossier build est cr pour accueillir les classes compiles et le dossier dist est cr pour accueillir le fichier WAR gnr comme montr dans l'illustration 6-2. Illustration 6-2

Fentre Files montrant la structure du fichier WAR cr

Structure Application Web

Apache Jakarta fournit un guidelines de comment structurer vos applications Web pour s'assurer qu'elles fonctionnent proprement avec le serveur Tomcat. Lorsque vous crez un projet dans l'EDI, cette structure est respecte. Ce qui suit est un rapide survol des lments importants de la structure de l'application Web construite: [lb] Le dossier racine (connu comme document base), qui contient tous les
Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 4

autres fichiers et dossiers de l'application. [lb] Fichiers qui sont directement accessibles aux utilisateurs de l'application via leur navigateur web, comme les fichiers HTML, les images et les fichiers JSP. Le dossier WEB-INF, qui contient le fichier de descripteur de dployement (web.xml) et les dossiers classes, lib, tags, ainsi que d'autres dossiers et fichiers. Le contenu de WEB-INF comprend le bulk de l'application est n'est pas directement accessible aux utilisateurs. Le dossier classes contient les fichiers des classes et servlettes compiles avec leur hirarchie de paquetage se refletant par les sousdossiers.

[lb]

[lb]

Vous pouvez trouver plus de dtails sur la structure de source Tomcat la page http://jakarta.apache.org/tomcat/tomcat-5.0doc/appdev/source.html. Voyez le Tableau 6-1 pour savoir comment les nombreux lments de source d'une Application Web correspondent avec leur reprsentation dans l'EDI et o ils se situeront finalement dans l'application dploye. Tableau 6-1: Matrice des Elements d'Application Web et Leur Reprsentation dans l'EDI
Contenu Reprsentation dans la fentre Projects Noeud Web Pages Noeud Source Packages Noeud Test Packages Noeud Configuration Files Reprsentation dans la fentre Files Dossier web Dossier src Dossier test Dossier web/WEB-INF Emplacement dans le fichier WAR gnr (situ dans le dossier dist) Raine du fichier Dossier WEB-INF/classes N/A Dossier WEB-INF

Pages Web Fichiers Sources Java, Servlettes, ... Tests Unitaires Descripteurs de dployement (web.xml) Fichier de configuration de contexte Tomcat (context.xml) Bilbiothques Entres classpath de Test Mta-donnes du projet y compris le script Ant

Dossier web/META-INF Dossier META-INF

Noeud Libraries Noeud Test Libraries

Dossier web/WEB-

INF/lib

Dossier WEB-INF/lib N/A N/A

Dossier test

Bote de dialogue Project build.xml file, nbproject Properties, que vous folder pouvez ouvrir en cliquantdroit sur le noeud du projet et choisir Properties.

Ajout de Fichiers et Bibliothques Votre Application Web

Une fois que vous avez cr un projet Web via l'assistant New Project, vous pouvez commencer y mettre des pages Web et du code. Le moyen le plus direct de crer des fichiers est d'ouvrir la fentre Projects et de cliquer-droit sur le noeud du projet ou le dossier spcifique o vous dsirez placer le fichier et de choisir New et

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 5

ensuite un modle depuis le sous-menu. Voir Illustration 6-3. Un assistant apparait pour le modle vous permettant d'indiquer son nom et d'autres caractristiques du fichier. En gnral, l'assistant vous guide pour s'assurez que les fichiers soient placs dans un rpertoire appropri, pour suivre la structure d'une application Web bien conue.
Conseil EDI NetBeans Le sous-menu New du menu contextuel d'un noeud affiche directement une slection de modles couramment utiliss. Si vous dsirez voir tous les modles disponibles, choisissez New | File/Folder. Les modles sont groups sous diffrentes catgories, comme Java Classes, Web, Database. En plus des modles pour les servlettes et pages JSP, la catgorie Web contient des modles pour les filtres, Web application listeners, fichiers tag, et tag handlers, qui contient des exemples de code utiles pour ces types de fichier spcifiques.

Illustration 6-3 Cration d'une nouvelle servlette depuis le menu contextuel d'un paquetage Conceptuellement, les fichiers dans une application Web se groupent en diffrents types de fichiers, dont sa fonction dtermine l'endroit o vous allez placer le fichier dans l'application. Les types principaux de fichiers que vous avez besoin de rajouter au projet sont: [lb] Les pages Web et autres fichiers publics, c'est--dire les fichiers auxquels les utilisateurs de l'application peut directement accder via leurs navigateur Web. Typiquement, cela inclut les fichiers JSP, les fichiers HTML, et les fichiers images. Les fichiers privs, c'est--dire les fichiers qui ne sont pas directement visibles l'utilisateur final et qui fait le bulk du traitement dans l'application. Cela inclut

[lb]

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 6

[lb]

les classes Java, les fichiers JSP, les servlettes et les bibliothques de Tag et aboutissent dans le dossier web/WEB-INF/classes de l'application Web compile. Les ressources externes, les fichiers crs en dehors du projet dont dpendent les fichiers dans le projet. Cela inclut les bibliothques de tags, les fichiers JAR rsultant des autres projets de l'EDI, et d'autres fichiers JAR et sont gards dans le dossier WEB-INF/lib de l'application Web compile.

De plus, il y a des fichiers de configuration comme le descripteur de dployement (web.xml) et les fichiers spcifiques au serveur que vous dployez , mais l'EDI gnre et maintient ces fichiers pour vous. Par exemple, si vous crez une servlette dans l'EDI, la servlette est enregistre dans le fichier web.xml automatiquement.
Conseil EDI NetBeans Les bibliothques de Tag peuvent tre rajoute votre application Web comme bibliothque ou comme source. Voir Ajout Tags et Bibliothques de Tag la page XXX pour plus d'informations sur la faon de travailler avec les bibliothques de tags.

Cration de Pages Web et Autres Fichiers Publics Gnrallement, vous ajoutez des pages Web et d'autres fichiers publics directement dans le noeud Web Pages de la fentre Projects ou dans le dossier que vous avez cr sous ce noeud. Lorsque l'application est construite, ces fichiers sont placs par le script Ant du projet dans le dossier web de l'application. Pour ajouter un fichier HTML visible publiquement, cliquez-droit sur le noeud Web Pages et choisissez New | HTML. Pour ajouter une fichier JSP visible publiquement, cliquez-droit sur le noeud Web Pages et choisissez New | JSP. L'assistant vous permet de spcifier si le fichier JSP utilise la syntaxe standard (et a l'extension .jsp) ou utilise la syntaxe XML (a l'extension .jspx). Vous pouvez galement crer le fichier en tant que fragment (en utilisant l'extension .jspf), que vous rfrencerez depuis d'autres pages avec les instructions include. Cration des Classes, Servlettes et Autres Fichiers Privs Comme pour les projets Java gnraux, les classes sont organises dans les paquetages sous le noeud Source Packages. Pour la plupart des projets, ce noeud correspond avec un dossier sur votre disque nomm src. Lorsque l'application est gnre, ces fichiers sont placs par le script ant dans le rpertoire WEB-INF/classes de l'applicatio. Pour ajouter une classe votre projet, cliquez-droit sur le noeud Source Packages ou le noeud d'un paquetage spcifique et choisissez New | Java Class. Si vous n'avez pas cr de paquetage pour la classe que vous rajouter, vous pouvez encore le faire dans l'assistant au moment o vous crez la classe. Pour ajouter une servlette votre projet, cliquez-droit sur le noeud Source Packages ou le noeud du paquetage spcifique et choisissez New | Servlet. L'assistant pour la cration de la servlette vous guide galement dans l'enregistrement de la servlette dans le descripteur de dployement de l'application (fichier web.xml). Si vous dsirez rajouter un fichier bas sur un modle plus spcifique, cliquez-droit sur un noeud de paquetage et choisissez New | File/Folder pour obtenir une liste plus tendue de modles, y compris pour les composants JavaBeans, les fichiers .properties, les fichiers XML, et les

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 7

composants Web spcialiss. De plus, la plupart des modles Web ont un squelette trs utile et des suggestions dans les commentaires pour vous aider dveloppez ces types d'objets. Voyez le tableau 6-2 pour une liste de modles que vous pouvez retrouver dans la catgorie Web de l'assistant New File. Tableau 6-2: Modles Web
Modles JSP Description Vous permet de crer un fichier JSP (syntaxe standard), un document JSP (syntaxe XML), ou un fragment JSP (qui peut tre rfrenc statiquement depuis un autre fichier). Cre une classe Java qui tend la classe HttpServlet. Vous permet galement d'enregistrer la servlette dans le fichier de descripteur de dployement(web.xml) du projet. Cre une classe Java qui implmente l'interface javax.servlet.Filter. Les filtres vous permet de modifier les requtes HTTP pour une servlette et les rponses de la servlette. Dans l'assistant, vous pouvez crer soit un filtre lmentaire, ou un qui englobe les objets ServletRequest et ServletResponse. Dans l'assistant du modle, vous pouvez enregistrer le filtre dans le fichier descripteur de dployement (web.xml) du projet. Web Application Listener Cre une classe Java qui implmente un ou plusieurs des interfaces listeners disponibles pour les servlettes, comme ServletContextListener et HttpSessionListener. Selon les interfaces que vous slectionnez dans l'assistant, la classe cre sera l'coute des vnements, comme lorsque les contextes de servlettes est initialis ou dtruit, la session de servlette est cr ou dtruite, ou lorsque les attributs sont rajouts ou supprims du contexte ou de la session. Dans l'assistant du modle, vous pouvez enregistrer le listener dans le fichier descripteur de dployement (web.xml) du projet. Tag Library Descriptor Cre un descripteur pour une bibliothque de tag personnalise. Vous pouvez alors enregistrer les fichiers tag et les tag handlers dans ce fichier manuellement, ou lorsque vous utilisez l'assistant New File pour crer de nouveaux fichiers tag et des tag handlers. Cre un fichier .tag vide avec des commentaires suggrant les lments de syntaxe JSP que vous pouvez utiliser pour crer un tag personnalis. Cre une classe Java pour les tags JSP personnaliss. Le modle inclut des commentaires de code avec des exemples de code et des suggestions pour vous aider dans la cration de tags personnaliss. Cre un HTML avec les tags lmentaires dj introduits. Cre un simple service Web. Voyez XXX pour plus d'informations sur l'extension de Services Web avec des applications Web. Cre un gestionnaire de messages bas sur SOAP pour les services Web. Voyez XXX pour plus d'information sur la consommation de Services Web avec des applications Web. Cre un client de service Web bas sur la JSR 109. Voyez XXX pour plus d'informations sur la consommation de services Web avec des applications Web.

Servlet

Filter

Tag File Tag Handler

HTML Web Service Message Handler

Web Service Client

Ajout de Ressources Externes Votre Projet Si votre application Web a besoin d'tre livre avec d'autres bibliothques, vous pouvez les rajouter dans le noeud Libraries. Si votre projet a t configur pour fonctionner avec le serveur
Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 8

Tomcat, les bibliothques JSP et servlet sont incluses automatiquement et listes sous un sousnoeud pour le serveur Tomcat. Vous pouvez rajouter des ressources externes votre projet selon l'une des trois mthodes qui suivent: [lb] [lb] Un dossier ou fichier JAR individuel. Un ensemble de ressources (ou bibliothque). Ce ensemble peut inclure de multiples fichiers JAR, les sources pour les fichiers JAR (qui sont ncessaires pour la completion de code, ou si vous dsirez y passer avec le dbogueur), et la documentation Javadoc. Vous pouvez crer de tel ensemble dans le Gestionnaire de Bibliothques (menu Tools). Les archives d'un autre projet de l'EDI.

[lb]

Pour rajouter un dossier ou fichier JAR isol votre projet, cliquez-droit sur le noeud Libraries de votre projet, choisissez Add JAR/Folder, et rechercher le dossier ou fichier Jar sur votre disque et slectionnez le. Pour ajouter un ensemble de ressources votre projet, cliquez-droit sur le noeud Libraries, choisissez Add Library, et slectionez la bibliothque depuis la liste de la bote de dialogue Add Library. Si la bibliothque que vous recherchez n'est pas prsente, vous pouvez la rajouter la liste en choisissant Manage Libraries.
Conseil EDI NetBeans En plus de fournir un moyen de regrouper des ressources, les Gestionnaire de Bibliothques simplifie l'accs aux ressources rgulirement utilises. Mme si vous n'avez pas besoin de regrouper les ressources, vous pouvez toujours rajouter des ressources individuelles au Gestionnaire de Bibliothques pour vous viter d'avoir plonger dans les entrailles de vos rpertoires pour rajouter les ressources aux autres projets.

Pour ajouter les archives d'un autre projet, cliquez-droit sur le noeud Libraries du projet en cours, et naviguez jusqu'au dossier du projet sur votre disque. Les dossiers de projets NetBeans sont indiqus par l'icne .
Conseil EDI NetBeans Si vous dsirez ajouter un fichier JAR ou le rsultat du projet au fichier WAR sans qu'il ne fasse partie du classpath de la compilation, vous pouvez le faire via le noeud Packaging dans la bote de dialogue Project Properties. Voyez Personnalisation Contenu du Fichier WAR la page XXX.

Ajout de Tags et Bibliothques de Tag Des Tags et bibliothques de tag peuvent tre rajouts votre projet Web selon l'une de ces faons : [lb] Fournit dans un fichier JAR contenant un fichier de descripteur de bibliothque de tag (TLD) et les tags associs, sous la forme de fichier tag (en utilisant une syntaxe JSP) et/ou gestionnaire de tag (crit en Java). De telles bibliothques de tag apparaissent dans le rpertoire WEB-INF/lib de l'application Web ou dans le dossier des bibliothques partages du serveur. Vous pouvez ajouter une bibliothque de tag un projet Web via le noeud Libraries du projet Web (voir Ajout Ressources Externes Votre Projet la page XXX).

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 9

[lb]

[lb]

Si vous dveloppez une bibliothque de tag from scratch, vous pouvez crer un projet Java Library pour la bilbiothque et ensuite rajoutez cette bibliothque au projet Web en cliquant-droit sur le noeud Libraries du projet Web et en choisissant Add Project. Voyez le Chapter 3 pour plus d'information quant la cration de projets Java Library. En tant que fichier tag (en utilisant soit la syntaxe standard, soit la syntaxe document) inclut dans le dossier WEB-INF/tags de l'application Web. Vous pouvez ajouter de nouveaux fichiers tag votre projet en cliquant-droit sur le noeud du projet et en choisissant New | File/Folder en ensuite en slectionnant le modle Tag File dans la catgorie Web de l'assistant. En tant que fichier TLD situ dans le rpertoire WEB-INF/tlds et gestionnaires de tag (crits en fichiers Java) dans le noeud Source Packages. Vous pouvez ajouter de nouveaux fichiers TLD et tag handlers votre projet en cliquant-droit sur le noeud du projet et en choisissant New | File/Folder et ensuite slectionnait les modles dans la catgorie Web de l'assistant.

Edition et Refactoring Fichiers Applications Web

L'diteur de Source de l'EDI fournit tout un tas de fonctionnalits qui vous simplifie l'encodage et les changements de code faire dans vos nombreux composants d'application Web. Cette section va survoler quelques unes de ces fonctionnalits qui sont particulirement utiles pour les applications Web. Voyez le Chapitre 4 pour plus d'information sur les fonctionnalits d'dition de l'EDI et les fonctionnalits de Refactoring. Completion de Tags L'EDI vous permet d'avoir les tags et leurs attributs complets automatiquement dans les fichiers JSP, HTML, et XML. La fonctionnalit de completion de tag, non seulement rduit le nombre de frappe clavier, mais vous fournit galement une documentation contextuelle sur les diffrentes faons possibles de completer le tag ou l'attribut que vous tes en train d'encoder, comme le montre l'Illustration 6-4.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 10

Illustration 6-4 La fonctionnalit de completion de code dans un fichier JSP Pour activer la fentre de completionde tag, il vous suffit de tapez quelques lettres commenant le tag et de pressez Ctrl-Espace, ou d'attendre une seconde pour que la completion de code s'active automatiquement. S'il n'existe qu'une seule faon de completer le mot que vous avez pat, la fin du mot sera complet automatiquement. S'il existe plusieurs faons de completer le tag, une liste des possibilits vous est alors proposes. Vous pouvez continuer coder pour rduire la liste ou alors slectionnez le texte que vous dsirez en utilisant la souris ou les touches flche pour slectionner le mot dsir. Par exemple, si vous dsirez ajouter les instructions suivantes dans un fichier JSP:
<jsp:useBean id="hello" scope="page" class="org.mondomaine.monpaquetage.MaClasse" />

vous pouvez le faire par les tapes suivantes: [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] [nl] Tapez <jsp:u Pressez Ctrl-Espace (seBean est rajout). Tapez i Pressez Ctrl-Espace (d= est rajout avec le point d'insertion mis entre les guillemets). Tapez hello Pressez la touche flche droite deux fois. Tapez s Pressez Entre (cope= est rajout, avec le point d'insertion mis entre les guillemets). Tapez p Pressez Ctrl-Espace (age est rajout). Pressez la touche flche droite deux fois. Tapez c Pressez Entre (lass= est rajout avec le point d'insertion mis entre les guillemets). Tapez o Pressez Ctrl-Espace (rg est rajout, en supposant que la classe fasse partie de votre projet). Tapez un point (.) et pressez Ctrl-Espace (mondomaine est rajout). Tapez un point (.) et pressez Ctrl-Espace (monpaquetage est rajout). Tapez un point (.) et pressez Ctrl-Espace (MaClasse est rajout). Pressez la touche flche droite deux fois et tapez />

Voyez le Chapitre 4: Gnration Bout de Code pour avoir des informations sur la completion d'expressions Java et la configuration de completion de code.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 11

Extension des Abbrviations pour les fichiers JSP Pour les bouts de code JSP couramment utiliss, vous pouvez tirer profit des abbrviations dans l'Editeur de Source pour rduire le nombre de frappes au clavier. Les abbrviations sont alors tendues lorsque vous tapez l'abbrviation et que vous pressez la barre d'espacement. Voyez le Tableau 6-3 pour une liste d'abbrviations pour les fichiers JSP. Vous pouvez galement tendre les abrrviations pour les autres types de fichiers. Voyez le Chapitre 4, Tableau 4-1 pour une liste d'abbrviations pour les classes Java. Si une abbrviation correspond au texte que vous dsirez tapez ('est--dire que vous ne dsirez pas l'tendre en autre chose), pressez Maj-Espace pour empcher sa transformation. Vous pouvez modifier la liste des abbrviations dans la boite de dialogue Abbreviations pour un type de fichier. Voyez le Chapter 4, Ajout, Modification, et Suppression des Abbrviations.

Tableau 6-3: Abbrviations JSP dans l'diteur de Source

Abbrviation ag ap ar cfgi oup oupl pcg pcgn pcgs pcr pcs rg sg sp sr jspf jg jspg jspi jspp jsps jspu pg pga pgb pgc pgerr pgex Devient application.getValue(" application.putValue(" application.removeValue(" config.getInitParameter(" out.print(" out.println(" pageContext.getAttribute(" pageContext.getAttributeNamesInScope( pageContext.getAttributesScope(" pageContext.removeAttribute(" pageContext.setAttribute(" request.getParameter(" session.getValue(" session.putValue(" session.removeValue(" <jsp:forward page=" <jsp:getProperty name=" <jsp:getProperty name=" <jsp:include page=" <jsp:plugin type=" <jsp:setProperty name=" <jsp:useBean id=" <%@ page <%@ page autoFlush=" <%@ page buffer=" <%@ page contentType=" <%@ page errorPage=" <%@ page extends="

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 12

Abbrviation pgie pgim pgin pgit pgl pgs tglb

Devient <%@ page isErrorPage=" <%@ page import=" <%@ page info=" <%@ page isThreadSafe=" <%@ page language=" <%@ page session=" <%@ taglib uri="

Edition Manuelle du Descripteur de Dployement Bien que l'EDI vous guide pour l'ajout d'entres dans le descripteur de dployement (fichier
web.xml) lorsque vous rajouter des servlettes, filtres, et listeners votre projet, vous pouviez

avoir l'occasion d'diter le fichier la main. Pour ouvrir le descripteur de dployement dans l'diteur de Source, ouvrez la fentre Projects, tendez le noeud Configuration Files (ou le noeud Web Pages | Web-INF) et double-cliquez sur le fichier web.xml. Le fichier s'ouvre en tant que document multi-onglets dans l'diteur de source avec l'onglet Overview ouvert (comme montr sur l'Illustration 6-5). Vous pouvez diter diffrentes parties du fichier web.xml avec les diteurs visuels pour les lments diffrents du fichier (Overview, Servlets, Filters, et Pages) ou vous pouvez cliquez sur l'onglet XML pour diter directement la source XML du fichier (voir Illustration 6-6). Illustration 6-5 Editeur visuel du descripteur de dployement

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 13

Illustration 6-6 Editeur XML du descripteur de dployement

Refactoring Composants Web Le support de refactoring dans l'EDI NetBeans s'tend aux applications Web et aux applications entreprises. Par exemple, vous pouvez faire ce qui suit: [lb] Renomme les classes, mthodes, et champs des servlettes, gestionnaires de tag, et autres composants Web. Voir le Chapitre 4, Renommer Toutes Les Occurences de

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 14

Classe, Mthode ou Champ Actuellement Slectionn [lb] Dplacer des classes dans d'autres paquetages ou projets (ce qui a pour rsultat que la classe sera livre dans un diffrent fichier WAR). Voir le Chapitre 4, Dplacement d'une Classe dans un Paquetage Diffrent. Modification des paramtres de mthodes y compris les noms des paramtres, les types de paramtres, et les visibilits de mthodes, l'ajout de paramtres une mthode ou la suppression de paramtres une mthode. Voir le Chapitre 4, Modification de la Signature d'une Mthode. Modification de la visibilit des champs et rajout des mthodes setter et getter. Voir le Chapitre 4, Gnration des Proprits Read/Write.

[lb]

[lb]

Lorsque vous renommez une classe de composant Web (comme une servlette ou un gestionnaire de tag), toutes les entres correspondantes dans le descripteur de dployement (fichier web.xml) et/ou le descripteur de bibliothque de tag (TLD) sont galement mises jour. Lorsque vous dplacez une classe et que le descripteur de dployement est affect, vous tes invit, avec la boite de dialogue Confirm Changes confirmer les modifications au descripteur de dployement.
Important Attention de ne pas renommer ou modifier les paramtres d'une mthode de servlette qui doit tre implmente avec un nom donn selon les spcifications des Servlettes ou des EJB.

Dploiement d'une Application Web

Par dfaut, une application Web est dploye sur le serveur que vous avez spcifi lorsque vous excutez ce projet. Pour les applications que vous dployez dans le serveur Tomcat, l'application est dploye sur place, signifiant que l'EDI cre un fichier XML qui est plac dans le rpertoire conf/Catalina/localhost/ du serveur et fait pointer Tomcat vers le rpertoire build du projet o se trouvent les fichiers de l'application. Lorsque vous gnrez un projet Web dans l'EDI, un fichier WAR est galement cr, que vous pouvez dployer manuellement vers un serveur. Personnalisation Contenu d'un Fichier WAR Par dfaut, un fichier WAR gnr par un projet Web inclut: lb] [lb] Tous les fichiers affichs dans le noeud Web Pages du projet, y compris les fichiers web.xml et context.xml. Les fichiers de classes compiles depuis les sources situes dans le noeud Java Sources plus les autres fichiers qui y sont placs, l'exception de ceux qui ont l'extension .java et .form. Toutes bibliothques que vous avez rajoutes dans le noeud Libraries du projet.

[lb]

Vous pouvez galement rajouter des fichiers JAR au fichier WAR et carter du contenu qui apparaitrait normallement. Pour personnaliser le contenu d'un fichier WAR: [nl] Cliquez-droit sur le noeud du projet dans la fentre Projects et choisissez Properties.
Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 15

[nl] [nl] [nl]

Slectionnez le noeud Build | Packaging. Si vous dsirez carter des fichiers du fichier WAR gnr, modifier l'expression rgulire dans le champ Exclude From WAR File. Si vous dsirez ajouter des dossiers ou fichiers supplmentaires, faites le via les boutons Add JAR/Folder, Add Library, ou Add Project. Les boutons Add JAR/Folder vous permettent de rajouter des fichier JAR ou dossiers, qu'ils proviennent ou non de projets de l'EDI. Le bouton Add Library vous perment de rajouter tout fichier JAR ou groupe de fichiers JAR que vous avez dsign dans le Gestionnaire de Bibliothque de l'EDI. Le bouton Add Project vous permet de rajouter le fichier JAR qui est gnr par un autre projet de l'EDI. Lorsque vous ajoutez un projet de l'EDI un fichier WAR, le fichier JAR de ce projet est regnr chaque fois que vous gnrez l'application Web.

Non-Dployement d'une Application Web Lorsque vous stoppez une application Web que vous avez excute via l'EDI, l'application reste dploye via la rfrence l'application sous la forme d'un fichier XML dans le rpertoire conf/Catalina/localhost de Tomcat. Pour ne plus dployer de telle applicaton depuis Tomcat: [nl] [nl] [nl] Ouvrez la fentre Runtime. tendez le noeud Servers, et tendez le noeud pour le serveur Tomcat et le noeud Web Applications pour le serveur. Cliquez-droit sur le noeud de l'application Web et choisissez Undeploy.

Redployer une Application Web Pour enlevez votre application du serveur et la redployer, cliquez-droit sur le noeud du projet et choisissez Redeploy Project. Cration d'un Fichier WAR Lorsque vous excutre la commande Build Project sur un projet Web dans l'EDI, un fichier WAR est automatiquemen cr et plac dans le dossier dist du projet. Vous pouvez accder ce fichier et visualiser son contenu dans la fentre Files. Dployement vers un Autre Serveur Tomcat L'EDI comprend un serveur Tomcat, ce qui facilite le dveloppement et test d'application Web. Si vous avez une installation diffrente de Tomcat que vous dsirez tester et/ou dployer vers, vous pouvez enregistrer cette installation dans l'EDI. Vous pouvez facilement basculer votre application pour travaille avec diffrentes installations de serveur. Cela est particulirement utile si vous dsirez dvelopper et tester sur une installation et ensuite dployer vers un environnement de production. Pour que l'EDI puisse reconnaitre une autre installation de Tomcat: [nl] [nl] Choisissez Tools | Server Manager . Cliquez sur le bouton Add Server.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 16

[nl]

[nl]

[nl]

[nl]

Dans la page Choose Server de l'assistant qui s'ouvre, slectionnez un serveur depuis la liste droulante Server, introduisez un nom d'affichage identifiant ce serveur dans l'EDI dans le champ Name, et cliquez sur Next. Sur la page Tomcat Server Instance Properties, spcifiez le rpertoire d'installation de Tomcat (et le rpertoire de base si c'est une installation partage) et remplissez un identifiant et un mot de passe. Vous pouvez galement dterminer d'activer le Moniteur HTTP de l'EDI. Si le Moniteur HTTP est activ, vous pouvez monitorer les requtes serveur de votre application, les cookies etc, ce qui simplifie le dbogage de votre application. Cependant, cette option ralentit le serveur. Vous dsirerez certainement que cette option soit dsactive si vous l'utilisez pour votre serveur de production. Voyez Monitoring Des Transactions HTTP la page XXX pour plus d'informations sur l'utilisation du Moniteur HTTP. Vrifiez que le serveur n'utilise pas un numro de port dj utilis. Dans l'EDI, vous pouvez voir le numro de port du serveur en plaant le curseur de la souris sur le noeud du serveur pour voir l'aide contextuelle du noeud. Si une autre instance de serveur utilise le mme port, vous devez arrter un des serveurs, et changer le port qu'il utilise. Arrter le serveur en cliquant-droit sur le noeud du serveur, en choisissant Start/Stop Server et en cliquant sur Stop Server. Ensuite, cliquez-droit sur le noeud du serveur, choisissez Properties, et modifiez la proprit Server Port. Redmarrez le serveur en cliquant-droit sur le noeud, choisissant Start/Stop Server et en cliquant sur Start Server. Si vous avez d'autres applications Web existantes dans l'EDI que vous dsirez excuter sur le serveur nouvellement rajout, modifiez les proprits de chaque projet pour utiliser ce serveur. Vous pouvez le faire en cliquant-droit sur le noeud du projet dans la fentre Projects, choisissant Properties, slectionnant le noeud Run, et finallement slectionnant le serveur dans la liste droulante.
Conseil EDI Netbeans Si vous dsirez modificer plus tard la configuration du serveur, vous pouvez accder aux proprits du serveur en ouvrant la fentre Runtime, en tendant le noeud Servers node, cliquant-droit sur le noeud du serveur spcifique pour y choisir Properties.

Test et Dbogage de Votre Application Web

L'EDI NetBeans fournit un environnement riche pour le troubleshooting et l'optimisation de vos applications Web. Quelques unes des fonctionnalits pour faciliter le test de vos applications Web incluent : [lb] [lb] La commande Compile JSP, qui vous permet de vrifiez les fichier JSP individuellement pour les erreurs avant de les dployer vers le serveur. Intgration du Dbogueur avec les fichiers JSP, ce qui signifie que vous pouvez rajouter des points d'arrt dans les fichiers JSP et avancez pas pas dans le JSP lors du dbogage (plutt que d'avoir vous promenez dans le code de la servlette gnre). Capacit d'avancer pas pas dans les fichiers tag. Capacit d'valuer les expressions de Expression Language (EL) dans les fichiers

[lb] [lb]

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 17

[lb]

JSP durant une session de dbogage (en plaant le curseur de la souris sur l'expression ou en rajoutant un watch, technique consistant rajouter une surveillance sur cette expression). Le Moniteur HTTP, qui trace la communication HTTP entre les servlettes et le serveur. Cette fonctionnalit est couverte en dtail dans Monitoring Transactions HTTP la page .

Voir le Chapitre 5 pour plus d'informations sur les fonctionnalits de dbogage gnrale de l'EDI que ces fonctionnalits tendent. Vrification des Erreurs JSP Les fichiers JSP ne sont pas compils commes des fichiers Java avant d'tre dploys. Au lieu de cela, ils sont compils par le serveur aprs qu'ils aient t dploys (o ils sont en fait tout d'abord transforms en servlettes, qui sont alors compiles. Cela complique la tche pour corriger les erreurs puisque vous devez dployer l'application dcouvrir l'erreur, arrter l'application, corriger l'erreur, et redployer. Cependant, l'EDI NetBeans vous permet de compiler les fichiers JSP pour vrifiez les erreurs avant que vous n'emballiez et dployez l'application. Vous pouvez soit compiler les fichiers JSP manuellement, soit spcifier qu'ils soient compils lorsque vous gnrez le projet. Pour compiler un fichier JSP manuellement, slectionnez le fichier dans la fentre Projects ou dans l'diteur de Source et slectionnez Build | Compile File ou pressez F9. Pour avoir tous les fichiers JSP compils lorsque vous excutez la commande Build Project, cliquez-droit sur le noeud du projet, choisissez Properties, slectionnez le noeud Compiling, et cochez la case Test Compile All JSP Files During Builds. Le rsultat de la compilation est report dans la fentre Output, o vous pouvez dcouvrir toutes les erreurs, qu'elles se soient produitent durant la traduction en servlette ou durant la compilation de la servlette. Les fichiers compils eux-mmes sont placs dans le dossier build/generated du projet, que vous pouvez visualiser depuis la fentre Files. Ces fichiers ne sont pas utiliss lorsque vous gnrez et prparer l'application pour le dployement. Visualiser la Servlette d'un Fichier JSP La gnration d'une servlette depuis un fichier JSP se produit dynamiquement sur le serveur o l'application Web est dploye. Vous pouvez visualiser cette servlette gnre une fois que vous avez excuter le projet ou la JSP spcifique qui lui est associe en cliquant-droit sur le fichier et en choisissant View Servlet.
Conseil EDI NetBeans Si vous dsirez voir le code de la servlette qui est gnr lorsque vous excutez la commande Compile JSP, ouvrez la fentre Files, ouvrez le dossier build/generated/src, et recherchez le fichier ayant le mme nom que celui de la page JSP avec avec un suffixe _jsp et une extension .java.

Visualiser un Fichier dans un Navigateur Web Vous pouvez ouvrir les composants d'une Application Web dans un navigateur Web depuis l'EDI.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 18

Pour voir une page JSP spcifique dans un navigateur Web, vous devez excuter ce fichier individuellement (en cliquant-droit sur le fichier dans l'diteur de Source ou en pressant Maj-F6). Pour ouvrir un fichier HTML dans le navigateur Web, cliquez-droit sur le noeud de la page HTML dans la fentre Projects et choisissez View.
Conseil EDI NetBeans La commande View pour les fichiers HTML n'est pas disponible depuis l'diteutr de Source. Si vous dsirez voir le fichier HTML que vous ditez actuellement dans l'diteur de Source sans que vos doigts ne quittent le clavier, pressez Maj-Ctrl-1 pour vous positionnez sur le noeud du fichier dans la fentre Projects, pressez Maj-F10 pour ouvrir le menu contextuel du noeud, et pressez la touche flche bas pour slectioner View, et pressez Entre.

Passage de Paramtres de Requte une Application Web Vous pouvez tester manuellement la faon dont l'application Web rpondra un certain input en excutant l'application avec certains paramtres dfinis l'avance. Pour passer les paramtres de requte la page JSP: [nl] [nl] Cliquez-droit sur le noeud du fichier JSP et choisissez Properties. Dans la proprit Request Parameters, introduisez les paramtres sous le format de URL query string (o l'expression commence avec une URL, continue avec un point d'interrogation (?) pour indiquer le dbut de la requte, et complete avec les paramtres sous paires nom=valeur, ou les paires sont spares par le et commercial (&)).

Pour passez les paramtres de requte une servlette, cliquez-droit sur le noeud de la servlette dans la fentre Projects et choisissez Tools | Set Servlet Execution URI. [nl] Dans la bote de dialogue, ajoutez un point d'interrogation plus les paires nom=valeur, avec chaque paires spares par un et commercial. Dbogage JSP et Fichiers Tag L'une des fonctionnalits de l'EDI qui a longtemps rendu l'EDI NetBeans favoris auprs des dveloppeurs Web est la capacit du dbogueur d'avancer pas pas dans les fichiers JSP. Vous pouvez dfinir des points d'arrt dans les fichiers JSP et avancer pas pas dans le JSP tout en monitorant les valeurs des variables et autres aspects du programme qui s'excute. L'EDI NetBeans 4.1 rajouter la capacit d'avancer pas pas dans les fichiers tag. Pour dfinir un point d'arrt dans un fichier JSP ou tag, slectionnez la ligne o vous aimeriez suspendre l'excution et pressez Ctrl-F8. Voir le Chapitre 5 pour plus d'information concernant le dbogage.

Cration et Dployement d'Applettes

L'EDI NetBeans ne possede pas de projet spcifique pour les applettes, ce qui fait que le cycle de dveloppement des applettes est quelque peu diffrent que pour les autres types de projets. Vous ne pouvez dsigner une applette comme tant une classe principale pour le projet, ce qui signifie que des commandes relatives au projet (comme Run Project) ne s'appliquent pas aux applettes.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 19

Cependant, vous pouvez toujours crer, tester et dployer des applets assez facilement. Les grandes lignes pour le dveloppement d'une applette sont les suivantes: [nl] [nl] [nl] [nl] [nl] Crez un projet Java Library qui contiendra l'applette. Crez une applette depuis l'un des modles dans l'assistant New File et codez l'applette. Testez l'applette dans l'applet viewer du JDK en cliquant droit sur le noeud de l'applette dans la fentre Projects et en choisissant Run File. Crez un fichier JAR pour l'applette en cliquant-droit sur le noeud du projet de l'applette et en choisissant Build Project. Si vous dsirez rajouter l'applette une application Web, ajoutez le projet de l'applette (ou juste le fichier JAR de l'applette) via le noeud Libraries de l'application Web.

Cration d'une Applette Pour crer une applette: [nl] Choisissez New Project, slectionnez la catgorie General, slectionnez le modle Java Library, et cliquez sur Next. [nl] Introduisez le nom et l'emplacement du projet et cliquez sur Finish pour quitter l'assistant. [nl] Dans la fentre Projects, tendez le noeud du projet que vous venez de crer. Ensuite, cliquez-droit sur le noeud Source Packages et choisissez New | File/Folder. [nl] Dans l'assistant New File, slectionnez un des modles d'applette disponibles. Il y en a 4 disponibles: [lb] Catgorie Java Classes, modle JApplet. Ce modle tend javax.swing.JApplet et est recommand par rapport au modle Applet template, qui est bas sur une classe moins flexible java.applet.Applet. [lb] Catgorie Java GUI Forms, modle JApplet. Ce modle tend javax.swing.JApplet et vous permet d'utiliser l'diteur Visuel pour concevoir graphiquement votre applette. Ce modle est recommand par rapport au modle Applet de la sous-gcatorie AWT Forms. [lb] catgorie Java Classes, modle Applet. Ce modle tend java.applet.Applet. [lb] Catgorie Java GUI Forms | AWT Forms, modle Applet. Ce modle tend java.applet.Applet et vous permet d'utiliser l'Editeur Visuel de l'EDI pour concevoir graphiquement votre applette. Cliquez sur Next, spcifiez un nom et un paquetage pour l'applette et ensuite cliquez sur Finish. Vous pouvez alors coder l'applette, soit la main ou avec l'assistantce de l'diteur Visuel. Excution et Dbogage d'une Applette dans l'Applet Viewer Lorsque vous dveloppez l'applette, vous pouvez utiliser l'applet viewer du JDK pour tester les fonctionnalits de l'applette. Lorsque vous excutez les commandes Run File et Debug File, l'applette est automatiquement affiche dans l'applet viewer.
Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 20

Pour excuter une applette, cliquez-droit sur le noeud d'une applette dans la fentre Projects et choisissez Run File. Pour dboguer une applette: [nl] [nl] Dfinissez un point d'arrt dans le code en slectionnant la ligne o vous dsirez suspendre l'excution et pressez Ctrl-F8. Cliquez-droit sur le noeud de l'applette dans la fentre Projects et choisissez Debug File.

Excution d'une Applette dans un Navigateur Web Si vous dsirez voir comment votre applette se comporte dans un navigateur Web, vous pouvez ouvrir un lanceur HTML pour l'applette. Pour excuter une applette dans un navigateur Web: [nl] [nl] Ouvrez la fentre Files et tendez le rpertoire build du projet. Cliquez-droit sur le fichier de lanceur HTML (il devrait avoir le mme nom que la classe de l'applette, mais avec une extension HTML) et choisissez View.

L'applette s'ouvre dans le navigateur Web par dfaut spcifi dans l'EDI. Voir Modification du Navigateur Web par Dfaut de l'EDI la page XXX si vous dsirez modifier le navigateur web par dfaut de l'EDI.
Conseil EDI NetBeans Si vous dsirez personnaliser le fichier lanceur HTML, vous pouvez copier le fichier de lanceur gnr dans le dossier qui contient le code source de l'applette. Cela empchera au lanceurr d'tre cras chaque fous que vous excutez l'applette. Lorsque vous excutez l'applette ou que vous gnrez le projet de l'applette, le fichier HTML est copi depuis dans le dossier avec la classe compile de l'applette. Si vous ne dsirez pas que ce fichier soit inclut dans le JAR qui est cr lorsque vous gnrez le projet, vous pouvez modifier le filtre pour le contenu du fichier JAR. Dans la fentre Projects, cliquez-droit sur le noeud du projet et choisissez Properties. Dans la bote de dialogue, slectionnez le noeud Packaging et modifier l'expression rgulire dans le champ Exclude From JAR File. Par exemple, vous pouvez ajouter une virgule plus une expression comme **/Myapplet.html pour vous assurez que votre fichier de lanceur (quelque soit le rpertoire o il se trouve) est exclut du fichier JAR gnr.

Mettre l'Applet dans un Fichier JAR Si vous dsirez mettre une applette dans un fichier JAR, vous pouvez le faire en cliquant-droit sur le noeud du projet de l'applette dans la fentre Projects et en choisissantBuild Project. L'applette est alors compile et les fichiers .class compiles sont places dans un fichier JAR dans le rpertoire dist, que vous pouvez voir dans la fentre Files. Mettre l'Applet dans un Fichier WAR Pour rajouter une applette une application Web: [nl] Mettre l'applette dans un fichier JAR. Voir Mettre une Applette dans un Fichier JAR ci-dessous pour savoir comment le faire dans l'EDI.
Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 21

[nl] [nl] [nl]

Cliquez-droit sur le noeud du projet de l'application Web dans la fentre Projects et choisissez Properties. Dans la bote de dialogue Project Properties, slectionnez le noeud Build | Packaging. Cliquez sur le bouton Add Project, naviguez jusqu'au dossier du projet de l'applette, et cliquez sur Add Project JAR Files.

Dfinition des Permissions de l'Applette Lorsque vous crez et excutez une applette via l'EDI, une applet.policy est cre avec toutes les permissions accordes et est place dans le rpertoire racine du projet (qui peut tre vu dans la fentre Files). Vous pouvez modifier ce fichier en double-cliquant sur sont noeud pour l'ouvrir dans l'diteur de Source. Vous pouvez galement spcifiez une police diffrente pour l'applette. Pour spcifier un fichier policy diffrent: [nl] [nl] [nl] Cliquez-droir sur le noeud du projet de l'application Web dans la fentre Projects et choisissez Properties. Dans la bote de dialogue Project Properties, slectionne le noeud Run. Dans le champ VM Options, modifiez la valeur de l'option -Djava .security.policy pour pointer vers le fichier policy.

Modification du Navigateur Web par Dfaut de l'EDI

Pour modifiez le navigateur Web par dfaut de l'EDI, choisissez Tools | Setup Wizard et slectionnez un navigateur depuis la liste droulante Web Browser. Si l'EDI ne peut trouvez un navigateur Web sur votre systme, vous devez spcifier l'excutable pour ce navigateur Web. Pour faire pointer l'EDI vers un navigateur Web qui est repris dans la liste de l'assistant Setup: [nl] [nl] Choisissez Tools | Options et tendez le noeud IDE Configuration | Server and External Tools Settings | Web Browsers. Slectionnez le sous-noeud pour le navigateur dont vous dsirez modifier la proprit Browser Executable. Pour rajouter un navigateur la liste de l'EDI: [nl] [nl] [nl] Choisissez Tools | Options et tendezz le noeud IDE Configuration | Server and External Tools Settings | Web Browsers. Cliquez-droit sur le noeud Web Browsers, choisissez New | External Browser, introduisez le nom du navigateur Web et cliquez sur Finish. Slectionnez le sous-noeud du navigateur rajout et modifiez la proprit Browser Executable pour pointer vers l'excutable du navigateur Web.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 22

Monitoring Transactions HTTP

L'EDI NetBeans fournit un Moniteur HTTP intgr, pour aider isoler les problmes de flots de donnes lors d'excution de servlettes et JSP sur un serveur Web. Il n'estpas ncessaire de rajouter de logique votre application Web pour tracer les requtes HTTP et les informations d'tat associes. Le Moniteur HTTP intgr l'EDI NetBeans peut faire cela pour vous. Lorsque l'EDI est configur avec un containeur Web o une application Web est dploye avec une servlette filtre Moniteur HTTP NetBeans et un filter mapping, le moniteur HTTP va automatiquement enregistrer toutes les requtes HTTP faites au containeur Web. Pour chaque requte HTTP qui est traite par le containeur web, le Moniteur HTTP non seulement enregistre la requte, mais il enregistre galement les informations d'tat maintenue dans le conteneur web. En utilisant le Moniteur HTTP, vous pouvez analyser les requtes HTTP et stoquez les requtes HTTP GET et HTTP POST pour de futures sessions d'analyse. Vous pouvez galement diter ces requtes stoques et les rejouer. C'est une fonctionnalit puissante pour aider isoler le flot des donnes et les informations d'tat passe dans une requte HTTP vers un conteneur web. Les requtes HTTP sont stoques jusqu' ce que vous quittiez l'EDI, moins que vous ne les sauvegardez explicitement. Voici une liste des possibilits que vous pouvez faire grce au Moniteur HTTP de l'EDI: [lb] [lb] [lb] [lb] [lb] [lb] [lb] Analyser les enregsitrement des requtes HTTP. Enregistrer les enregistrement des requtes HTTP. diter les enregistrements des requtes HTTP. Raffraichir les enregistrements des requtes. Trier les enregistrements des requtes HTTP. Supprimer les enregistrements des requtes HTTP. Rejouer les enregistrements de requtes HTTP.

Dans les sections qui suivent, vous allez apprendre comment configurer le moniteur HTTP, analyser les donnes que le Moniteur HTTP collecte, et rejouer les requtes HTTP enregistres. Mise En Place du Moniteur HTTP Lorsque vous excutez une application Web, le Moniteur HTTP s'affiche automatiquement. Si le Moniteur HTTP n'aparait pas en bas de l'EDI, vrifiez alors que le Moniteur HTTP est bein activ, en effectuant les tches suivantes: [nl] [nl] [nl] Etendez le noeud Servers de la fentre Runtime pour montrer les serveurs web enregsitrs. Ensuite, cliquez-droit sur le noeud du serveur et choisissez Properties. Cochez la case Enable HTTP Monitor. Si le serveur web enregsitr est actuellement dmarr, arrtez-le et redmarrez-le en cliquant droit sur le noeud du serveur et en slectionnait Start / Stop Server.

L'Illustration 6-montre la proprit 6 HTTP Monitor dans la bote de dialogue Sun Java System Application Server 8 Properties.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 23

Illustration 6-6: Boite de dialogue de proprits pour le Sun Java System Application Server

Mise En Plce du Moniteur HTTP Pour les Serveurs Dmarrs En Dehors de l'EDI Vous pouvez galement utiliser le Moniteur HTTP sur des serveurs Web dmarrs en dehors de l'EDI NetBeans. Pour faire cela, excutez les tches suivantes: [nl] Allez dans le rpertoire o l'EDI NetBeans est install et copier les fichiers modules/org-netbeans-modules-schema2beans.jar et modules/orgnetbeans-modules-web-httpmonitor.jar dans le rpertoire de votre module web WEB-INF/lib. [nl] Ajoutez une dclaration de filtre approprie votre version de servlette en haut du fichier WEB-INF/web.xml de votre module Web. Les entres Filters et filter mapping doivent tre spcifies au dbut du descripteur de dployement. Voyez les exemples ci-dessous pour les filtres selon les versions 2.3 et 2.4 des spcifications de Servlet. Une dclaration de filtre selon les spcifications 2.4 ressemble ceci:
<filter> <filter-name>HTTPMonitorFilter</filter-name> <filter-class> org.netbeans.modules.web.monitor.server.MonitorFilter </filter-class> <init-param> <param-name> netbeans.monitor.ide </param-name> <param-value> name-of-host-running NetBeans IDE:http-server-port Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 24

</param-value> </init-param> </filter> <filter-mapping> <filter-name> HTTPMonitorFilter </filter-name> <url-pattern> /* </url-pattern> <dispatcher> REQUEST </dispatcher> <dispatcher> FORWARD </dispatcher> <dispatcher> INCLUDE </dispatcher> <dispatcher> ERROR </dispatcher> </filter-mapping>

Une dclaration de filtre selon les spcifications 2.3 ressemble ceci:

<filter> <filter-name>HTTPMonitorFilter</filter-name> <filter-class> org.netbeans.modules.web.monitor.server.MonitorFilter </filter-class> <init-param> <param-name> netbeans.monitor.ide </param-name> <param-value> name-of-host-running NetBeans IDE:http-server-port </param-value> </init-param> </filter> <filter-mapping> <filter-name> HTTPMonitorFilter </filter-name> <url-pattern> /* </url-pattern> </filter-mapping>

Une application Web peut tre monitore avec le Moniteur HTTP de l'EDI depuis plusieurs IDE NetBeans en rajoutant des entres init-param supplmentaires la dclaration de filtre de la servlette dans le descripteur de dployement web. Par exemple, vous devriez rajouter une entre init-param comme celle montre ci-dessous:
<init-param> <param-name>

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 25

netbeans.monitor.ide </param-name> <param-value> name-of-2nd-host-running NetBeans IDE:http-server-port </param-value> </init-param>

IMPORTANT Lorsque vous dployez le module web que vous avez monitorer avec le Moniteur HTTP vers un serveur de production, souvenez-vous de supprimer les dclarations de mapping Servlet filter and filter mapping du descripteur de dployment du module web. Autrement le module web sera ouvert pour le Monitoring HTTP depuis les EDI NetBeans spcifis dans la(es) section(s) init-param section(s) du servlet de filtre dans le descripteur de dployement de module web.

Analyse des Donnes Rcoltes Aprs avoir mis en place le Moniteur HTTP, vous pouvez utiliser le Moniteur HTTP pour dboguer votre application web en observant les flots de donnes de vos pages JSP et servlettes sur votre serveur web. Le Moniteur HTTP enregistre les donnes de chaque requte rentrante. Le Moniteur HTTP est automatiquement affich au bas de l'EDI. Une copie d'cran du Moniteur HTTP est montre l'Illustration 6-7.

Illustration 6-7 Moniteur HTTP

Le Moniteur HTTP est constitu de deux panneaux principaux. A gauche se trouve la vue arborescente des enregistrements de requtes HTTP. Chaque requte HTTP fait au serveur HTTP est enregsitre dans le Moniteur HTTP. Les requtes rsultant d'un dispatch interne sont reflete par des noeuds imbriqus sous ces conteneurs web qui le supporte. De plus, les requtes de type Forward ou Include sont imbriques sous le noeud correspondant la requte principale.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 26

Dans le panneau de droite du Moniteur HTTP sont affiches les donnes supplmentaires pour un enregistrement de requte HTTP du panneau de gauche. Lorsque vous slectionnez une requte HTTP dans le panneau de gauche, les donnes de session correspondantes l'enregistrement slectionn sont affiches dans le panneau de droite. Les informations disponibles dans le panneau de droite incluent: les informations de requte dtailles, les paires nom du cookie/ valeur, les donnes de la session, du contexte de servlette, les attributs de contextes, les paramtres d'initialisation, les informations clients/serveurs comme le protocole client, l'adresse IP du client, la plateforme du serveur, le host name du serveur, ainsi que les informations de l'entte de la requte HTTP. Le panneau de droite vous permet de voir les donnes spcifiques pour chacune de ces catgories en slectionnant l'onglet correspondant l'information que vous dsirez voir. L'illustration 6-7 ci-dessous vous montre les informations de session supplmentaire pour un enregistrement de requte HTTP.

Illustration 6-7 HTTP Monitor with a record selected and its request data displayed Dans la vue arborescente du panneau de gauche du Moniteur HTTP, il y a deux catgories d'enregsitrements qui peuvent tre visualiss. Les enregistrement actuels ou les enregistrements sauvegards. Les Enregistrements Actuels reprsentent les enregistrement de requtes HTTP collecte depuis que l'EDI NetBeans a t dmar. Les Enregistrements Actuels vont persister aux redmarrage des serveurs Web, mais ils ne vont pas persister au redmarrage de l'EDI NetBeans. Pour rendre les informations persistantes aux redmarrage de l'EDI NetBeans, ils doivent tre sauvegards quelque part. Les Enregistrements Actuels peuvent tre sauvegards individuellement en slectionnant l'enregistrement d'une requte HTTP, en cliquant droit dessus et en choisissant Save depuis le menu contextuel. Vous pouvez slectionner plusieurs enregistrements de requtes HTTP en pressant les touches Maj ou Ctrl. L'Illustration 6-8 vous illustre la slection et la sauvegarde de multiples requtes HTTP.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 27

Illustration 6-8 Saving multiple records in the HTTP Monitor Remarquez que lorsque vous sauvegardez les requtes HTTP, les enregistrements slectionns sont dplacs dans la catgorie Saved Records. Les enregistrement slectionns ne sont pas copis. Vous devez en tenir compte lorsque vous dsirez rejouter une squence de requtes HTTP. Le panneau de gauche du Moniteur HTTP fournit galement plusieurs options de visualition des requtes HTTP dans la partie suprieur du panneau, sous la forme de cinq boutons. Par exemple, vous pouvez recharger tous les enregistrements de requtes HTTP, les trier par heure en ordre ascendant ou descendant, les trier alphabtiquement, et montrer ou cacher la date et heure de chaque requte HTTP. Le Tableau 6-4 rsume l'action de chacun des boutons. Tableau 6-4: boutons barre d'outils Moniteur HTTP
Bouton reload descending sort ascending sort alphabetically sort time stamp Action Recharge tous les enregistrements de requtes HTTP actuellement stoqus Trie les requtes HTTP enregistre selon la date et heure en ordre descendant Trie les requtes HTTP enregistre selon la date et heure en ordre ascendant Tie les enregsitrements de requtes HTTP alphabtiquement Cache ou affiche la date/heure dans la liste des requtes HTTP

En plus de sauvegarder les enregistrements de requtes HTTP, les enregsitrements peuvent galement tre supprims. L'EDI NetBeans fournit beaucoup de flexibilit lors de l'effacement des enregsitrements HTTP. Par exemple, vous pouvez effacer un ou plusieurs ou tous les enregistrements actuels. Vous pouvez galement supprimer un ou plusieurs ou tous les enregistrements sauvegards. Pour suppimer un Enregistrement Actuel individuel, cliquez droit sur l'enregistrement effacer et choisissez l'option Delete du menu contextuel. Pour supprimer plusieurs Enregistrements Actuels, slectionnez plusieurs enregistrement l'aide des touches Maj et Ctrl, et ensuite cliquezdroit sur les enregistrements slectionns et choisissez l'option Delete du menu contextuel. Pour supprimer tous les Enregistrements Actuels, cliquez droit sur le dossier Current Records et

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 28

choisissez l'option Delete. Procdez de la mme faon pour les enregsitrements situs dans la catgorie Saved Records. Rejouter des Requtes HTTP La fonctionnalit la plus puissante du Moniteur HTTP est sa capacit d'dtion et de rejouer des requtes HTTP. En ditant et rejouant des requtes HTTP, vous pouvez rapidement et facilement tracer et diagnostiquer des problmes avec le flot de donnes depuis l'excution des servlettes et pages JSP sur le serveur web. Lorsque vous rejouez une requte HTTP, la rponse apparat dans votre navigateur web. Donc, vous pouvez visuellement voir le rsultat d'une requte HTTP qui est rejoue dans votre navigateur web.
Conseil EDI NetBeans L'EDI ouvre votre navigateur web par dfaut lorsque vous rejouez les requtes HTTP. Si l'EDI ne peut trouver le navigateur web par dfaut du systme d'exploitation, vous pouvez configurer le navigateur web manuellement. Voyez Modification du Navigateur Web par dfaut de l'EDI la page XXX.

Aussi bien les Enregistrements Actuels que les Enregistrements Sauvegards peuvent tre rejous. Pour rejouer une requte HTTP, slectionnez la requte HTTP rejouer dans l'arborescence du panneau de gauche et choisissez l'option Replay dans le menu contextuel. L'Illustration 6-9 montre un Enregistrement Actuel prt tre rejou.

Illustration 6-9 Slection d'un enregistrement pour tre rejou dans le Moniteur HTTP Notez que l'enregistrement slectionn est rejou dans votre navigateur aprs que vous ayez choisi Replay dans le menu contextuel. En plus de rejouer les requtes HTTP, vous pouvez galement diter une requte HTTP avant de la rejouer. Pour diter une requte HTTP avant de la rejouer, slectionnez une requte HTTP dans l'arborescence du panneau de gauche, que ce soit un enregistrement Actuel ou un Enregistrement Sauvegard, cliquez-droit sur l'enregistrement et choisissez l'option Edit and Replay du menu contextuel. REMARQUE: Vous ne pouvez slectionnez plusieurs enregistrement dans le but de les diter et les rejouer. Aprs avoir choisi l'option Edit and Replay, une boite de dialogue est affiche o vous pouvez faire de nombreuses modifications.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 29

Les modifications supportes dans le Edit and Replay d'une requte HTTP inclut des options pour diter un paramtre dans la query, modifier les paramtres URI de la requte, modifier les cookies, modifier les proprits d'excution du serveur et modifier l'entte de la requte HTTP.

Illustration 6-10 Moniteur HTTP, bote de dialogue Edit and Replay Dans l'onglet Query, sur l'illustration Illustration 6-10, vous pouvez ajouter un paramtre de requte ou supprimer un paramtre de requte et modifier les paramtres de requte de l'URI. Dans l'onglet Request, vous pouvez modifier l'URI de la requte en slectionnant le bouton (...) situ prs de la valeur du paramtre de requte. Vous pouvez modifier la mthode de la requte d'un GET vers un POST ou un PUT, en slectionnant la liste droulante situe droite du type Request Method dans la colonne de gauche. Vous pouvez galement modifier le Protocole de Requte en slectionnant le bouton (...) situ dans la colonne de droite du Protocole de Requte. Dans l'onglet Cookies, vous pouvez ajouter, modifier ou supprimer des cookies associs la requte HTTP. Dans l'onglet Server, vous pouvez modifier les valeurs d'excution du serveur comme le host name, et le port o la requte HTTP doit tre excute. Vous pouvez ajouter, modifier ou supprimer des en-ttes HTTP dans l'onglet Headers. Aprs avoir fait les modifications que vous dsiriez la requte HTTP, vous pouvez rejouer la requte modifie en pressant le bouton Send HTTP Request. La requte HTTP qui en rsulte sera alors envoye vers votre navigateur web o le rsultat sera affich.

Guide Pratique EDI NetBeans, Dveloppement d'Applications Web, 30