配置 JSP 引擎参数

了解如何添加、更改或删除 JSP 引擎配置参数。

有关此任务

以下注意事项适用于本主题中带有 .xmi 扩展名的文件引用：

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

对于使用版本 5 之前的 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 文件扩展名。

WebSphere® Application Server 不支持通过管理控制台或通过管理脚本编制修改部署描述符扩展参数。

最佳实践: 使用组装工具 (例如 Rational Application Developer) 来修改 IBM 扩展和绑定文件。可以使用 IBM Bindings and Extensions Conversion Tool for Multi-Platforms 将模块中的扩展和绑定文件从 XMI 转换为 XML。

要添加、更改或删除 JSP 引擎配置参数，请完成下列步骤：

过程

打开 WEB-INF/ibm-web-ext.xmi 或 WEB-INF/ibm-web-ext.xml 文件。
JSP 引擎配置参数存储在 Web 模块的配置目录中，或存储在 Web 模块 binaries 目录的 WEB-INF/ibm-web-ext.xmi 或 WEB-INF/ibm-web-ext.xml 文件中。打开 WEB-INF/ibm-web-ext.xmi 或 WEB-INF/ibm-web-ext.xml 文件，其位于以下位置：
- 配置目录，如以下示例所示：
```
{WAS_ROOT}/profiles/profilename/config/cells/cellname/applications/enterpriseappname/deployments/deployedname/webmodulename
```
- 二进制文件目录 (如果应用程序已部署到 WebSphere Application Server 中，标志使用二进制配置设置为 true)。 binaries 目录的一个示例是:
```
{WAS_ROOT}/profiles/profilename/installedApps/nodename/EnterpriseAppName/WebModuleName/ 
```
JSP 引擎配置参数存储在 Web 模块的配置目录中，或存储在 Web 模块 binaries 目录的 WEB-INF/ibm-web-ext.xmi 或 WEB-INF/ibm-web-ext.xml 文件中。打开 WEB-INF/ibm-web-ext.xmi 或 WEB-INF/ibm-web-ext.xml 文件，其位于以下位置：
- 配置目录，如以下示例所示：
```
profile_root/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xmi
```
```
profile_root/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xml
```
- 二进制文件目录 (如果应用程序已部署到 WebSphere Application Server 中，标志使用二进制配置设置为 true)。二进制文件目录的示例如下：
```
profile_root/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xmi
```
```
profile_root/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xml
```
编辑 WEB-INF/ibm-web-ext.xmi 或 WEB-INF/ibm-web-ext.xml 文件。
- 要将配置参数添加至 WEB-INF/ibm-web-ext.xmi 文件，请使用以下格式：
```
xmi:id="JSPAttribute_6" name="parametername" value="parametervalue"/> 
```
- 要将配置参数添加至 WEB-INF/ibm-web-ext.xml 文件，请使用以下格式：
```
<jsp-attribute name="parametername" value="parametervalue"/>
```
- 要删除配置参数，删除文件中的行或将具有  标记的语句括起来。
保存该文件。
重新启动企业应用程序。没有必要重新启动服务器以使参数更改生效。
但是，某些 JSP 引擎配置参数会影响为 JSP 生成的 Java 源代码。如果更改这样的参数，那么您必须重新转换 Web 模块中的 JSP 文件以重新生成 Java 源代码。您可以使用批处理编译器重新转换 Web 模块中的所有 JSP 文件。批处理编译器使用您在 ibm-web-ext.xmi 或 ibm-web-ext.xml 文件中设置的 JSP 引擎配置参数，除非您明确地覆盖这些参数。主题 JSP 引擎配置参数标识影响生成的 Java 源的参数。

示例

以下是 WEB-INF/ibm-web-ext.xmi 文件的样本。文本为粗体的行是 JSP 引擎配置参数。

<?xml version="1.0" encoding="UTF-8"?>
<webappext:WebAppExtension xmi:version="2.0" xmlns:xmi=http://www.omg.org/XMI
   xmlns:webappext="webappext.xmi" xmlns:webapplication="webapplication.xmi" xmi:id="WebAppExtension_1"   
   reloadInterval="9" reloadingEnabled="true" defaultErrorPage="error.jsp" additionalClassPath="" 
   fileServingEnabled="true" directoryBrowsingEnabled="false" serveServletsByClassnameEnabled="true" 
   autoRequestEncoding="true" autoResponseEncoding="false">
   <webApp href="WEB-INF/web.xml#WebApp_1"/>
   <jspAttributes xmi:id="JSPAttribute_1" name="useThreadTagPool" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_2" name="verbose" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_3" name="deprecation" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_4" name="reloadEnabled" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_5" name="reloadInterval" value="5"/>
   <jspAttributes xmi:id="JSPAttribute_6" name="keepgenerated" value="true"/>
   <!--<jspAttributes xmi:id="JSPAttribute_7" name="trackDependencies" value="true"/> -->
   
</webappext:WebAppExtension>

以下是 WEB-INF/ibm-web-ext.xml 文件的样本。文本为粗体的行是 JSP 引擎配置参数。

<?xml version="1.0" encoding="UTF-8"?>
<web-ext
   xmlns="http://websphere.ibm.com/xml/ns/javaee"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd"
      version="1.0">

   <default-error-page uri="error.jsp"/>
   <jsp-attribute name="useThreadTagPool" value="true" />
   <jsp-attribute name="verbose" value="false" />
   <jsp-attribute name="deprecation" value="false" />
   <jsp-attribute name="reloadEnabled" value="true" />
   <jsp-attribute name="reloadInterval" value="5" />
   <jsp-attribute name="keepgenerated"  value="true" />
   <jsp-attribute name="trackDependencies" value="true" />
   <reload-interval value="9"/>
   <auto-encode-requests value="true"/>
   <auto-encode-responses value="false"/>
   <enable-directory-browsing value="false"/>
   <enable-file-serving value="false"/>
   <pre-compile-jsps value="false"/>
   <enable-reloading value="true"/>
   <enable-serving-servlets-by-class-name value="true"/>
</web-ext>

注意: JSPattribute_n 中的整数 n 在文件中必须唯一。