2.2.4 jspc

Synopsis

jspc OPTION [--] jsp_files

    OPTION:
    [-webapp dir]
    [-help]
    [-v={false|true}]
    [-d dir]
    [-l={false|true}]
    [-s={false|true}]
    [-p name]
    [-c name]
    [-mapped={false|true}]
    [-die[#]]
    [-uribase dir]
    [-uriroot dir]
    [-compile={false|true}]
    [-genclass={false|true}]
    [-webinc file]
    [-webxml file]
    [-classpath path]
    [-xpoweredBy={false|true}]
    [-trimSpaces={false|true}]
    [-smap={false|true}]
    [-dumpsmap={false|true}]
    [-validate={false|true}]
    [-compilerSourceVM jdk_release]
    [-compilerTargetVM jdk_release]
    [-ignoreJspFragmentErrors={false|true}]
    [-disablePooling={false|true}]

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The jspc command line tool allows you to precompile JSP files at the command line.

JSP files are automatically compiled at runtime.

Execution permission

Superuser

Files

This tool takes .jsp files as input and generates servlet files.

Arguments

jsp files

Specifies a file to be parsed as a JSP page.

Type: String

The following values can be specified:

• Name of the file

Default value: N/A

-webapp dir

Specifies a directory containing a web-app, whose JSP pages will be processed recursively.

Type: String

The following values can be specified:

• Directory path containing web-app

Default value: N/A

-help

Prints this help message.

-v={false|true}

Displays detailed information.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-d dir

Specifies the output Directory (default -Djava.io.tmpdir).

Type: String

The following values can be specified:

• Directory to place the output files

Default value: -Djava.io.tmpdir

-l={false|true}

Outputs the name of the JSP page upon failure.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-s={false|true}

Outputs the name of the JSP page upon success.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-p name

Specifies the name of the target package (The default value is org.apache.jsp).

Type: String

The following values can be specified:

• Name of the package

Default value: org.apache.jsp

-c name

Specifies the name of the target class name (only applies to first JSP page).

Type: String

The following values can be specified:

• Name of the target class name

Default value: N/A

-mapped={false|true}

Generates separate write() calls for each HTML line in the JSP.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-die[#]

Generates an error return code (#) on fatal errors (default 1).

Default value: 1

-uribase dir

Indicates that the uri directory compilations should be relative to (default /).

Type: String

The following values can be specified:

• Directory name

Default value: /

-uriroot dir

Specifies the directory containing a web-app, whose JSP pages will be processed recursively.

Type: String

The following values can be specified:

• Directory name

Default value: N/A

-compile={false|true}

Compiles generated servlets.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-genclass={false|true}

Compiles generated servlets.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-webinc file

Creates partial servlet mappings in the file.

Type: String

The following values can be specified:

• Filename with path

Default value: N/A

-webxml file

Creates a complete web.xml in the file.

Type: String

The following values can be specified:

• Web-app name

Default value: N/A

-classpath path

Appends the path to java.class.path system property.

Type: String

The following values can be specified:

• Classpath

Default value: N/A

-xpoweredBy={false|true}

Adds an X-Powered-By response header.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-trimSpaces={false|true}

Trims the spaces in the template text between actions and directives.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-smap={false|true}

Generates SMAP information for JSR45 debugging.

Type: Boolean

The following values can be specified:

• true

• false

Default value: true

-dumpsmap={false|true}

Dumps the SMAP information for JSR45 debugging into a file.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-validate={false|true}

Validates the .tld and web.xml files against their schemas and dtds.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-compilerSourceVM jdk_release

Provides source compatibility with the specified JDK release.

Type: float

The following values can be specified:

• JDK releases

Default value: N/A

-compilerTargetVM jdk_release

Generates the class files for the specified VM version.

Type: float

The following values can be specified:

• JDK releases

Default value: N/A

-ignoreJspFragmentErrors={false|true}

Ignores the compilation errors of JSP fragments.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

-disablePooling={false|true}

Disables the custom tag pooling.

Type: Boolean

The following values can be specified:

• true

• false

Default value: true

Exit Status

Exit Status	Explanation
0	subcommand executed successfully.
1	error in executing the subcommand.