Sysdeo Formation
    
Technologies
 Vous êtes Accueil > Technologies > Eclipse/WSAD
 

Sysdeo Eclipse Tomcat Launcher plugin

Version française

Plugin features

  • Starting, stopping and restarting Tomcat 4.x, 5.0.x, 3.3
  • Registering Tomcat process to Eclipse debugger
  • Creating a WAR project (wizard can update server.xml file)
  • Adding Java Projects to Tomcat classpath
  • Setting Tomcat JVM parameters, classpath and bootclasspath
  • Exporting a Tomcat project to a WAR File
  • Choosing Tomcat configuration file
  • Capability to use a special Tomcat classloader to have classes in several java projects loaded at the same classloader level than classes in a Tomcat project, see readmeDevLoader.html (Thanks to Martin Kahr)

Download

This plugin is free and open-source

Version
File
Date
Comment

3.1
beta

tomcatPluginV31beta.zip
14 Apr 2005

releaseNotesV31.txt

Works with Eclipse 3.0 and Eclipse 3.1 (fix a problem with Eclipse 3.1M6)

3.0

tomcatPluginV3.zip
27 July 2004

releaseNotesV3.txt

Works with Eclipse 3.0 and Eclipse 2.1

3.0
beta

tomcatPluginV3beta.zip
6 July 2004

Works with Eclipse 3.0 and Eclipse 2.1

3.0
alpha

tomcatPluginV3alpha1.zip
24 May 2004

Works with Eclipse 3.0M9 and Eclipse 2.1
(No new feature, only fix problems with M9)

2.2.1
tomcatPluginV221.zip
4 Dec 2003

releaseNotesV221.txt

(Fix a problem with Tomcat 5.0.16)

2.2
tomcatPluginV22.zip
10 Nov 2003
releaseNotesV22.txt
2.2
beta2
tomcatPluginV22beta2.zip
22 Oct 2003
releaseNotesV22beta.txt
Fix a bug with whitespaces in Tomcat directory name
2.2
beta
tomcatPluginV22beta.zip
20 Oct 2003
releaseNotesV22beta.txt
Works with Eclipse 2.1 and Eclipse 3.0 M4
2.1.1
beta
tomcatPluginV211beta.zip
1 Aug 2003
releaseNotesV211beta.txt
Works with Eclipse 2.1 and Eclipse 3.0 M2
2.1
tomcatPluginV21.zip
1 Apr 2003
releaseNotesV21.txt
2.1 beta
tomcatPluginV21beta.zip
28 Feb 2003

This version works on Eclipse 2.0.x and Eclipse 2.1 builds (included RC1).

2.0.1
tomcatPluginV201.zip
31 Jul 2002
releaseNotesV201.txt
2.0
tomcatPluginV2.zip
26 Jul 2002
releaseNotesV2.txt
0.99
tomcatPluginV099.zip
3 Jun 2002

releaseNotesV099.txt

0.98
tomcatPluginV098.zip
23 May 2002
releaseNotesV098.txt
0.96
tomcatPluginV096.zip
14 Apr 2002
releaseNotesV096.txt
0.95
tomcatPluginV095.zip
26 Mar 2002
releaseNotesV095.txt
0.91
tomcatPluginV091.zip
25 Feb 2002
releaseNotesV091.txt
0.9
tomcatPluginV09.zip
12 Feb 2002
releaseNotesV09.txt
0.7
tomcatPluginV07.zip
14 Jan 2002

releaseNotesV07.txt

0.6
tomcatPluginV06.zip
04 Jan 2002
Previously named tomcatPlugin.zip


Tomcat 4.x patch for JSP debugging (Thanks to Johan Compagner)

Tomcat Version
File
Date

4.1.24
4.1.27

jasperDebugPatchV4.1.24.zip
1 Apr 2003
4.1.18
jasperDebugPatchV4.1.18.zip
17 Feb 2003
4.1.12
jasperDebugPatchV4.1.12.zip
6 Nov 2002
4.1.10
jasperDebugPatchV4.1.10.zip
Updated
6 Nov 2002
4.1.3
jasperDebugPatchV4.1.3.zip
31 Jul 2002
4.0.4
26 Jul 2002
4.02, 4.03, 4.04b2
26 Mar 2002

To install this patch, unzip the file in <%TOMCAT_HOME%>/classes for tomcat 4.0x, or in <%TOMCAT_HOME%>/common/classes for Tomcat 4.1.x
More details on this problem bellow


