Sysdeo Eclipse Tomcat Launcher
- 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)
This plugin is free and open-source
Tomcat 4.x patch for JSP debugging (Thanks
to Johan Compagner)
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
- 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
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
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
- 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
- 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.
Official documation (french) : http://www.eclipsetotale.com/articles/tomcat/tomcatPluginDocFR.html
Tutorials (english) :
- 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
- 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