移轉 Portlet 專案中的 Faces 資源

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

註: 如果您建立包含 Faces 用戶端元件的 JavaServer Pages (JSP),您必須將 Faces 用戶端元件執行時期資源個別移轉至最新的層次。 請參閱移轉含 Faces 用戶端元件的 JavaServer Faces 資源
如果您在從 WebSphere Studio Application DeveloperWebSphere Studio Site Developer 5.1.2 版中的 Portal Toolkit 5.0.2.2 移轉的 Portlet 專案中建立或編輯 JSP,系統會提示您可以將 Portlet 專案執行時期資源移轉至最新的層次。 請按一下確定來完成移轉。
註: 如果您在起始移轉提示中回答,且有意保留舊版的 JAR 檔,系統就不會再提示您。如果您將來又需要 Portlet 專案資源,您必須依照下列方式來手動移轉它:
  1. 將含有 Faces 內容的現有 Portlet 專案匯入 Rational Web Developer 6.0 版工作區。
  2. 在第二個頁面中選取 Faces Portlet 選項來建立名稱為 JSFP60 的新 Portlet 專案。這個專案只用來作為最新執行時期成品的來源。 在移轉完成之後,即可將它刪除。
  3. 專案瀏覽器中,用滑鼠右鍵按一下 JSFP60 專案,再從功能表中選取內容。切換至 Web 專案特性的標籤,選取新增 Portlet 專案的 Faces 用戶端組織架構
  4. 對您要升級的每個現有的 Faces 專案,執行下列動作:
    1. 在專案瀏覽器中展開原始專案來顯示 WebContent/WEB-INF/lib/ 資料夾中的檔案。找出並刪除這個目錄中下列所有的 JAR 檔:
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • jsf-portlet.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>
      		<variable-resolver>com.ibm.faces.application.WPPortletVariableResolver</variable-resolver>
      		<property-resolver>com.ibm.faces.databind.SelectItemsPropResolver</property-resolver>
      	</application>
      註: 如果您的 Portlet 專案使用 JSR 168 API,請指定 com.ibm.faces.application.PortletVariableResolver 來取代 com.ibm.faces.application.WPPortletVariableResolver
  5. 對於您已刪除的任何 JAR 檔,從 JSFP60 專案的 WebContent/WEB-INF/lib 目錄中複製同名的 JAR 檔,將它貼到原始專案的相同位置。 某些配置並不需要所有這些 JAR 檔都在專案中;如果原始的專案沒有特定的 JAR 檔,請不要複製它們。
    1. 如果您的 Portlet 專案使用 IBM® Portlet API 或人員鏈結元件,請將 jsf-portlet-wp.jar 檔複製到您的原始專案中。
    2. 如果您複製 odc-jsf.jar 檔,也請複製 odc-jsf-portlet.jar 檔。
遵循這些步驟會使較舊的 Portlet 專案進入 Rational Web Developer 6.0 版 Faces 功能的最新層次。
相關工作
從 WebSphere Studio 5.1、5.1.1 或 5.1.2 移轉
移轉含 Faces 用戶端元件的 JavaServer Faces 資源

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