Pour déboguer votre application, vous devez utiliser un environnement de développement, tel que IBM® Rational Application
Developer for WebSphere pour créer un projet Java™.
Vous devez ensuite importer le programme à déboguer dans le projet.
Pourquoi et quand exécuter cette tâche
En exécutant les étapes décrites dans cette rubrique, vous pouvez importer les exemples WebSphere Application Server dans un projet Java. Deux méthodes de débogage sont possibles :
- Le mode pas-à-pas affiche un message chaque fois que le serveur
appelle une méthode sur un objet Web. Une boîte de dialogue permet d'appliquer la méthode ou de
l'ignorer. Elle vous permet également de désactiver le mode pas à pas une fois que vous avez fini de l'utiliser.
- Le mode de débogage Points d'arrêt permet de déboguer des parties spécifiques des
programmes. Ajoutez des points d'arrêt à la partie du code que vous souhaitez déboguer et exécutez le programme jusqu'à ce que l'un des points d'arrêt soit détecté.
Les points d'arrêt fonctionnent avec deux styles de débogage. Le mode pas à pas permet
simplement de voir quels sont les objets Web appelés sans qu'il soit nécessaire de définir
prélablement des points d'arrêt.
Il n'est pas nécessaire d'importer un programme complet dans le projet, mais la compilation de certains fragments de code risque d'échouer. Vous pouvez toujours déboguer le projet. La plupart des fonctions du débogueur sont disponibles, y compris les points d'arrêt, l'entrée dans le code, l'affichage et la modification des variables. Vous devez importer tout code source dans lequel vous
souhaitez définir des points d'arrêt.
Toutefois, les fonctions d'inspection et
d'affichage de la vue du code source ne sont pas utilisables pas si le code source contient des erreurs de compilation. Les
fonctions d'inspection et d'affichage vous permettent de sélectionner une expression dans la vue du code source et de
l'évaluer.
Procédure
- Créez un projet Java en ouvrant la boîte de dialogue Nouveau projet.
- Select Java and Java Project on the side of the dialog.
- Cliquez sur Suivant et indiquez le nom du projet, par exemple, WASExamples.
- Cliquez sur Fin pour créer le projet.
- Sélectionnez le nouveau projet, choisissez Fichier > Importer >
Système de fichier, puis cliquez sur Suivant pour ouvrir la boîte de dialogue
du système de fichiers d'importation.
- Accédez au répertoire contenant les fichiers.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Accédez au répertoire suivant : racine_profil/installedApps/nom_noeud/DefaultApplication.ear/DefaultWebApplication.war.
Accédez au répertoire suivant : racine_profil/installedApps/nom_noeud/DefaultApplication.ear/DefaultWebApplication.war.
- Sélectionnez DefaultWebApplication.war dans la boîte de dialogue d'importation, puis cliquez sur Terminer. Cette opération importe les fichiers JSP (JavaServer Pages) et les sources Java pour les exemples du projet.
- Ajoutez au chemin de compilation Java les fichiers JAR nécessaires à la compilation.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Sélectionnez
Propriétés dans le menu contextuel. Choisissez le noeud du chemin de compilation Java, puis cliquez sur l'onglet Bibliothèques. Cliquez sur
Ajouter des JAR externes pour ajouter les fichiers JAR suivants :
Cliquez sur
OK une fois que tous les fichiers JAR ont été ajoutés.
![[IBM i]](../images/iseries.gif)
Sélectionnez
Propriétés dans le menu contextuel.
Choisissez le noeud du chemin de compilation Java, puis cliquez sur l'onglet Bibliothèques. Cliquez sur
Ajouter des JAR externes pour ajouter les fichiers JAR suivants :
Cliquez sur
OK une fois que tous les fichiers JAR ont été ajoutés.
- Vous pouvez alors définir des points d'arrêt dans le code source mais cela
n'est pas nécessaire car le programme en mode pas à pas vous invitera à le
faire à chaque appel de méthode effectué par le serveur sur un objet Web. Le mode étape par étape est expliqué plus en détail ultérieurement dans cette
rubrique.
- Pour lancer le débogage, vous devez démarrer WebSphere Application Server en mode débogage et noter le port de débogage JVM. La valeur par défaut du port de débogage JVM est 7777.
- Lorsque le serveur est démarré, passez en perspective de débogage en sélectionnant Fenêtre > Ouvrir la perspective > Débogage. Vous pouvez aussi activer le lancement
du débogage dans la perspective Java en choisissant Fenêtre > Personnaliser la
perspective et en cochant les cases Déboguer et Lancer
dans la catégorie Autre.
- Select the workbench toolbar Debug pushbutton and
then select WebSphere Application Server Debug from
the list of launch configurations. Cliquez sur le bouton de fonction Nouveau
pour créer une configuration.
- Attribuez un nom à votre configuration et sélectionnez le projet à déboguer (votre nouveau projet WASExamples). Changez le numéro de port si vous n'avez pas démarré le serveur sur le port par défaut (7777).
- Cliquez sur Déboguer pour lancer le débogage.
- Chargez l'un des exemples dans le navigateur. Par exemple, http://nom.serveur:9080/hitcount
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Que faire ensuite
Pour plus d'informations sur le débogage, lancez l'outil IBM Rational Application
Developer for WebSphere, sélectionnez
Aide > Sommaire puis choisissez l'entrée
Débogage d'applications. Pour plus d'informations sur les limites et les incidents liés à IBM Rational Application
Developer for WebSphere,
reportez-vous aux notes d'édition d'IBM Rational Application
Developer for WebSphere. Pour toutes
les dernières informations disponibles auprès du support technique
IBM sur
les incidents recensés et leur résolution, accédez à la page
IBM
Support.
Le support technique
d'IBM possède des
documents permettant de gagner du temps lors de la collecte des informations requises pour
résoudre ce problème. Avant d'ouvrir un PMR, consultez la page des Documents à rassembler pour connaître les informations à envoyer au
support technique IBM.