配置 JSF 引擎參數

關於這項作業

WebSphere® Application Server 不支援透過管理主控台或管理 Scripting 來修改部署描述子延伸參數。

如果要新增、變更或刪除 JSF 引擎配置參數，請完成下列步驟：

程序

開啟 WEB-INF/web.xml 檔案。
JSP 引擎配置參數儲存在 Web 模組的配置目錄或 Web 模組的二進位檔目錄中的 WEB-INF/web.xml 檔。從下列目錄開啟 WEB-INF/web.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/
JSF 引擎配置參數儲存在 Web 模組的配置目錄或 Web 模組的二進位檔目錄中的 WEB-INF/web.xml 檔。從下列目錄開啟 WEB-INF/web.xml 檔：
- 配置目錄，如下列範例所示：profile_root/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/web.xml
- 二進位檔目錄 (如果應用程式已部署至 WebSphere Application Server ，且使用二進位配置旗標設為 true)。二進位檔目錄的範例如下: profile_root/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/web.xml
編輯 WEB-INF/web.xml 檔案。
- 如果要新增配置參數，請使用下列格式：
```
<context-param>
		<description>descriptive text</description>
		<param-name>parameter name</param-name>
		<param-value>parameter value</param-value>
</context-param>
```
- 如果要刪除配置參數，請從檔案中刪除那一行，或以  標籤括住陳述式。
儲存檔案。
重新啟動企業應用程式。不需要重新啟動伺服器，參數變更也會生效。
不過，部分 JSP 引擎配置參數會影響針對 JSP 所產生的 Java 原始碼。如果這種參數變更，您必須重新轉換 Web 模組中的 JSP 檔來重新產生 Java 原始碼。您可以使用批次編譯器來重新轉換 Web 模組中的所有 JSP 檔。批次編譯器使用您在中設定的 JSP 引擎配置參數web.xml檔案，除非您明確置換它們。 JSP 引擎配置主題指出哪些參數會影響產生的 Java 原始碼。

範例

下列是 WEB-INF/web.xml 檔範例。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	id="WebApp_ID" version="2.5">
	<display-name>Servlet 2.5 example</display-name>
	<welcome-file-list>
		<welcome-file>index.html</welcome-file>
		<welcome-file>index.htm</welcome-file>
		<welcome-file>index.jsp</welcome-file>
		<welcome-file>default.html</welcome-file>
		<welcome-file>default.htm</welcome-file>
		<welcome-file>default.jsp</welcome-file>
	</welcome-file-list>
	<context-param>
      	<param-name>javax.faces.CONFIG_FILES</param-name>
      	<param-value>/WEB-INF/faces-config.xml</param-value>
   	</context-param>
    <context-param>
        <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
        <param-value>server</param-value>
    </context-param>
    <context-param>
        <param-name>com.ibm.ws.jsf.LOAD_FACES_CONFIG_AT_STARTUP</param-name>
        <param-value>true</param-value>
    </context-param>
    <servlet>
        <servlet-name>Faces Servlet</servlet-name>
        <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>Faces Servlet</servlet-name>
        <url-pattern>/faces/*</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>Faces Servlet</servlet-name>
        <url-pattern>*.faces</url-pattern>
    </servlet-mapping>
</web-app>