sun-web.xml Visual Editor: General

See Also 

The sun-web.xml visual editor lets you edit the platform-specific web deployment descriptor for the Sun Java System Application Server. You open the visual editor by expanding your project's Configuration Files node in the Projects window and double-clicking the sun-web.xml file. A Web application only contains a sun-web.xml deployment descriptor if its target server is the Sun Java System Application Server.

In the General tab of the wizard, you can set the context root, additional classpath, and JSP configuration properties for the Web application.

Context Root

The context root is the base directory of the WAR file. The Servlet Context uses the context root to resolve the path to the WAR file. The URL to a JSP page or servlet takes this form:

 hostname:port/contextRoot/relative_URLs_in_WAR_file

Error URL

Optionally specifies a redirect URL in case of an error.

JSP Configuration Properties

In JSP Configuration Properties, you can add or delete the predefined properties for the Web module's JSP pages.

The following table lists the JSP configuration properties. The first column lists the name of the property and the second column provides a description of the property and the default value for the property wherever applicable.

Name Value
checkInterval If development is false and reloading is true, background compiles are enabled. checkInterval is the time in seconds between checks to see if a JSP page needs to be recompiled. The default value in seconds in 300.
compiler The compiler Ant should use to compile the JSP page. See Ant documentation for more information. The default compiler is javac.
classdebuginfo The flag that specifies whether the generated Java servlets should be compiled with the debug option set (-g for javac).
classpath The classpath that will be passed to the Java compiler when it is invoked to compile the generated servlet to a class file. The classpath is created dynamically based on the current web application.
development Check if Jasper is used in the development mode. The default value is true.
enablePooling Determines whether tag handler pooling is enabled. The default value is true.
fork If true, Ant forks the compilation of JSP pages so that a separate JVM is used for JSP page compilation from the one that is running the application server. The default value is true.
ieClassId The Java plugin COM class ID for Internet Explorer. Its value is used by the <jsp:plugin> tags.
javaEncoding 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 more information on encodings, see:
keepgenerated The flag that specifies whether the generated Java servlet sources for each page should be kept or deleted. If set to true, the generated Java files are kept. If false, the Java files are deleted. By default, the java code is not deleted in order to aid debugging.
logVerbosityLevel Log the level of detailed messages to be produced by the servlet. Increasing levels cause the generation of more messages. Valid values are FATAL, ERROR, WARNING, INFORMATION, and DEBUG. The default value is WARNING.
mappedfile The flag that specifies whether the container should generate static content with one print statement per input line. If set to true, generates separate write calls for each HTML line and adds comments that describe the location of each line in the JSP page. By default, all adjacent write calls are combined and no location comments are generated.
reloading Specifies if Jasper should check for modified JSP pages. The default value is true.
suppressSmap Specifies if the SMAP info for JSR45 debugging be suppressed. The default value is false.
dumpSmpa Specifies if the SMAP information for JSR45 debugging be dumped to a file. The default value is true.
scratchdir The working directory to use when compiling JSP pages. It also stores all the generated code.
tagPoolMaxSize Specify the tag handler pool size.
xpoweredBy Determines whether the X-Powered-By response header is added by generated servlet.

Properties

In Properties, you can add or delete the predefined properties for the Web module's JSP pages.

The following table lists the available JSP properties. The first column lists the name of the property and the second column provides a description of the property and the default value for the property wherever applicable:
Name Value
crossContextAllowed Set this property to true or false.  When set to true, the Web application is allowed to access other Web application contexts.
tempdir The temporary directory for use by this web module. This value is used to construct the value of the javax.servlet.context.tempdir context attribute. Compiled JSP pages are also placed in this directory.
singleThreadedServletPoolSize The number of threads in the thread pool for single threaded servlets.
See Also
About Deployment Descriptors
Editing a Web Application's Deployment Descriptors
Changing the Target Server
sun-web.xml Visual Editor:
         Session
         Messages
         Locale
         Cache
         Web Service Descriptor

Legal Notices