移轉 Web 專案中的 JavaServer Faces 資源

WebSphere® Studio Application DeveloperWebSphere Studio Site Developer 5.1.2 版原來所附的 JavaServer Faces 支援已完成 Rational® Web Developer 6.0 版的更新。如果您要在 6.0 版中繼續開發以 WebSphere Studio Application DeveloperWebSphere Studio Site Developer 5.1.2 版建立的 Web 專案,建議您將 Faces 專案的執行時期資源升級至最新的層次。

註: 如果您建立包含 Faces 用戶端元件的 JavaServer Pages (JSP),您必須將 Faces 用戶端元件執行時期資源個別移轉至最新的層次。 請參閱移轉含 Faces 用戶端元件的 JavaServer Faces 資源
如果您在從 WebSphere Studio Application DeveloperWebSphere Studio Site Developer 5.1.2 版移轉的專案中建立或編輯 JSP,系統會提示您可以將專案執行時期資源移轉至最新的層次。 請按一下確定來自動完成移轉。
註: 如果您在系統第一次提示移轉中回答,且有意保留舊版的 Java™ 保存檔 (JAR),系統就不會再提示您。如果您將來又需要專案資源,您必須用手動方式來移轉它們。
如果要手動移轉 JavaServer Faces 專案資源,請執行下列動作:
  1. 將含有 Faces 內容的現有 Web 專案匯入 Rational Web Developer 6.0 版工作區。
  2. 建立新的 Web 專案(或,如果您在使用 EGL,便是新的 EGL Web 專案),再呼叫 JSF60 專案。 這個專案只用來作為最新執行時期成品的來源。 在移轉完成之後,即可將它刪除。
  3. 在專案瀏覽器中,用滑鼠右鍵按一下 JSF60 專案,從功能表中選取內容。請切換至 Web 專案特性的標籤,選取新增 Faces 基本元件新增 Faces 用戶端組織架構
  4. 如果您在使用 EGL,請依照下列方式來建立 JSF 頁面檔:
    1. 用滑鼠右鍵按一下新 EGL Web 專案的 WebContent 資料夾。
    2. 選取新建 > 其他 > Faces JSP 檔 如果您需要建立 JSP 檔的說明,請按 F1 鍵。
    這個步驟會將下列檔案新增至專案中:
    • eglintdebug.jar
    • eglintdebugsupport.jar
  5. 對您要升級的每個現有的 Faces 專案,執行下列動作:
    1. 在專案瀏覽器中展開原始專案來顯示 WebContent/WEB-INF/lib/ 資料夾中的檔案。找出並刪除這個目錄中下列所有的 JAR 檔:
      • eglintdebug.jar(限 EGL)
      • eglintdebugsupport.jar(限 EGL)
      • fda.jar(限 EGL)
      • fdaj.jar(限 EGL)
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • odc-jsf.jar
    2. 找出並開啟 WebContent/WEB-INF/faces-config.xml 檔。將下列元素加入這個配置檔中(如果尚未存在):
      	<lifecycle>
      		<phase-listener>com.ibm.faces.webapp.ValueResourcePhaseListener</phase-listener>
      	</lifecycle>
      	
      	<application>
      		<variable-resolver>com.ibm.faces.databind.SelectItemsVarResolver</variable-resolver>
      		<property-resolver>com.ibm.faces.databind.SelectItemsPropResolver</property-resolver>
      	</application>
  6. 如果您在使用 EGL,請將 fda.jar 和 fdaj6.jar 檔複製到新專案中,不再處理已不使用的 fda.jar 和 fdaj.jar 檔。
  7. 對於您已刪除的任何 JAR 檔(fda.jar 和 fdaj.jar 以外的 JAR 檔,請參閱上一步驟),請從 JSF60 專案的 WebContent/WEB-INF/lib 目錄中複製同名的 JAR 檔,將它貼到原始專案的相同位置。 某些配置並不需要所有這些 JAR 檔都在專案中 - 如果原始的專案沒有特定的 JAR 檔,請不要複製它們。
  8. 開啟原始專案中的 web.xml 部署描述子,將下列內容加入配置中:
    	<context-param>
    		<param-name>com.ibm.ws.jsf.JSP_UPDATE_CHECK</param-name>
    		<param-value>true</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>
  9. 如果原始專案利用 WebSphere 資料物件 (WDO) 來進行任何資料存取作業,請執行下列其他步驟:
    1. 在原始專案中,建立新的暫時 Faces JSP 檔。 (按一下檔案 > 新建 > Faces JSP 檔。 請參閱線上說明,以取得協助。)
    2. 從選用區的資料抽屜中,將關聯式記錄清單元件拖曳至頁面中。 請選取任何連線和資料來源,再按一下完成 - 選取什麼資料並不重要。 這個程序會產生任何必要的配置,以便繼續在這個專案中使用 WDO。
    3. 刪除暫時 JSP 檔。
遵循這些步驟會使較舊的 Web 專案進入 Rational Web Developer 6.0 版 Faces 功能的最新層次。

如果您在使用 EGL,請用滑鼠右鍵按一下各 EGL Web 專案的名稱,再按一下產生;之後,如果您並未自動建置專案,請按一下專案 > 全部建置

(C) Copyright IBM Corporation 2000, 2004. All Rights Reserved.