Subelements

Properties

The default property values are tuned for development of JSP
files at the cost of performance. To maximize performance, set jsp-config properties to these non-default values:

development - false (as
an alternative, set to true and give modificationTestInterval a large value)

mappedfile - false

trimSpaces - true

suppressSmap - true

fork - false (on
Solaris)

classdebuginfo - false

The following table describes properties for the jsp-config element.

Table A–54 jsp-config Properties

Property

Default

Description

checkInterval

0

If development is set to false and checkInterval is greater than zero, background compilations
are enabled. The checkInterval is the time in seconds
between checks to see if a JSP file needs to be recompiled.

classdebuginfo

true

Specifies whether the generated Java servlets are compiled with
the debug option set (-g for javac).

classpath

created dynamically based on the current web application

Specifies the classpath to use when compiling generated servlets.

compiler

javac

Specifies the compiler Ant uses to compile JSP files. See the
Ant documentation for more information:

If set to true, enables development mode,
which allows JSP files to be checked for modification. Specify the
frequency at which JSPs are checked using the modificationTestInterval property.

dumpSmap

false

If set to true, dumps SMAP information for
JSR 45 debugging to a file. Set to false if suppressSmap is true.

enablePooling

true

If set to true, tag handler pooling is enabled.

errorOnUseBeanInvalidClassAttribute

false

If set to true, issues an error when the
value of the class attribute in a useBean action
is not a valid bean class.

fork

true

Specifies that Ant forks the compiling of JSP files, using a
JVM separate from the one in which Tomcat is running.

genStrAsCharArray

false

If set to true, generates text strings as char arrays, which improves performance in some cases.

ieClassId

clsid:8AD9C840-044E-11D1-B3E9-00805F499D93

Specifies the Java plug-in COM class ID for Internet Explorer.
Used by the <jsp:plugin> tags.

javaEncoding

UTF8

Specifies the encoding for the generated Java servlet. This encoding
is passed to the Java compiler that is used to compile the servlet
as well. By default, the web container tries to use UTF8.
If that fails, it tries to use the javaEncoding value.