cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
markt 2004/06/18 16:49:03 Modified:webapps/tomcat-docs jasper-howto.xml Log: Fix bug 23880. Correct ant path - Patch provided by Ben Kelley Revision ChangesPath 1.11 +1 -1 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml Index: jasper-howto.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- jasper-howto.xml 16 Mar 2004 22:51:17 - 1.10 +++ jasper-howto.xml 18 Jun 2004 23:49:03 - 1.11 @@ -239,7 +239,7 @@ (replacing the tokens with the Tomcat base path and the path to the webapp which should be precompiled):br/ source -$ANT_HOME/ant -Dtomcat.home=lt;$TOMCAT_HOMEgt; -Dwebapp.path=lt;$WEBAPP_PATHgt; +$ANT_HOME/bin/ant -Dtomcat.home=lt;$TOMCAT_HOMEgt; -Dwebapp.path=lt;$WEBAPP_PATHgt; /source /p - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
markt 2004/03/16 14:51:17 Modified:webapps/tomcat-docs jasper-howto.xml Log: Remove reference to unsupported largefile option. Revision ChangesPath 1.10 +0 -4 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml Index: jasper-howto.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- jasper-howto.xml 12 Mar 2003 09:51:48 - 1.9 +++ jasper-howto.xml 16 Mar 2004 22:51:17 - 1.10 @@ -126,10 +126,6 @@ code for each page instead of deleting it? codetrue/code or codefalse/code, default codetrue/code./li -listronglargefile/strong - Should we store the static content of JSP -pages in external data files, to reduce the size of the generated servlets? -codetrue/code or codefalse/code, default codefalse/code./li - listronglogVerbosityLevel/strong - The level of detailed messages to be produced by this servlet. Increasing levels cause the generation of more messages. Valid values are codeFATAL, ERROR, WARNING, INFORMATION,/code - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
remm2003/03/12 01:51:48
Modified:webapps/tomcat-docs jasper-howto.xml
Log:
- Docs enhancement.
Revision ChangesPath
1.9 +8 -5 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml
Index: jasper-howto.xml
===
RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- jasper-howto.xml 7 Mar 2003 11:08:04 - 1.8
+++ jasper-howto.xml 12 Mar 2003 09:51:48 - 1.9
@@ -19,6 +19,7 @@
a href=#UpgradingUpgrading/abr /
a href=#ConfigurationConfiguration/abr /
a href=#Production ConfigurationProduction Configuration/abr /
+a href=#Web Application CompilationWeb Application Compilation/abr /
a href=#Using JikesUsing Jikes/abr /
/p
/section
@@ -168,9 +169,9 @@
/section
-section name=Web application precompilation
+section name=Web Application Compilation
-pUsing Ant is the preferred way to precompile web applications.
+pUsing Ant is the preferred way to compile web applications using JSPC.
Use the script given below to precompile a webapp:
/p
@@ -193,7 +194,6 @@
lt;/taskdefgt;
lt;jasper2
- compile=false
validateXml=false
uriroot=${webapp.path}
webXmlFragment=${webapp.path}/WEB-INF/generated_web.xml
@@ -253,11 +253,14 @@
descriptor. Insert the code${webapp.path}/WEB-INF/generated_web.xml/code
at the right place inside the code${webapp.path}/WEB-INF/web.xml/code file.
Restart the web application (using the manager) and test it to verify it is
-running fine with precompiled servlets.
+running fine with precompiled servlets. An appropriate token placed in the
+web application deployment descriptor may also be used to automatically
+insert the generated servlet declarations and mappings using Ant filtering
+capabilities. This is actually how all the webapps distributed with Tomcat
+are automatically compiled as part of the build process.
/p
/section
-
section name=Using Jikes
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
remm2003/03/07 02:52:41
Modified:webapps/tomcat-docs jasper-howto.xml
Log:
- Add documentation on precompilation.
Revision ChangesPath
1.7 +91 -0 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml
Index: jasper-howto.xml
===
RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- jasper-howto.xml 12 Jan 2003 17:26:46 - 1.6
+++ jasper-howto.xml 7 Mar 2003 10:52:41 - 1.7
@@ -168,6 +168,97 @@
/section
+section name=Web application precompilation
+
+pUsing Ant is the preferred way to precompile web applications.
+Use the script given below to precompile a webapp:
+/p
+
+p
+source
+lt;project name=Webapp Precompilation default=all basedir=.gt;
+
+ lt;target name=jspcgt;
+
+lt;taskdef classname=org.apache.jasper.JspC name=jasper2 gt;
+ lt;classpath id=jspc.classpathgt;
+lt;pathelement location=${java.home}/../lib/tools.jar/gt;
+lt;fileset dir=${tomcat.home}/server/libgt;
+ lt;include name=*.jar/gt;
+lt;/filesetgt;
+lt;fileset dir=${tomcat.home}/common/libgt;
+ lt;include name=*.jar/gt;
+lt;/filesetgt;
+ lt;/classpathgt;
+lt;/taskdefgt;
+
+lt;jasper2
+ compile=false
+ validateXml=false
+ uriroot=${webapp.path}
+ webXmlFragment=${webapp.path}/WEB-INF/generated_web.xml
+ outputDir=${webapp.path}/WEB-INF/src /gt;
+
+ lt;/targetgt;
+
+ lt;target name=compilegt;
+
+lt;mkdir dir=${webapp.path}/WEB-INF/classes/gt;
+lt;mkdir dir=${webapp.path}/WEB-INF/lib/gt;
+
+lt;javac destdir=${webapp.path}/WEB-INF/classes
+ optimize=off
+ debug=on failonerror=false
+ srcdir=${webapp.path}/WEB-INF/src
+excludes=**/*.smapgt;
+ lt;classpathgt;
+lt;pathelement location=${webapp.path}/WEB-INF/classes/gt;
+lt;fileset dir=${webapp.path}/WEB-INF/libgt;
+ lt;include name=*.jar/gt;
+lt;/filesetgt;
+lt;pathelement location=${tomcat.home}/common/classes/gt;
+lt;fileset dir=${tomcat.home}/common/libgt;
+ lt;include name=*.jar/gt;
+lt;/filesetgt;
+lt;pathelement location=${tomcat.home}/shared/classes/gt;
+lt;fileset dir=${tomcat.home}/shared/libgt;
+ lt;include name=*.jar/gt;
+lt;/filesetgt;
+ lt;/classpathgt;
+ lt;include name=** /gt;
+ lt;exclude name=tags/** /gt;
+lt;/javacgt;
+
+ lt;/targetgt;
+
+ lt;target name=all depends=jspc,compilegt;
+ lt;/targetgt;
+
+lt;/projectgt;
+/source
+/p
+
+p
+The following command line can be used to run the script
+(replacing the tokens with the Tomcat base path and the path to the webapp
+which should be precompiled):br/
+source
+$ANT_HOME/ant.sh -Dtomcat.home=lt;$TOMCAT_HOMEgt;
-Dwebapp.path=lt;$WEBAPP_PATHgt;
+/source
+/p
+
+p
+Then, the declarations and mappings for the servlets which were generated
+during the precompilation must be added to the web application deployment
+descriptor. Insert the code${webapp.path}/WEB-INF/generated_web.xml/code
+at the right place inside the code${webapp.path}/WEB-INF/web.xml/code file.
+Restart the web application (using the manager) and test it to verify it is
+running fine with precompiled servlets.
+/p
+
+/section
+
+
section name=Using Jikes
pIf you wish to use
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
remm2003/03/07 03:08:04 Modified:webapps/tomcat-docs jasper-howto.xml Log: - No .sh. Revision ChangesPath 1.8 +1 -1 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml Index: jasper-howto.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- jasper-howto.xml 7 Mar 2003 10:52:41 - 1.7 +++ jasper-howto.xml 7 Mar 2003 11:08:04 - 1.8 @@ -243,7 +243,7 @@ (replacing the tokens with the Tomcat base path and the path to the webapp which should be precompiled):br/ source -$ANT_HOME/ant.sh -Dtomcat.home=lt;$TOMCAT_HOMEgt; -Dwebapp.path=lt;$WEBAPP_PATHgt; +$ANT_HOME/ant -Dtomcat.home=lt;$TOMCAT_HOMEgt; -Dwebapp.path=lt;$WEBAPP_PATHgt; /source /p - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
glenn 2003/01/03 05:26:01 Modified:catalina/src/conf web.xml webapps/tomcat-docs jasper-howto.xml Log: Make Ant javac fork the default Revision ChangesPath 1.48 +1 -1 jakarta-tomcat-4.0/catalina/src/conf/web.xml Index: web.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/catalina/src/conf/web.xml,v retrieving revision 1.47 retrieving revision 1.48 diff -u -r1.47 -r1.48 --- web.xml 31 Dec 2002 14:12:05 - 1.47 +++ web.xml 3 Jan 2003 13:26:01 - 1.48 @@ -117,7 +117,7 @@ !-- -- !-- forkTell Ant to fork compiles of JSP pages so that -- !-- a separate JVM is used for JSP page compiles -- - !-- from the one Tomcat is running in. [false] -- + !-- from the one Tomcat is running in. [true] -- !-- -- !-- javaEncodingJava file encoding to use for generating java -- !-- source files. [UTF8] -- 1.5 +1 -1 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml Index: jasper-howto.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- jasper-howto.xml 31 Dec 2002 14:12:05 - 1.4 +++ jasper-howto.xml 3 Jan 2003 13:26:01 - 1.5 @@ -116,7 +116,7 @@ listrongfork/strong - Have Ant fork JSP page compiles so they are performed in a seperate JVM from Tomcat? codetrue/code or -codefalse/code, default codefalse/code./li +codefalse/code, default codetrue/code./li listrongjavaEncoding/strong - Java file encoding to use for generating java source files. Default codeUTF8/code./li -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
glenn 2002/12/31 06:12:05 Modified:.RELEASE-NOTES-4.1.txt catalina/src/conf web.xml webapps/tomcat-docs jasper-howto.xml Log: Implement new Ant javac fork option. If set to true Ant forks a new process to compile JSP pages and does it without synchronization. Default is false. Revision ChangesPath 1.43 +5 -1 jakarta-tomcat-4.0/RELEASE-NOTES-4.1.txt Index: RELEASE-NOTES-4.1.txt === RCS file: /home/cvs/jakarta-tomcat-4.0/RELEASE-NOTES-4.1.txt,v retrieving revision 1.42 retrieving revision 1.43 diff -u -r1.42 -r1.43 --- RELEASE-NOTES-4.1.txt 30 Dec 2002 16:06:09 - 1.42 +++ RELEASE-NOTES-4.1.txt 31 Dec 2002 14:12:05 - 1.43 @@ -157,6 +157,10 @@ [4.1.8] JspCompilationContext: Use _ instead of $ to generate file and class names for jsp servlets. +[4.1.19] Compiler: + Added new fork option. This tells Ant to fork the JSP page javac + compile so that it is run in a different JVM from the one Tomcat + is running in. Please refer to the Jasper-HOWTO for more information. == BUG FIXES AND IMPROVEMENTS: 1.47 +4 -0 jakarta-tomcat-4.0/catalina/src/conf/web.xml Index: web.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/catalina/src/conf/web.xml,v retrieving revision 1.46 retrieving revision 1.47 diff -u -r1.46 -r1.47 --- web.xml 27 Dec 2002 20:54:43 - 1.46 +++ web.xml 31 Dec 2002 14:12:05 - 1.47 @@ -115,6 +115,10 @@ !-- Explorer when using jsp:plugin tags. -- !-- [clsid:8AD9C840-044E-11D1-B3E9-00805F499D93] -- !-- -- + !-- forkTell Ant to fork compiles of JSP pages so that -- + !-- a separate JVM is used for JSP page compiles -- + !-- from the one Tomcat is running in. [false] -- + !-- -- !-- javaEncodingJava file encoding to use for generating java -- !-- source files. [UTF8] -- !-- -- 1.4 +11 -3 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml Index: jasper-howto.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- jasper-howto.xml 28 Sep 2002 00:24:31 - 1.3 +++ jasper-howto.xml 31 Dec 2002 14:12:05 - 1.4 @@ -114,6 +114,10 @@ Explorer when using lt;jsp:plugingt; tags. Default codeclsid:8AD9C840-044E-11D1-B3E9-00805F499D93/code./li +listrongfork/strong - Have Ant fork JSP page compiles so they are +performed in a seperate JVM from Tomcat? codetrue/code or +codefalse/code, default codefalse/code./li + listrongjavaEncoding/strong - Java file encoding to use for generating java source files. Default codeUTF8/code./li @@ -152,9 +156,13 @@ ul listrongdevelopment/strong - To enable background compilation of JSP pages set this to codefalse/code./li -listrongcompiler/strong - The internal JVM javac compiler used by Ant -has a known memory leak. If you anticipate that JSP pages will get recompiled -frequently consider using an external compiler such as codejikes/code./li +listrongfork/strong - The internal JVM javac compiler used by Ant +has a known memory leak. And Ant requires that java compiles be synchronized, +i.e. only one JSP page can be compiled at a time. Set fork to +codetrue/code so that Ant compiles JSP pages in a seperate JVM. +This removes the synchronization of JSP page compiles and prevents +all the javac classes from being instantiated and subsequently garbage +collected by the JVM Tomcat is running in./li /ul /p -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml
glenn 2002/09/27 17:24:31 Modified:webapps/tomcat-docs jasper-howto.xml Log: Update docs for jikes Revision ChangesPath 1.3 +3 -1 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml Index: jasper-howto.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- jasper-howto.xml 13 Sep 2002 11:51:30 - 1.2 +++ jasper-howto.xml 28 Sep 2002 00:24:31 - 1.3 @@ -166,7 +166,9 @@ a href=http://oss.software.ibm.com/developerworks/opensource/jikes/; Jikes/a to compile JSP pages: ul -liDownload and install jikes./li +liDownload and install jikes. jikes must support the -encoding option. +Execute codejikes -help/code to verify that it was built with support +for code-encoding/code./li liSet the init parameter codecompiler/code to codejikes/code./li liDefine the property code-Dbuild.compiler.emacs=true/code when starting Tomcat by adding it to your codeCATALINA_OPTS/code environment variable. -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs jasper-howto.xml cgi-howto.xml ssi-howto.xml index.xml project.xml
glenn 2002/09/08 10:56:04 Modified:webapps/tomcat-docs index.xml project.xml Added: webapps/tomcat-docs jasper-howto.xml cgi-howto.xml ssi-howto.xml Log: Add three new HOT-TO documents Revision ChangesPath 1.15 +8 -3 jakarta-tomcat-4.0/webapps/tomcat-docs/index.xml Index: index.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/index.xml,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- index.xml 18 Aug 2002 00:54:26 - 1.14 +++ index.xml 8 Sep 2002 17:56:04 - 1.15 @@ -58,6 +58,8 @@ are responsible for installing, configuring, and operating a Tomcat 4 server. /p ul +lia href=cgi-howto.htmlstrongCGI HOW-TO/strong/a - Configuring +Tomcat to use CGI (Common Gateway Interface)./li lia href=config/index.htmlstrongServer Configuration Reference/strong/a - Reference manual that documents all available elements and attributes that may be placed into a Tomcat 4 codeconf/server.xml/code file. @@ -72,6 +74,8 @@ lia href=jndi-resources-howto.htmlstrongJNDI Resources HOW-TO/strong/a - Configuring standard and custom resources in the JNDI naming context that is provided to each web application./li +lia href=jasper-howto.htmlstrongJSP Engine Config HOW-TO/strong/a +- The Jasper 2 JSP Engine. How it works and how to configure it. /li lia href=manager-howto.htmlstrongManager App HOW-TO/strong/a - Operating the codeManager/code web app to deploy, undeploy, and redeploy applications while Tomcat is running./li @@ -87,10 +91,11 @@ HOW-TO/strong/a - Configuring and using a Java Security Manager to support fine-grained control over the behavior of your web applications. /li +lia href=ssi-howto.htmlstrongSSI HOW-TO/strong/a - Configuring +Tomcat to use SSI (Server Side Include)./li lia href=ssl-howto.htmlstrongSSL Configuration HOW-TO/strong/a - -Installing and -configuring SSL support so that your Tomcat will serve requests using -the codehttps/code protocol./li +Installing and configuring SSL support so that your Tomcat will serve +requests using the codehttps/code protocol./li /ul /section 1.16 +3 -0 jakarta-tomcat-4.0/webapps/tomcat-docs/project.xml Index: project.xml === RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/project.xml,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- project.xml 18 Aug 2002 00:53:54 - 1.15 +++ project.xml 8 Sep 2002 17:56:04 - 1.16 @@ -23,15 +23,18 @@ /menu menu name=Administrators +item name=CGI HOW-TOhref=cgi-howto.html/ item name=Config. Reference href=config/index.html/ item name=Class Loader HOW-TO href=class-loader-howto.html/ item name=JNDI DataSource HOW-TO href=jndi-datasource-examples-howto.html/ item name=JNDI Resources HOW-TO href=jndi-resources-howto.html/ +item name=JSP Engine Config HOW-TO href=jasper-howto.html/ item name=Manager App HOW-TOhref=manager-howto.html/ item name=Proxy Support HOW-TO href=proxy-howto.html/ item name=Realm HOW-TO href=realm-howto.html/ item name=Security Mgr. HOW-TO href=security-manager-howto.html/ +item name=SSI Config HOW-TO href=ssi-howto.html/ item name=SSL Config HOW-TO href=ssl-howto.html/ /menu 1.1 jakarta-tomcat-4.0/webapps/tomcat-docs/jasper-howto.xml Index: jasper-howto.xml === ?xml version=1.0? !DOCTYPE document [ !ENTITY project SYSTEM project.xml ] document project; properties author email=[EMAIL PROTECTED]Glenn L. Nielsen/author titleJasper 2 JSP Engine How To/title /properties body section name=Table of Contents p a href=#IntroductionIntroduction/abr / a href=#UpgradingUpgrading/abr / a href=#ConfigurationConfiguration/abr / a href=#Production ConfigurationProduction Configuration/abr / a href=#Using JikesUsing Jikes/abr / /p /section section name=Introduction pStarting with Tomcat 4.1, Tomcat uses the Jasper 2 JSP Engine to implement the a href=http://java.sun.com/products/jsp/;JavaServer Pages 1.2/a specification./p pJasper 2 has been redesigned to significantly improve performance over the orignal Jasper. In addition to general code improvements the following changes were made: ul listrongJSP Custom Tag Pooling/strong - The java objects instantiated for JSP Custom Tags can
