Sysdeo Eclipse Tomcat Launcher plugin

Fonctionnalités du plugin

• Démarrer, arrêter et redémarrer Tomcat 4.x, 5.0.x ou 3.3.
• Faire apparaître le processus Tomcat dans le débogueur d'Eclipse.
• Créer un projet WAR (mise à jour du fichier server.xml possible).
• Ajouter des projets Java au classpath de Tomcat.
• Paramètrer la machine virtuelle utilisée pour démarrer Tomcat : modifier les paramètres, le classpath et le bootclasspath.
• Exporter un projet Tomcat vers un fichier WAR.
• Choisir le fichier de configuration Tomcat à utiliser.
• Utilisation possible d'un classloader Tomcat spécial capable de charger des classes issues de plusieurs projets java au même niveau que celles chargées pour un projet Tomcat, lire readmeDevLoader.html (Merci à Martin Kahr)

Liste de diffusion

Envoyer un email à pour être averti de la sortie de nouvelles versions. En cas de problème consulter la section 'dépannage' puis écrivez à

Téléchargement

Ce plugin est gratuit et 'open-source'

Patch Tomcat 4.x pour le déboguage des JSP (Merci à Johan Compagner)

Pour installer ce patch, décompresser le fichier dans le répertoire <%TOMCAT%>/classes pour Tomcat 4.0.x, ou dans <%TOMCAT%/common/classes pour Tomcat 4.1.x
Plus de détail sur ce problème ci-desssous

Installation

• Utiliser un build Eclipse 2.0.x ou Eclipse 2.1. Eclipse 3.0 M2 est supporté à partir de la version 2.1.1 du plug-in.
• Le plugin ne contient pas Tomcat.
  (Télécharger et installer Tomcat pour pouvoir utiliser le plugin)
• Télécharger le fichier tomcatPluginV?.zip.
• Décompresser le dans le répertoire <racine_eclipse>/plugins.
• Activer le plugin dans Eclipse 2.1 :
  menu 'Window->Customize perspective...', cliquer sur 'Others' et cocher 'Tomcat'.
• Activer le plugin dans Eclipse 3.0 :
  menu 'Window->Customize Perspective...', onglet 'Commands', et cocher 'Tomcat' dans lma liste 'Available command groups'
  
• Indiquer le répertoire de Tomcat : Window -> Preferences -> Tomcat.
• Ce plugin lance Tomcat en utilisant le JRE par défaut d'Eclipse.
  Pour modifier ce JRE utiliser Window -> Preferences ->Java -> Installed JREs.
  Ce JRE doit absolument être un JDK (C'est un prérequis pour Tomcat qui utilise javac pour compiler les JSP).
  Nous vous recommandons d'utiliser le JDK 1.4 car il permet la modification de code à la volée.
  
• Le plugin initialise lui-même le classpath et le bootclasspath de Tomcat. Utiliser l'écran de paramètrages, Preferences->Tomcat->Paramètres de la JVM, uniquement si vous avez des besoins spécifiques.

Pour plus d'informations, consulter la documentation complète à l'adresse suivante : http://www.eclipsetotale.com/articles/tomcat/tomcatPluginDocFR.html

Manipuler des projets Tomcat

• Le plugin propose un assistant pour la création et l'importation de projet Tomcat. L'utilisation de cet assistant permet de déclarer automatiquement le projet dans le fichier de configuration de Tomcat. Pour plus d'information consulter la documentation complète à l'adresse suivante : http://www.eclipsetotale.com/articles/tomcat/tomcatPluginDocFR.html

Déboguage des JSP

Il est prévu d'essayer de simplifier le déboguage des JSP. Pour l'instant, les étapes à suivre sont les suivantes :

• Appeler au moins une fois la JSP à partir d'un browser.
• Dans Eclipse sélectionner le répertoire work, ouvrir le menu contextuel et choisir 'Refresh from Local', les fichiers java générés sont alors affichés par Eclipse et il est possible d'y placer des points d'arrêt.

Problème connu 1 : Tomcat 4 et les JSP placées dans des sous-répertoires

Les servlets générés par Tomcat 4 ne sont pas compilable directement par Eclipse. Le problème vient du fait que Tomcat 4 déclare tous les servlets générés dans le package suivant 'org.apache.jsp', or les fichiers créés ne sont pas placés dans un répertoire respectant cette définition de package.

• Solution 1 : installer notre patch Tomcat 4.x.
• Solution 2 (de Gabriel Krupa) : soit le fichier JSP suivant /myjspdir/myjsp.jsp, le servmet généré sera placé dans work/org/apache/jsp/myjspdir, modifier manuellement la déclaration du package dans le fichier Java en passant de org.apache.jsp à org.apache.jsp.myjspdir, pour déboguer la JSP y accéder par l'URL suivante :
  http://myhost:8080/myapplication/servlets/org.apache.jsp.myjspdir.myjsp$jsp
• Solution 3 : utiliser Tomcat 3.3 (servlet 2.2 and JSP 1.1), avec Tomcat 3 le package déclaré est conforme avec le positionnement du fichier.
  

Problème connu 2 : Points d'arrêt incatif avec Tomcat 5

Dans le cas d'un projet Tomcat créé avec une version du plugin antérieure à la version 3, Eclipse ne s'arrête par aux points d'arrêts placés dans les servlets générés. Pour corriger le problème suivez la procédure suivante :

• Ouvrir les propriétés du projet, aller dans la section 'Java Build Path'
• Dans l'onglet 'Source' tab, cocher'Allow output folders for source folders'
• Dans la liste 'Source folders on build path', sélectionner '%Your_project%/work' puis 'Output Folder'
• cliquer sur le bouton 'Edit', cocher 'Specific output folder' et entrer 'work' dans le champs de saisie

Dépannage

• Si après l'installation le plugin n'apparaît pas dans Eclipse 3, lancer une fois Eclipse avec l'option '-clean'
• ClassNotFoundException sur la classe javac/Main lors de l'appel à une JSP : Tomcat est démarré avec un JRE alors qu'il nécessite un JDK.
• En cas de problème avec le plugin consulté le fichier de log (<workspace>/.metadata/.log)
• A compléter

Envoyer vos commentaires à

(c) Sysdeo 2002 - http://www.eclipsetotale.com