Sun Java System Web Server 7.0 Update 2 Developer's Guide to Java Web Applications

jsp-config Element

This element specifies JSP configuration information that enables web application to customize the compilation and execution of its JSP files.

Subelement

The following table describes the name subelement for the jsp-config element.

Table A–44 jsp-config Subelements

Element  

Required  

Description  

name Element

zero or more 

Specifies a property. 

Attributes

none

Properties

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

Table A–45 jsp-config Properties

Property Name  

Default Value  

Description  

ieClassId

clsid:8AD9C840-

044E-11D1-B3E9-

00805F499D93

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

javaCompilerPlugin

internal JDK compiler (javac)

This property is deprecated in this release. By this, we mean this is supported in 7.0 but will NOT be supported in future release 

If JSP Pages import classes from unnamed packages, the default-JDK compiler will throw a compile time error when JSP- generated servlets are compiled. To compile JSP- generated servlets, set the javaCompilerPlugin property to org.apache.jasper.compiler.SunJavaCompiler. Note: The jspc command-line compiler for JSPs no longer supports -javac option. Since this property is deprecated, you are strongly encouraged to modify JSPs so that the imported classes have a package name.

See also the -deprecatedjavac switch of jspc, described in Compiling JSPs Using the Command-Line Compiler.

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 tries to use the javaEncoding value.

For encodings you can use, see:  

http://java.sun.com/j2se/1.5.0/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.

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 (see the following example). 

The following example illustrates the use of the initial-capacity property described in the table above. The example shows how you would configure a value of 1024:

<jsp-config> <property name=”initial-capacity” value=”1024” /></jsp-config>