迁移 Web 项目中的 JavaServer Faces 资源

已经对 Rational® Application Developer V6.0 更新了最初在 WebSphere® Studio Application Developer V5.1.2 中附带提供的 JavaServer Faces 支持。如果想要在 V6.0 中继续开发使用 WebSphere Studio Application Developer V5.1.2 创建的 Web 项目,则建议将 Faces 项目运行时资源升级到最新级别。

注: 如果您创建了包含 Faces Client 组件的 JavaServer Pages(JSP),则必须单独地将 Faces Client 组件运行时资源迁移到最新级别。请参阅迁移具有 Faces Client 组件的 JavaServer Faces 资源
如果在从 WebSphere Studio Application Developer V5.1.2 迁移的项目中创建或编辑 JSP,系统将提示您可以将项目运行时资源迁移到最新级别。单击确定以自动完成迁移。
注: 如果在首次提示迁移时回答并有意停留在后备级别 Java™ 归档(JAR)文件,则不会再次提示您。如果您将来需要,则需要手工迁移项目资源。
手工迁移 JavaServer Faces 项目资源:
  1. 将具有 Faces 内容的现有 Web 项目导入到 Rational Application Developer V6.0 工作空间中。
  2. 创建一个新的 Web 项目(或者如果正在使用 EGL,则创建一个新的 EGL Web 项目),并且将该项目命名为 JSF60。仅将此项目用作最新运行时构件的源。在迁移完成之后可以删除它。
  3. 在“项目资源管理器”中,右键单击 JSF60 项目并从菜单中选择属性。切换至 Web 项目功能部件选项卡并选择添加 Faces 基本组件添加 Faces Client 框架
  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>
    3. 如果正在使用 EGL,则将文件 fda6.jar 和 fdaj6.jar 复制到现有的项目,不需要再对文件 fda.jar 和 fdaj.jar 进行处理,因为不会再使用它们了。
    4. 对于删除的任何 JAR 文件(fda.jar 和 fdaj.jar 文件除外;如上一步骤所述),复制 JSF60 项目的 WebContent/WEB-INF/lib 目录中的同名 JAR 文件并将它们粘贴到原始项目中的同一位置。某些配置并不需要在项目中有所有这些 JAR 文件 - 如果原始项目没有某个 JAR 文件,则不要复制它们。
    5. 在原始项目中打开 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>
    6. 如果原始项目使用 WebSphere 数据对象(WDO)来进行任何数据访问,则执行下列附加步骤:
      1. 在原始项目中创建一个新的临时 Faces JSP 文件。(单击文件 > 新建 > Faces JSP 文件。请参阅联机帮助以获得帮助。)
      2. 将关系记录列表组件从选用板的“数据”抽屉拖到该页面中。选取任何连接和数据源并按完成 - 选择的数据并不重要。此过程将生成任何必需的配置以在此项目中继续使用 WDO。
      3. 删除临时 JSP 文件。
遵循这些步骤将把较旧的 Web 项目升级为具有 Rational Application Developer V6.0 中最新级别的 Faces 功能。

如果正在使用 EGL,则右键单击每个 EGL Web 项目的名称并单击生成;接着,如果不想自动构建项目,则单击项目 > 全部构建

相关任务
迁移 portlet 项目中的 Faces 资源
从 WebSphere Studio V5.1、5.1.1 或 5.1.2 进行迁移
迁移具有 Faces Client 组件的 JavaServer Faces 资源
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.