配置 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 不支援透過「管理主控台」或管理 Scripting 來修改部署描述子延伸參數。

最佳作法: 使用組合工具 (例如 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 模組二進位檔目錄的 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)。二進位檔目錄的範例如下:
```
{WAS_ROOT}/profiles/profilename/installedApps/nodename/EnterpriseAppName/WebModuleName/ 
```
JSP 引擎配置參數儲存在 Web 模組的配置目錄中，或儲存在 Web 模組二進位檔目錄的 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 在檔案內必須是唯一的。