Attachement à une session Web (Débogueur Visual-Web)

Accès

Pour déboguer une session Web (programmes WADELIA) ou un service Web (programmes VADELIA), choisir l'option Attacher à une session Web du menu Fichier de la fenêtre du débogueur Visual/Web.

Le débogueur permet de s'attacher à un serveur d'application JAVA (Tomcat, ...) pour déboguer une session WADELIA ou un service Web (via la pseudo session "Débogage de service Web").

Pour cela, le serveur d'application exécutant les applications Adélia Web Studio doit être démarré avec le support de débogage JPDA, et définir la propriété système "adelia.debuggingsupport" (voir exemple plus bas).

Les champs de saisie

Nom d'hôte

Ce champ permet de saisir le nom d'hôte ou l'adresse IP de la machine sur laquelle le serveur d'application est démarré.

Saisie obligatoire.

Le bouton Sessions attenant à ce champ permet de se connecter au serveur d'application et de rapatrier la liste des sessions WADELIA actives ayant démarré le support du débogage.

Port de connexion JPDA

Ce champ permet de saisir le port de connexion pour le connecteur JPDA. Le serveur d'application doit être démarré en mode serveur, avec le connecteur JPDA dt_socket, sur ce port.

Saisie obligatoire.

La liste

La liste graphique affiche la liste des sessions WADELIA en mode débogage actives sur le serveur d'applications. Cette liste affiche dans l'ordre :

l'identificateur de la session,
Le nom de l'application Web (cf. tag "display-name" du fichier web.xml),
l'adresse IP ou le nom d'hôte du poste client,
le nom du dernier programme WADELIA exécuté dans cette session,
le préfixe de la pseudo-session Web (mode protégé).

Note : la liste affiche également une pseudo-session "Débogage de service Web".

Cette session permet de s'attacher pour déboguer des services Web générés par Adélia, il ne s'agit pas d'une session HTTP.

Les boutons

Attacher

Ce bouton permet l'ouverture d'une session de débogage sur la session Web (ou pseudo-session Web) sélectionnée.

Annuler

Ce bouton ferme la boîte de dialogue sans valider les modifications effectuées.

Exemple : Tomcat

Pour démarrer Tomcat avec le support JPDA, vous devez définir les variables d'environnement suivantes, puis lancer le serveur d'application avec les paramètres "jpda start" :

Variable	Signification
CATALINA_HOME	Répertoire d'installation de TOMCAT. "C:\Program Files\Tomcat" par défaut.
JAVA_OPTS	Options de la ligne de commande JAVA. Pour le débogueur, cette variable doit être définie et comprendre le paramètre "-Dadelia.debuggingsupport".
JPDA_TRANSPORT	Mode de transport JPDA. Vous devez impérativement utiliser la valeur dt_socket.
JPDA_ADDRESS	Adresse JPDA. Dans notre cas, il s'agit d'un numéro de port TCP/IP que le débogueur utilisera pour se connecter à Tomcat. Le port 8000 est souvent réservé pour cet usage.

Exemple de script (.bat) démarrant le serveur d'application Tomcat (4.x) avec le support JPDA sur le port 8000 :

@echo off

set CATALINA_HOME=C:\Program Files\Tomcat

set JAVA_OPTS=-Dadelia.debuggingsupport

set JPDA_TRANSPORT=dt_socket

set JPDA_ADDRESS=8000

call "%CATALINA_HOME%\bin\catalina.bat" jpda start

Alternativement, vous pouvez copier le fichier startup.bat en startup_jpda.bat et y ajouter les lignes suivantes :

...

:doneSetArgs

rem Enable Adelia debugging support

rem --------------------------------------

set JAVA_OPTS=%JAVA_OPTS% -Dadelia.debuggingsupport

set JPDA_TRANSPORT=dt_socket

set JPDA_ADDRESS=8000

call "%EXECUTABLE%" jpda start %CMD_LINE_ARGS%

...

Sous Windows, pour un démarrage en service de Tomcat, vous fixez les options dans le cadre 'Java Options' de l'onglet Java de la fenêtre de propriétés de Tomcat. Les options sont renseignées sur trois lignes distinctes :

-Xdebug

-Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n

-Dadelia.debuggingsupport

↑ Haut de page