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,
- l'adresse IP ou le nom d'hôte du poste client,
- le nom du dernier programme WADELIA exécuté dans cette session,
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. |
JAVA_OPTS |
Options de la ligne de commande JAVA. |
JPDA_TRANSPORT |
Mode de transport JPDA. |
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. |
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