“提供用于编译 JavaServer Pages 的选项”设置

使用此页面来指定 JavaServer Pages（JSP）编译器要使用的选项。

此管理控制台页面是应用程序安装和更新向导中的一个步骤。要查看此页面，必须在选择安装选项页面上选择预编译 JavaServer Pages 文件。因此，要查看此页面，请单击应用程序 > 新建应用程序 > 新建企业应用程序 > application_path > 下一步 > 详细 - 显示所有安装选项和参数 > 下一步 > 下一步或继续 > 预编译 JavaServer Pages 文件 > 下一步 > 步骤：提供用于编译 JSP 的选项。

仅当正在安装或更新包含 Web 模块的应用程序时，才能在此页面上指定 JSP 编译器选项。安装应用程序后，必须编辑 Web 模块的 WEB-INF/ibm-web-ext.xmi 文件中的 JSP 引擎配置参数，以更改它的 JSP 编译器选项。

支持的配置：对于 IBM® 扩展文件和绑定文件，根据您使用的是 Java EE 5 之前的应用程序或模块还是 Java EE 5 或之后的应用程序或模块，.xmi 或 .xml 文件扩展名有所不同。IBM 扩展文件或绑定文件将命名为 ibm-*-ext.xmi 或 ibm-*-bnd.xmi，其中 * 是扩展文件或绑定文件的类型，例如，app、application、ejb-jar 或 web。存在下列条件：

对于使用 V5 之前的 Java EE 版本的应用程序或模块，文件扩展名必须是 .xmi。
对于使用 Java EE 5 或更高版本的应用程序或模块，文件扩展名必须是 .xml。如果应用程序或模块中包含 .xmi 文件，那么产品将忽略这些 .xmi 文件。

然而，Java EE 5 或更高版本的模块可以在包含 Java EE 5 之前的文件并使用 .xmi 文件扩展名的应用程序中存在。

ibm-webservices-ext.xmi、ibm-webservices-bnd.xmi、ibm-webservicesclient-bnd.xmi、ibm-webservicesclient-ext.xmi 和 ibm-portlet-ext.xmi 文件继续使用 .xmi 文件扩展名。

sptcfg

Web 模块

指定应用程序中模块的名称。

URI

指定模块相对于应用程序（EAR 文件）根的位置。

JSP 类路径

指定 JSP 编译器在应用程序安装期间编译 JSP 文件时要使用的临时类路径。应用程序安装完成后不会保存此类路径，运行应用程序时也不会使用此路径。此类路径仅用于标识应用程序外部进行 JSP 编译所必需的资源，在安装应用程序完成后，将通过其他方法（例如共享库）来标识这些资源。在 Network Deployment 配置中，此类路径是特定于 Deployment Manager 机器的。

要指定多个 Web 模块使用同一个类路径：

在 Web 模块列表中，对于每个要使用特定类路径的 Web 模块，选中该模块旁边的选择复选框。
展开应用多个映射。
指定要使用的类路径。
单击应用。

使用完整包名

指定 JSP 引擎是否使用完整包名来生成和装入 JSP 类。

使用完整包名时，可以在 web.xml 文件中将预编译的 JSP 类文件配置为 Servlet，而不必使用 jsp-file 属性。未使用完整包名时，所有 JSP 类都将在同一个包中生成，其优点在于文件系统路径较小。

当 useFullPackageNames 和 disableJspRuntimeCompilation 选项都为 true 时，将使用单个类装入器来装入所有 JSP 类，即使未在 web.xml 文件中将 JSP 文件配置为 Servlet 亦如此。

此选项与 useFullPackageNames JSP 引擎参数相同。

JDK 源代码级别

[2013 年 3 月更新] 指定 Java 编译器编译 JSP Java 源代码时使用的源代码级别。有效值为 13、14、15、16 和 17。对于 Java EE 5 之前的 Web 模块，缺省值为 13，它指定源代码级别 1.3；对于 Java EE 5 和更高版本的 Web 模块，缺省值为 16。 [2013 年 3 月更新]

禁用 JSP 运行时编译

指定在运行时是否不应该转换或编译 JSP 文件，即使在不存在 .class 文件时亦如此。

当此选项设置为 true 时，JSP 引擎在运行时不转换和编译 JSP 文件； JSP 引擎仅装入预编译的类文件。装入类文件时，不要求 JSP 源文件已存在。您可以安装不带 JSP 源文件的应用程序，但该应用程序必须带有已进行预编译的类文件。

要让单个 Web 应用程序类装入器装入所有 JSP 类，必须将此编译器选项和使用完整包名选项都设置为 true。

此选项与 disableJspRuntimeCompilation JSP 引擎参数相同。

文件名： uweb_jspcompile.html