You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by pe...@apache.org on 2006/01/13 11:06:27 UTC
svn commit: r368665 - in /tomcat/container/tc5.5.x/webapps/docs:
changelog.xml jasper-howto.xml
Author: pero
Date: Fri Jan 13 02:06:24 2006
New Revision: 368665
URL: http://svn.apache.org/viewcvs?rev=368665&view=rev
Log:
fix typo and add some useful hints!
Modified:
tomcat/container/tc5.5.x/webapps/docs/changelog.xml
tomcat/container/tc5.5.x/webapps/docs/jasper-howto.xml
Modified: tomcat/container/tc5.5.x/webapps/docs/changelog.xml
URL: http://svn.apache.org/viewcvs/tomcat/container/tc5.5.x/webapps/docs/changelog.xml?rev=368665&r1=368664&r2=368665&view=diff
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/changelog.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/changelog.xml Fri Jan 13 02:06:24 2006
@@ -49,6 +49,12 @@
</fix>
</changelog>
</subsection>
+ <subsection name="Jasper">
+ <changelog>
+ <update>
+ Add some useful hints to jasper-howto. (pero).
+ </update>
+ </subsection>
<subsection name="Cluster">
<changelog>
<add>
Modified: tomcat/container/tc5.5.x/webapps/docs/jasper-howto.xml
URL: http://svn.apache.org/viewcvs/tomcat/container/tc5.5.x/webapps/docs/jasper-howto.xml?rev=368665&r1=368664&r2=368665&view=diff
==============================================================================
--- tomcat/container/tc5.5.x/webapps/docs/jasper-howto.xml (original)
+++ tomcat/container/tc5.5.x/webapps/docs/jasper-howto.xml Fri Jan 13 02:06:24 2006
@@ -8,6 +8,7 @@
<properties>
<author email="glenn@apache.org">Glenn L. Nielsen</author>
+ <author email="peron@apache.org">Peter Rossbach</author>
<title>Jasper 2 JSP Engine How To</title>
</properties>
@@ -115,7 +116,7 @@
<li><strong>javaEncoding</strong> - Java file encoding to use for generating
java source files. Default <code>UTF8</code>.</li>
-<li><strong>genStrAsCharArray</strong> - Should text strings be generated as char
+<li><strong>genStringAsCharArray</strong> - Should text strings be generated as char
arrays, to improve performance in some cases? Default <code>false</code>.</li>
<li><strong>keepgenerated</strong> - Should we keep the generated Java source
@@ -169,7 +170,7 @@
<ul>
<li><strong>development</strong> - To disable on access checks for JSP
pages compilation set this to <code>false</code>.</li>
-<li><strong>genStrAsCharArray</strong> - To generate slightly more efficient
+<li><strong>genStringAsCharArray</strong> - To generate slightly more efficient
char arrays, set this to <code>true</code>.</li>
<li><strong>modificationTestInterval</strong> - If development has to be set to
<code>true</code> for any reason (such as dynamic generation of JSPs), setting
@@ -253,6 +254,13 @@
<target name="all" depends="jspc,compile">
</target>
+ <target name="cleanup">
+ <delete>
+ <fileset dir="${webapp.path}/WEB-INF/src"/>
+ <fileset dir="${webapp.path}/WEB-INF/classes/org/apache/jsp"/>
+ </delete>
+ </target>
+
</project>
</source>
</p>
@@ -279,6 +287,33 @@
are automatically compiled as part of the build process.
</p>
+<p>
+At the jasper2 task you can use the option <code>addWebXmlMappings</code> for
+automatic merge the <code>${webapp.path}/WEB-INF/generated_web.xml</code>
+with the current web application deployment descriptor at <code>${webapp.path}/WEB-INF/web.xml</code>.
+When you want to use Java 5 feature inside your jsp's, add the following javac compiler task
+attributes: <code>source="1.5" target="1.5"</code>. For live application
+you can also compile with <code>optimize="on"</code> and without debug info
+<code>debug="off"</code>.
+</p>
+
+<p>
+When you don't want to stop the jsp generation at first jsp syntax error, use
+<code>failOnError="false"</code>and with <code>showSuccess="true"</code>
+all successfull <i>jsp to java</i> generation are printed out. Sometimes it is
+very helpfull, when you cleanup the generate java source files at <code>${webapp.path}/WEB-INF/src</code>
+and the compile jsp servlet classes at <code>${webapp.path}/WEB-INF/classes/org/apache/jsp</code>.
+</p>
+
+<p><strong>Hints:</strong>
+<ul>
+<li> When you switch to another tomcat release, then regenerate and recompile
+your jsp's with this version again!</li>
+<li>Use java system property at server runtime to disable tag pooling <code>org.apache.jasper.runtime.JspFactoryImpl.USE_POOL=false</code>.
+and limit the buffering with <code>org.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true</code>. Note that changing
+from the defaults may affect performance, but depending on the application.</li>
+</ul>
+</p>
</section>
<section name="Using Jikes">
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org