Provide options to compile JavaServer Pages settings
Use this page to specify options to be used by the JavaServer Pages (JSP) compiler.
This administrative console page is a step in the application installation and update wizards. To view this page, you must select Precompile JavaServer Pages files on the Select installations options page. Thus, to view this page, click or .
You can specify the JSP compiler options on this page only when installing or updating an application that contains web modules. After the application is installed, you must edit the JSP engine configuration parameters of a web module WEB-INF/ibm-web-ext.xmi file to change its JSP compiler options.
However, a Java EE 5 or later module can exist within an application that includes pre-Java EE 5 files and uses the .xmi file name extension.
The ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, and ibm-portlet-ext.xmi files continue to use the .xmi file extensions.
Web module
Specifies the name of a module within the application.
URI
Specifies the location of the module relative to the root of the application (EAR file).
JSP class path
Specifies a temporary class path for the JSP compiler to use when compiling JSP files during application installation. This class path is not saved when the application installation is complete and is not used when the application is running. This class path is used only to identify resources outside of the application which are necessary for JSP compilation and which will be identified by other means (such as shared libraries) after the application is installed. In network deployment configurations, this class path is specific to the deployment manager machine.
To specify that multiple web modules use the same class path:
- In the list of web modules, select the Select check box for each web module that you want to use a particular class path.
- Expand Apply Multiple Mappings.
- Specify the desired class path.
- Click Apply.
Use full package names
Specifies whether the JSP engine generates and loads JSP classes using full package names.
When full package names are used, precompiled JSP class files can
be configured as servlets in the web.xml file,
without having to use the jsp-file
attribute. When
full package names are not used, all JSP classes are generated in
the same package, which has the benefit of smaller file-system paths.
When the options useFullPackageNames and disableJspRuntimeCompilation
are both true
, a single class loader is used to load
all JSP classes, even if the JSP files are not configured as servlets
in the web.xml
file.
This option is the same as the useFullPackageNames JSP engine parameter.
JDK source level
Specifies the source level at which the Java compiler compiles JSP Java
sources. Valid values are 13
, 14
,
15
,16
, and 17
. The default value is
13
for web modules, which specifies source level 1.3.
Disable JSP runtime compilation
Specifies whether a JSP file should never be translated
or compiled at run time, even when a .class
file
does not exist.
When this option is set to true
, the JSP engine
does not translate and compile JSP files at run time; the JSP engine
loads only precompiled class files. JSP source files do not need to
be present to load class files. You can install an application
without JSP source, but the application must have precompiled class
files.
For a single web application class loader to load all JSP classes,
this compiler option and the Use full package names option
both must be set to true
.
This option is the same as the disableJspRuntimeCompilation JSP engine parameter.