Installation

  • This plugin does not contain Tomcat.
    (Download and install Tomcat before using this plugin).
    This is a desing choice not to include Tomcat in the plugin distribution, this way everyone can choose a Tomcat version, it is easy to switch from one Tomcat version to another
  • Download tomcatPluginVxxx.zip
  • Unzip it in <eclipse_home>/plugins
  • Plugin activation for Eclipse 2.1 :
    select menu 'Window->Customize Perspective...', expand 'Others' and check 'Tomcat'
  • Plugin activation for Eclipse 3.0 :
    select menu 'Window->Customize Perspective...->Commands', and check 'Tomcat' in 'Available command groups'
  • Set Tomcat home : Window -> Preferences, select Tomcat and set Tomcat home
  • This plugin launches Tomcat using the default JRE checked in Eclipe preferences window.
    To set a JDK as default JRE for Eclipse open the preference window : Window -> Preferences -> Java -> Installed JREs.
    This JRE must be a JDK (This is a Tomcat prerequisite).
  • The plugin sets itself Tomcat classpath and bootclasspath. Use Preferences -> Tomcat ->JVM Settings, only if you need specific settings.


Working with Tomcat project

  • This plugin add a new type of Java project to Eclipse : Tomcat project. A Tomcat project could be automatically declare in Tomcat configuration. Compilation build path will be set automatically.

 

JSP Debugging

Follow those steps :

  • Call your JSP from a web browser
  • In Eclipse select work folder in your project and 'Refresh' from the popup menu, java files generated for your JSP should be seen by Eclipse and you can set breakpoint

Known problem 1 : Tomcat 4 and JSP in project subdirectories

Generated servlets for JSP couldn't be compile by Eclipse. Subdirectories do not appear in Tomcat 4 generates servlets. Package definition is always package org.apache.jsp.

  • Workaround 1 : install our Tomcat 4.x patch.
  • Workaround 2 (from Gabriel Krupa) : if your jsp is /myjspdir/myjsp.jsp, generated servlet will be in work/org/apache/jsp/myjspdir, change package definition from org.apache.jsp to org.apache.jsp.myjspdir, to debug your jsp access it from your browser with the following URL :
    http://myhost:8080/myapplication/servlets/org.apache.jsp.myjspdir.myjsp$jsp
  • Workaround 3 : use Tomcat 3.3 (servlet 2.2 and JSP 1.1), with Tomcat 3, package definition is compliant with file location.

Known problem 2 : Tomcat 5

With Tomcat 5 generated java files could be compile by Eclipse. For Tomcat projects created with plugin versions prior to 3.x, eclipse doesn't stop at the breakpoints. Follow these steps to fix the problem :

  • Edit your Tomcat project Java Build Path
  • in 'Source' tab, check 'Allow output folders for source folders'
  • in the list named 'Source folders on build path', select or add '%Your_project%/work'. You may need to create the directory and refresh the project first.
  • Select 'Output Folder' after opening '%Your_project%/work'
  • select the 'Edit' button, check 'Specific output folder' and enter 'work' in the text field.

Documentation and tutorials

Official documation (french) : http://www.eclipsetotale.com/articles/tomcat/tomcatPluginDocFR.html

Tutorials (english) :

 

Troubleshooting

  • In some case, despite it is correctly unzipped in Eclipse 3 'plugins' directory, the plugin is not loaded : run Eclipse with the -clean option to solve the problem.
  • ClassNotFoundException on javac/Main when accessing JSP : Tomcat is started with a JRE instead of a JDK.
  • If you have a problem with the plugin check eclipse log file (<workspace>/.metadata/.log)
  • To be completed

If you have other problems with this plugin send an email to . (Select this button : Preferences->Tomcat->JVM Settings->Dump configuration to .log file, and include in your email the corresponding lines of your .log file, it is in <%Your_Workspace_dir%>/.metadata)

 

Send your feedback to

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

 



    le site d'Eclipse

le site eclipsetotale.com
 
      Plus d'informations, contactez notre directeur technique :

 
service services nouvelles technologies méthodologie processus de développement portail conseil architecture architecte administration framework frameworks objet design pattern design patterns patron de conception modèle de conception composants composants réutilisables réutilisation plateforme J2EE plate-forme J2EE serveurs d'applications mise en oeuvre mise-en-oeuvre maîtrise d'oeuvre maitrise d'oeuvre maîtrise d'ouvrage maitrise d'ouvrage gestion de projets gestion de projet J2EE connecteurs connecteur connecteurs CICS connecteur CICS CICS connectors applications web évaluer audit auditer normes outil outils adapter adaptation intégrer intégration intégration de l'existant migrer migration java j2ee Java2 Entreprise Edition Java 2 Entreprise Edition web mvc mvc2 mvcII JMS Java Messaging Service Java Message Service JCA Java Connector Architecture EAI Entreprise Application Integration UML EJB Entreprise JavaBeans Entreprise Java Beans Entreprise JavaBean Entreprise Java Bean JSP taglibs taglib servlet servlets Apache Tomcat Jakarta Struts Struts eclipse eclipse2 websphere wsad wsad4 wsad4.0 wsad5.0 websphere studio application developper wsed wsed5.0 websphere studio entreprise developper wssd websphere studio site developper websphere studio site developper advanced wsad-ie wsadie websphere studio application developer integration edition websphere studio was was5 was5.0 was4 was4.0 was3.5