jspc [options] jsp_files
jspc [options] -webapp dir
Use the jspc command to compile your JSP 2.1 compliant source files into servlets. To allow the Communications Server to pick up the precompiled JSP pages from a JAR file, specify the -compile, and one of -webinc and -webxml options, which cause the JSP pages to be mapped to their corresponding servlet class files. This means that the JSP compiler will be bypassed when those JSPs are accessed.
One or more JSP files to be compiled.
A directory containing a web application. All JSPs in the directory and its subdirectories are compiled. You cannot specify a WAR, JAR, or ZIP file; you must first deploy it to an open directory structure using asadmin deploy.
Print a summary of the syntax and options for this command.
Enables verbose mode.
The output directory for the compiled JSPs. Package directories are automatically generated based on the directories containing the uncompiled JSPs. The default directory is the directory specified by the java.io.tmpdir property, or the current directory if java.io.tmpdir is not defined.
Outputs the name of the JSP page upon failure.
Outputs the name of the JSP page upon success.
The name of the target package for all specified JSPs, which is prepended to the package component derived from the directory in which the JSP pages are located. The default is org.apache.jsp.
The target class name of the JSP compiled first. Subsequent JSPs are unaffected. This option is useful only with the files file specifier.
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.
Causes the JVM to exit and generates an error return code if a fatal error occurs. If the code is absent or unparsable it defaults to 1.
The URI directory to which compilations are relative. Applies only to JSP files listed in the command, and not to JSP files specified with -webapp option. This is the location of each JSP file relative to the uriroot. If this cannot be determined, the default is /.
The root directory against which URI files are resolved. Applies only to JSP files listed in the command, and not to JSP files specified with -webapp option. If this option is not specified, all parent directories of the first JSP page are searched for a WEB-INF subdirectory. The closest directory to the JSP page that has one is used. If none of the JSP's parent directories have a WEB-INF subdirectory, the directory from which jspc is invoked is used.
Compiles the generated servlets.
Identical to the -compile option.
Creates partial servlet mappings for the -webapp option, which can be pasted into a web.xml file.
Creates an entire web.xml file for the -webapp option.
Specifies the Java plugin COM class ID for Internet Explorer. Used by the jsp:plugin tags.
Override the system classpath with the specified classpath.
Adds an X-Powered-By HTTP response header.
Trim spaces in template text between actions and directives.
Generates SMAP information for JSR45 debugging.
Dumps SMAP information for JSR45 debugging into a file.
Validates .tld and web.xml files against their schemas and DTDs.
Provides source compatibility with the specified JDK release (in the same way as the javac command-line switch -source. This option is provided for backward compatibility with older JDK releases. For example, if a JSP page declares the scriptlet variable <% java.util.Enumeration enum; %>. The value for release must be 1.3, 1.4, 1.5 or 5. This is in order for the generated servlet to compile successfully, because enum has been a reserved keyword since JDK 1.5.
Generates class files for the specified VM version. This option works the same way as javac command-line switch -target. The value for release must be one of the following: 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 5, or 6.
The following command compiles a set of JSP files into Java source files under /home/user/Hellodir:
jspc welcome.jsp shop.jsp checkout.jsp -d /home/user/Hellodir
The following command compiles all the JSP files in the specified webapp into class files under /home/user/Hellodir:
jspc -webapp /path_to_source_directory -compile -d /home/user/Hellodir
The following command compiles a set of JSP files into Java class files in /home/user/Hellodir with the package name com.test.jsp prepended to the package hierarchy found in /path_to_source_directory. It creates web.xml in the output directory.
jspc -webapp /path_to_source_directory -compile -webxml /home/user/Hellodir/web.xml -d /home/user/Hellodir -p com.test.jsp
To use these precompiled JSP pages in your web application, package the servlet class files generated under /home/user/Hellodir into a JAR file, place the JAR file under WEB-INF/lib, and copy the generated /home/user/Hellodir/web.xml to WEB-INF/web.xml.