JSP elements are as follows:
Specifies JSP configuration information.
The following table describes subelements for the jsp-config element. The left column lists the subelement name, the middle column indicates the requirement rule, and the right column describes what the element does.
Table 6–41 jsp-config Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property. |
none
The following table describes properties for the jsp-config element. The left column lists the property name, the middle column indicates the default value, and the right column describes what the property does.
Table 6–42 jsp-config Properties
Property Name |
Default Value |
Description |
---|---|---|
ieClassId |
clsid:8AD9C840-044E-11D1-B3E9-00805F499D93 |
The Java plugin COM class ID for Internet Explorer. Used by the <jsp:plugin> tags. |
javaCompilerPlugin |
internal JDK compiler (javac) |
The fully qualified class name of the Java compiler plugin to be used. Not needed for the default compiler. For example, to use the jikes compiler for JSP pages, set the javaCompilerPlugin property to org.apache.jasper.compiler.JikesJavaCompiler, then set the javaCompilerPath property to point to the jikes executable. To use sun.tools.javac.Main to compile JSP-generated servlets, set the javaCompilerPlugin property to org.apache.jasper.compiler.SunJavaCompiler (see also the -deprecatedjavac switch of jspc, described in |
javaCompilerPath |
none |
Specifies the path to the executable of an out-of-process Java compiler such as jikes. Ignored for the default compiler. It is required only if the javaCompilerPlugin property is specified. |
javaEncoding |
UTF8 |
Specifies the encoding for the generated Java servlet. This encoding is passed to the Java compiler used to compile the servlet as well. By default, the web container tries to use UTF8. If that fails, it uses the javaEncoding value. For encodings, see: http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html |
classdebuginfo |
false |
Specifies whether the generated Java servlets should be compiled with the debug option set (-g for javac). |
keepgenerated |
true |
If set to true, keeps the generated Java files. If false, deletes the Java files. |
largefile |
false |
If set to true, static HTML is stored in a separate data file when a JSP is compiled. This is useful when a JSP is very large, because it minimizes the size of the generated servlet. |
mappedfile |
false |
If set to true, generates separate write calls for each HTML line and comments that describe the location of each line in the JSP file. By default, all adjacent write calls are combined and no location comments are generated. |
scratchdir |
default work directory for the web application |
The working directory created for storing all of the generated code. |
reload-interval |
0 |
Specifies the frequency (in seconds) at which JSP files are checked for modifications. Setting this value to 0 checks JSPs for modifications on every request. Setting this value to -1 disables checks for JSP modifications and JSP recompilation. |
initial-capacity |
32 |
Specifies the initial size of the hash table of compiled JSP classes. |
The following example illustrates the use of the initial-capacity property described in the table above. The example shows how you can configure a value of 1024:
<jsp-config> <property name=”initial-capacity” value=”1024” > </jsp-config>