jetty-jspc:jspc

Full name:

org.mortbay.jetty:maven-jetty-jspc-plugin:6.1.20:jspc

Description:

This goal will compile jsps for a webapp so that they can be included in a war.

At runtime, the plugin will use the jsp2.0 jspc compiler if you are running on a 1.4 or lower jvm. If you are using a 1.5 jvm, then the jsp2.1 compiler will be selected. (this is the same behaviour as the jetty plugin for executing webapps).

Note that the same java compiler will be used as for on-the-fly compiled jsps, which will be the Eclipse java compiler.

See Usage Guide for instructions on using this plugin.

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Requires dependency resolution of artifacts in scope: compile.
  • Binds by default to the lifecycle phase: process-classes.

Required Parameters

Name Type Since Description
webAppSourceDirectory String - Root directory for all html/jsp etc files

Optional Parameters

Name Type Since Description
classesDirectory File - The location of the compiled classes for the webapp
excludes String - The comma separated list of file name patters to exclude from compilation.
generatedClasses String - The destination directory into which to put the compiled jsps.
ignoreJspFragmentErrors boolean - Whether or not to ignore precompilation errors caused by jsp fragments.
includes String - The comma separated list of patterns for file extensions to be processed. By default will include all .jsp and .jspx files. Default value is: **/*.jsp, **/*.jspx.
insertionMarker String - Optional. A marker string in the src web.xml file which indicates where to merge in the generated web.xml fragment. Note that the marker string will NOT be preserved during the insertion. Can be left blank, in which case the generated fragment is inserted just before the </web-app> line
javaEncoding String - The encoding scheme to use.
keepSources boolean - Controls whether or not .java files generated during compilation will be preserved.
mergeFragment boolean - Merge the generated fragment file with the web.xml from webAppSourceDirectory. The merged file will go into the same directory as the webXmlFragment.
packageRoot String - Default root package for all generated classes
schemaResourcePrefix String - Allows a prefix to be appended to the standard schema locations so that they can be loaded from elsewhere.
suppressSmap boolean - Whether or not to generate JSR45 compliant debug info
validateXml boolean - If true, validates tlds when parsing.
verbose boolean - Whether or not to output more verbose messages during compilation.
webXmlFragment String - File into which to generate the <servlet> and <servlet-mapping> tags for the compiled jsps

Parameter Details

classesDirectory :

The location of the compiled classes for the webapp

  • Type: java.io.File
  • Required: No
  • Expression: ${project.build.outputDirectory}

excludes :

The comma separated list of file name patters to exclude from compilation.

  • Type: java.lang.String
  • Required: No

generatedClasses :

The destination directory into which to put the compiled jsps.

  • Type: java.lang.String
  • Required: No
  • Expression: ${project.build.outputDirectory}

ignoreJspFragmentErrors :

Whether or not to ignore precompilation errors caused by jsp fragments.

  • Type: boolean
  • Required: No
  • Expression: false

includes :

The comma separated list of patterns for file extensions to be processed. By default will include all .jsp and .jspx files.

  • Type: java.lang.String
  • Required: No
  • Default: **/*.jsp, **/*.jspx

insertionMarker :

Optional. A marker string in the src web.xml file which indicates where to merge in the generated web.xml fragment. Note that the marker string will NOT be preserved during the insertion. Can be left blank, in which case the generated fragment is inserted just before the </web-app> line

  • Type: java.lang.String
  • Required: No

javaEncoding :

The encoding scheme to use.

  • Type: java.lang.String
  • Required: No
  • Expression: UTF-8

keepSources :

Controls whether or not .java files generated during compilation will be preserved.

  • Type: boolean
  • Required: No
  • Expression: false

mergeFragment :

Merge the generated fragment file with the web.xml from webAppSourceDirectory. The merged file will go into the same directory as the webXmlFragment.

  • Type: boolean
  • Required: No
  • Expression: true

packageRoot :

Default root package for all generated classes

  • Type: java.lang.String
  • Required: No
  • Expression: jsp

schemaResourcePrefix :

Allows a prefix to be appended to the standard schema locations so that they can be loaded from elsewhere.

  • Type: java.lang.String
  • Required: No

suppressSmap :

Whether or not to generate JSR45 compliant debug info

  • Type: boolean
  • Required: No
  • Expression: true

validateXml :

If true, validates tlds when parsing.

  • Type: boolean
  • Required: No
  • Expression: false

verbose :

Whether or not to output more verbose messages during compilation.

  • Type: boolean
  • Required: No
  • Expression: false

webAppSourceDirectory :

Root directory for all html/jsp etc files

  • Type: java.lang.String
  • Required: Yes
  • Expression: ${basedir}/src/main/webapp

webXmlFragment :

File into which to generate the <servlet> and <servlet-mapping> tags for the compiled jsps

  • Type: java.lang.String
  • Required: No
  • Expression: ${basedir}/target/webfrag.xml