配置 JSP 引擎参数

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

关于此任务

以下注意事项适用于本主题中带有 .xmi 扩展名的文件引用:
支持的配置 支持的配置: 对于 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.xmiibm-webservices-bnd.xmiibm-webservicesclient-bnd.xmiibm-webservicesclient-ext.xmiibm-portlet-ext.xmi 文件继续使用 .xmi 文件扩展名。

sptcfg
WebSphere® Application Server 不支持通过管理控制台或通过管理脚本编制修改部署描述符扩展参数。
最佳实践 最佳实践: 使用 Rational Application Developer 等组装工具来修改 IBM 扩展和绑定文件。可以使用 IBM Bindings and Extensions Conversion Tool for Multi-Platforms 将模块中的扩展和绑定文件从 XMI 转换为 XML。bprac

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

过程

  1. 打开 WEB-INF/ibm-web-ext.xmiWEB-INF/ibm-web-ext.xml 文件。 [AIX Solaris HP-UX Linux Windows][z/OS]

    JSP 引擎配置参数存储在 Web 模块的配置目录中,或存储在 Web 模块 binaries 目录的 WEB-INF/ibm-web-ext.xmiWEB-INF/ibm-web-ext.xml 文件中。打开 WEB-INF/ibm-web-ext.xmiWEB-INF/ibm-web-ext.xml 文件,其位于以下位置:

    [AIX Solaris HP-UX Linux Windows][z/OS]
    • 配置目录,如以下示例所示:
      {WAS_ROOT}/profiles/profilename/config/cells/cellname/applications/enterpriseappname/deployments/deployedname/webmodulename
    • 如果应用程序部署到将使用二进制配置标志设置为 true 的 WebSphere Application Server 中,那么为二进制文件目录。二进制文件目录的一个示例是:
      {WAS_ROOT}/profiles/profilename/installedApps/nodename/EnterpriseAppName/WebModuleName/ 
    [IBM i]

    JSP 引擎配置参数存储在 Web 模块的配置目录中,或存储在 Web 模块 binaries 目录的 WEB-INF/ibm-web-ext.xmiWEB-INF/ibm-web-ext.xml 文件中。打开 WEB-INF/ibm-web-ext.xmiWEB-INF/ibm-web-ext.xml 文件,其位于以下位置:

    [IBM i]
    • 配置目录,如以下示例所示:
      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
    • 如果应用程序部署到将使用二进制配置标志设置为 true 的 WebSphere Application Server 中,那么为二进制文件目录。binaries 目录的示例如下:
      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
  2. 编辑 WEB-INF/ibm-web-ext.xmiWEB-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"/>
    • 要删除配置参数,删除文件中的行或将具有 <!-- --> 标记的语句括起来。
  3. 保存此文件。
  4. 重新启动企业应用程序。没有必要重新启动服务器以使参数更改生效。 然而,某些 JSP 引擎配置参数会影响为 JSP 生成的 Java 源代码。如果更改这样的参数,那么您必须重新转换 Web 模块中的 JSP 文件以重新生成 Java 源代码。您可以使用批处理编译器重新转换 Web 模块中的所有 JSP 文件。批处理编译器使用您在 ibm-web-ext.xmiibm-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 在文件中必须唯一。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tweb_jspengine
文件名:tweb_jspengine.html