Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer's Guide

- Previous: sun-appserv-admin
- Next: sun-appserv-update

## sun-appserv-jspc

Precompiles JSP source code into Application Server compatible Java code for initial invocation by Application Server. Use this task to speed up access to JSP files or to check the syntax of JSP source code. You can feed the resulting Java code to the `javac` task to generate class files for the JSP files.

### Subelements

none

### Attributes

The following table describes attributes for the `sun-appserv-jspc` task.

Table 3–12 `sun-appserv-jspc` Attributes

Attribute | Default | Description
--- | --- | ---
`destdir` |  | The destination directory for the generated Java source files.
`srcdir` |  | (exactly one of these is required: `srcdir` or `webapp`) The source directory where the JSP files are located.
`webapp` |  | (exactly one of these is required: `srcdir` or `webapp`) The directory containing the web application. All JSP files within the directory are recursively parsed. The base directory must have a `WEB-INF` subdirectory beneath it. When `webapp` is used, `sun-appserv-jspc` hands off all dependency checking to the compiler.
`verbose` | `2` | (optional) The verbosity integer to be passed to the compiler.
`classpath` |  | (optional) The classpath for running the JSP compiler.
`classpathref` |  | (optional) A reference to the JSP compiler classpath.
`uribase` | `/` | (optional) The URI context of relative URI references in the JSP files. If this context does not exist, it is derived from the location of the JSP file relative to the declared or derived value of `uriroot`. Only pages translated from an explicitly declared JSP file are affected.
`uriroot` | see description | (optional) The root directory of the web application, against which URI files are resolved. If this directory is not specified, the first JSP file is used to derive it: each parent directory of the first JSP file is searched for a `WEB-INF` directory, and the directory closest to the JSP file that has one is used. If no `WEB-INF` directory is found, the directory `sun-appserv-jspc` was called from is used. Only pages translated from an explicitly declared JSP file (including tag libraries) are affected.
`package` |  | (optional) The destination package for the generated Java classes.
`asinstalldir` | see description | (optional) The installation directory for the local Application Server installation, which is used to find the administrative classes. If not specified, the command checks to see if the `asinstalldir` parameter has been set. Otherwise, administrative classes must be in the system classpath.
`sunonehome` | see description | (optional) Deprecated. Use `asinstalldir` instead.

### Example

The following example uses the `webapp` attribute to generate Java source files from JSP files. The `sun-appserv-jspc` task is immediately followed by a `javac` task, which compiles the generated Java files into class files. The `classpath` value in the `javac` task must be all on one line with no spaces.

    <sun-appserv-jspc
     destdir="${assemble.war}/generated"
     webapp="${assemble.war}"
     classpath="${assemble.war}/WEB-INF/classes"
     asinstalldir="${asinstalldir}" />
    <javac
     srcdir="${assemble.war}/WEB-INF/generated"
     destdir="${assemble.war}/WEB-INF/generated"
     debug="on"
     classpath="${assemble.war}/WEB-INF/classes:${asinstalldir}/lib/
       appserv-rt.jar:${asinstalldir}/lib/appserv-ext.jar">
     <include name="**/*.java"/>
    </javac>

- Previous: sun-appserv-admin
- Next: sun-appserv-update

- © 2010, Oracle Corporation and/or its affiliates