jsp-config (Sun Java System Web Server 6.1 SP7 Programmer's Guide to Web Applications)

Sun Java System Web Server 6.1 SP7 Programmer's Guide to Web Applications

jsp-config

Specifies JSP configuration information.

Subelements

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
name	zero or more	Specifies a property.

Attributes

none

Properties

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 Compiling JSPs: The Command-Line Compiler
`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>