📄 readme.html
字号:
<HTML><title>Readme</title>
<body bgcolor="#FFFFFF">
<p><img src="img/logoSysdeo137_53.gif" width="157" height="53"></p>
<p>Sysdeo Eclipse Tomcat Launcher plugin web site at : <a href="http://www.sysdeo.com/eclipse/tomcatPlugin.html">http://www.sysdeo.com/eclipse/tomcatPlugin.html</a></p>
<p>Documentation (french) : <a href="http://www.eclipsetotale.com/articles/tomcat/tomcatPluginDocFR.html">http://www.eclipsetotale.com/articles/tomcat/tomcatPluginDocFR.html</a></p>
<p>Send feedback to <a href="mailto:bleroux@sysdeo.com">bleroux@sysdeo.com</a>
<br>
</p>
<p> </p>
<h3>Plugin features </h3>
<ul>
<li>Setting Tomcat directory</li>
<li>Starting, stopping and restarting Tomcat 4.x, 5.0.x, or 3.3</li>
<li>Registering Tomcat process to Eclipse debugger</li>
<li>Creating a WAR project (wizard can update server.xml file)</li>
<li>Adding Java Projects to Tomcat classpath</li>
<li>Setting Tomcat JVM parameters, classpath and bootclasspath</li>
<li>Exporting a Tomcat project to a WAR File</li>
<li>Choosing Tomcat configuration file</li>
</ul>
<br>
<h3>Mailing list</h3>
<p>Send an email to <a href="mailto:bleroux@sysdeo.com ?Subject=Subscribe&body=Subscribe to Tomcat plugin mailing list">bleroux@sysdeo.com</a>
to be notified when a new version is released.</p>
<p><br>
</p>
<h3><b>Installation</b></h3>
<ul>
<li>This plugin does not contain Tomcat 5.<br>
(Download and install Tomcat before using it)</li>
<li>Download tomcatPluginV??.zip</li>
<li>Unzip it in <eclipse_home>/plugins</li>
<li>Plugin activation : select menu 'Perspective>Customize...', expand 'Other',
and check 'Tomcat'<br>
</li>
<li>Set Tomcat home : Workbench -> Preferences, select Tomcat and set Tomcat
home</li>
<li>This plugin launches Tomcat using the default JRE checked in Eclipe preferences
window.<br>
To set a JDK as default JRE for Eclipse open the preference window : Window
-> Preferences -> Java -> Installed JREs.<br>
This JRE <b>must</b> be a JDK (This is a Tomcat prerequisite).<br>
We recommend that you use JDK 1.4 as it supports hot code replacement feature.</li>
<li>The plugin sets itself Tomcat classpath and bootclasspath. Use Preferences
-> Tomcat ->JVM Settings, only if you need specific settings.</li>
</ul>
<br>
<h3><b>Working on a Tomcat project</b></h3>
<ul>
<li>Version 0.9 introduces a Tomcat project wizard, see <a href="releaseNotesV095.txt">releaseNotesV095.txt</a>
</li>
</ul>
<p>If you don't want to use the Tomcat project wizard, follow these steps :</p>
<ul>
<li>Create a java project, its structure should be compliant with a war directory
structure. Two ways to create this project :
<ul>
<li>create the project in eclipse workspace, then tell Tomcat that this
project is a web application, to do that add the following line to your
tomcat server.xml file :<br>
<context path="/yourProjectUrlPath"<br>
docbase="C:\your\project\abosolute\directory\path" /></li>
<li>when creating the project unselect 'Use project default location' and
set location to a Tomcat web application directory (webapps subdirectory)
</li>
</ul>
</li>
<li>Add Tomcat jar files (servlet.jar could be enough) to your project Build
path :<br>
( open project properties, select Java Build Path, select librairies panel
and 'Add external JARs...')</li>
<li>Start Tomcat from Tomcat menu AFTER your project is created.</li>
</ul>
<br>
<h3><b><a name="JSP"></a>JSP Debugging</b></h3>
<p>We plan to make JSP debugging easier. For the moment, follow those steps :
<br>
(In version 0.9, steps 1 to 3 are automaticaly done by Tomcat Project Wizard)</p>
<ul>
<li>Create a directory work in your project, in this directory create the following
directory structure : /org/apache/jsp/</li>
<li>Set work directory as a source folder for your project<br>
(open project properties, select Java Build Path, select Source panel and
'Add Existing folders...')</li>
<li>Tell Tomcat to put java files resulting from jsp compilation in this directory<br>
( open tomcat server.xml file and set your application context like this :<br>
<context path="/yourProjectUrlPath"<br>
docbase="C:\your\project\abosolute\directory\path or /relative/path/from/webapps"<br>
workDir="C:\your\project\abosolute\directory\path\work\org\apache\jsp" />
)</li>
<li>Start Tomcat from Tomcat menu</li>
<li> Call your JSP from a web browser</li>
<li>In Eclipse select work folder in your project and 'Refresh from Local',
java files generated from your JSP should be seen by Eclipse and you can set
breakpoint</li>
</ul>
<p> </p>
<p><b>Known problems</b> : Tomcat 4 and JSP in project subdirectories</p>
<p>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.</p>
<ul>
<li>Workaround 1 : install <a href="http://www.sysdeo.com/eclipse/tomcatPlugin.html#tcp">our
Tomcat 4.x patch</a>.</li>
<li>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 :<br>
http://myhost:8080/myapplication/servlets/org.apache.jsp.myjspdir.myjsp$jsp</li>
<li> Workaround 3 : use Tomcat 3.3 (servlet 2.2 and JSP 1.1), with Tomcat 3,
package definition is compliant with file location.<br>
</li>
</ul>
<p> </p>
<p> </p>
<p>Send your feedback to <a href="mailto:bleroux@sysdeo.com">bleroux@sysdeo.com</a></p>
<p>(c) <a href="http://www.sysdeo.com">Sysdeo</a> 2002 - <a href="http://www.eclipsetotale.com"><font color="#FFFFFF" size="-7">http://www.eclipsetotale.com</font></a></p>
<h3><br>
</h3>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -