迁移 iSeries Web 项目

可以使用下列方法来迁移 iSeries™ Web 项目:

要点:
确保在继续迁移之前所有服务器实例都已停止。

将 V5.1.x iSeries Web 项目迁移到 V6.0.1

下列信息描述如何将 iSeries Web 项目从 Development Studio Client for iSeries V5.1.x 迁移到 WebSphere Development Studio Client for iSeries V6.0.1。

迁移活动涉及下列阶段:

  1. 使用现有 5.1.x 工作空间迁移项目
  2. 迁移 iSeries Web 项目内容
  3. 解决因迁移而生成的错误和警告

阶段 1:使用现有 5.1.x 工作空间迁移项目

在 V6.0.1 中,新 Web 项目的缺省 Web Content 和 Java™ Source 文件夹名可通过首选项页进行配置。缺省名现在为 WebContent 和 JavaSource。这些缺省名将只用于新 Web 项目。V6.0.1 之前的版本中创建的 Web 项目将继续使用旧名称来工作。

  1. 当启动 V6.0.1 产品(开始 > 程序 > IBM® Rational® > WebSphere Development Studio Client for iSeries)时,Rational Software Developer Platform 窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.1.x 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击确定
  3. 可选:在主菜单中,单击窗口 > 首选项。在左窗格中,展开 Web 工具并选择新建 J2EE 项目。在右窗格中设置首选项中的缺省文件夹名。

可以在 V6.0.1 中手工更改 5.1.x 项目的源文件夹名,方法是在“项目资源管理器”视图中右键单击文件夹名并选择“重构”,然后单击重命名。“重命名”操作重命名文件夹名,并确定 5.1.x Web 项目的 Java 构建路径。如果选择在 V6.0.1 中重命名 JavaSource 和 WebContent 文件夹名,则必须使用新文件夹名手工更新您所拥有的全部自动构建脚本。

可选:将 Web 项目转换为 Struts 1.1

如果在 IBM WebSphere Studio Application Developer V5 中创建了 Struts 1.1 Beta 2 Web 项目,则可以将该项目转换为 Struts 1.1,但这不是必需的,因为 Struts 1.1 Beta 2 仍然受支持。

如果确实有想要转换为 Struts 1.1 的 Struts 1.1 Beta 2 Web 项目:

  1. 创建一个名为 Struts11 的新 Struts 1.1 Web 项目。这样将方便访问转换实际项目时需要的 Struts 1.1 工件。转换完成后可以删除此项目。
  2. 对于想要转换为 Struts 1.1 的每个 Struts 1.1 Beta 2 项目,执行下列操作:
    1. 从项目的 Web Content/WEB-INF/lib 目录中删除下列 .jar 文件:commons-*.jarstruts.jar
    2. Struts11/WebContent/WEB-INF/lib 目录中的下列 .jar 文件复制到项目的 Web Content/WEB-INF/lib 目录:commons-*.jarstruts.jar
    3. 从项目的 Web Content/WEB-INF 目录中删除下列 .tld 文件:struts-*.tld
    4. Struts11/WebContent/WEB-INF 目录中的下列 .tld 文件复制到项目的 Web Content/WEB-INF 目录:struts-*.tld

阶段 2:迁移 iSeries Web 项目内容

要迁移 iSeries Web Tool 项目内容:

  1. 在 Web 透视图的“项目导航器”视图中,右键单击项目名称并选择属性。选择左边的面板中的 Web 项目功能部件。从可用 Web 项目功能部件列表中,选择 Struts(如果尚未选择)。单击确定。 在“Web 项目功能部件”窗口中单击完成以接受缺省 Struts 版本(1.1)。
    注:
    如果遗漏此步骤,即会显示一个窗口,请求您添加 Struts 支持。
  2. 要点:此时关闭该项目然后重新打开以避免因删除资源而导致异常并确保该项目未在任何服务器上运行。
  3. 右键单击 Web 透视图中的项目名称,然后选择迁移 > iSeries Web 工具项目。“确认迁移”窗口指示将要迁移项目结构和内容。
  4. 要继续此过程,请单击确定。“进度信息”窗口显示迁移的进度。
  5. 当迁移完成时,将有消息指示结果。
  6. 如果迁移过程成功完成,则无需进行进一步的操作。如果迁移过程完成,但出现错误或警告,请继续阶段 3:解决因迁移而生成的错误和警告
  7. 迁移过程执行下列操作:

阶段 3:解决因迁移而生成的错误和警告

如果迁移过程遇到问题,则会打开一个窗口,它指示发生了错误或警告。Web 透视图中项目名称下面描述这些问题的迁移日志文件 projectName_MigrationDetails.txt 也将打开。

迁移日志文件顶部的『迁移结果』一节指示迁移的整体状态并引用下面一个联机版本的警告和错误表,该表带有描述和更正性操作。请参阅 Web 项目迁移的警告和错误消息

将 V5.0 iSeries Web 项目迁移到 V6.0.1

下列信息描述如何将 iSeries Web 项目从 Development Studio Client for iSeries V5.0 迁移至 WebSphere Development Studio Client for iSeries V6.0.1。

迁移活动涉及下列阶段:

  1. 使用文件系统上现有的 5.0 Web 项目迁移项目
  2. 迁移 iSeries Web 项目内容
  3. 解决因迁移而生成的错误和警告

阶段 1:将文件系统上现有的 5.0 项目迁移到 V6.0.1

在 V6.0.1 中,新 Web 项目的缺省 Web Content 和 Java Source 文件夹名可通过首选项页进行配置。缺省名现在为 WebContent 和 JavaSource。这些缺省名将只用于新 Web 项目。V6.0.1 之前的版本中创建的 Web 项目将继续使用旧名称来工作。

要迁移 Web Content 文件夹的内容:

  1. 当启动 V6.0.1 产品(开始 > 程序 > IBM Rational > WebSphere Development Studio Client for iSeries)时,“工作空间启动程序”窗口打开,您可以在此窗口中指定要用于会话的目录。将缺省位置用作工作空间。
  2. 切换到“资源”透视图。
  3. 创建一个名称和 Servlet 版本与现有 5.0 Web 项目相同的新动态 Web 项目。要查找 Servlet 版本,查看现有 5.0 项目的 .websettings 文件并搜索 jsp-level 标记。如果 jsp 级别为 1.2,则将 Servlet 版本设置为 2.3,否则将 Servlet 版本设置为 2.2。单击完成。出现提示时不要切换到 Web 透视图。
  4. 选择新创建的项目的 Web Content 文件夹,右键单击并从上下文菜单中选择导入
  5. 选择文件系统作为导入源并单击下一步。单击浏览按钮并选择现有 5.0 Web 项目的 Web Content 文件夹(缺省名:Web Content)。单击确定
  6. 选择 Web Content 文件夹,但不选择复选框。单击全部选中。在右边的面板中,取消选择其中一个文件,然后重新选择该文件。这相当于导入 Web Content 文件夹的所有内容,但不导入 Web Content 文件夹本身。
  7. 在右边的面板中,如果下列文件出现在列表中,则取消选择它们:
  8. 选择仅创建选择的文件夹选项和覆盖现有资源而不发出警告选项并单击完成。现在,新创建的项目的 Web Content 文件夹应包含与 5.0 Web Content 文件夹类似的资源和文件夹结构。

要迁移 Java Source 文件夹的内容:

  1. 选择新创建的项目的 Java Source 文件夹,右键单击并从上下文菜单中选择导入
  2. 选择文件系统作为导入源并单击下一步。单击浏览按钮并选择现有 5.0 Web 项目的 Java Source 文件夹(缺省名:Java Source)。单击确定
  3. 选择 Java Source 文件夹,但不选择复选框。单击全部选中。在右边的面板中,取消选择其中一个文件,然后重新选择该文件。这相当于导入 Java Source 文件夹的所有内容,但不导入 Java Source 文件夹本身。
  4. 选择仅创建选择的文件夹选项和覆盖现有资源而不发出警告选项并单击完成。现在,新创建的项目的 Java Source 文件夹应包含与 5.0 Java Source 文件夹类似的资源和文件夹结构。

要迁移 Web Project 文件夹的内容:

  1. 现在选择新创建的项目,右键单击并从上下文菜单中选择导入
  2. 选择文件系统作为导入源并单击下一步。单击浏览按钮并选择现有 5.0 Web 项目。
  3. 在左边的面板中,选择项目文件夹并单击全部选中。在右边的面板中,取消选择其中一个文件,然后重新选择该文件。在左边的面板中,取消选择 Web Content 和 Java Source 文件夹。这相当于导入 Web Project 文件夹的所有内容,但 Web Content 和 Java Source 文件夹以及 Web Project 文件夹本身除外。
  4. 在右边的面板中,如果下列文件出现在列表中,则取消选择它们:

    这些文件包含设计时需要的关于项目的信息。该信息不能迁移到 V6.0.1,因此必要时将重新创建这些文件。

  5. 选择仅创建选择的文件夹选项和覆盖现有资源而不发出警告选项并单击完成。现在,新创建的 Web Project 文件夹应包含与 5.0 Web Project 文件夹类似的资源和文件夹结构。

除去旧的 Struts 级别工件

  1. 右键单击 WebContent/WEB-INF/web.xml。选择打开方式 > 部署描述符编辑器
  2. 转至 Servlet 选项卡。
  3. 除去映射 servlet 类 org.apache.struts.action ActionServlet 的 Servlet 条目,缺省名 action

阶段 2:迁移 iSeries Web 项目内容

要迁移 iSeries Web Tool 项目内容:

  1. 在 Web 透视图的“项目导航器”视图中,右键单击项目名称并选择属性。选择左边的面板中的 Web 项目功能部件。从可用 Web 项目功能部件列表中,选择 Struts(如果尚未选择)。单击确定。 在“Web 项目功能部件”窗口中单击完成以接受缺省 Struts 版本(1.1)。
    注:
    如果遗漏此步骤,即会显示一个窗口,请求您添加 Struts 支持。
  2. 要点:此时关闭该项目然后重新打开以避免因删除资源而导致异常并确保该项目未在任何服务器上运行。
  3. 右键单击 Web 透视图中的项目名称,然后选择迁移 > iSeries Web 工具项目。“确认迁移”窗口指示将要迁移项目结构和内容。
  4. 要继续此过程,请单击确定。“进度信息”窗口显示迁移的进度。
  5. 当迁移完成时,将有消息指示结果。
  6. 如果迁移过程成功完成,则无需进行进一步的操作。如果迁移过程完成,但出现错误或警告,请继续阶段 3:解决因迁移而生成的错误和警告
  7. 迁移过程执行下列操作:

阶段 3:解决因迁移而生成的错误和警告

如果迁移过程遇到问题,则会打开一个窗口,它指示发生了错误或警告。Web 透视图中项目名称下面描述这些问题的迁移日志文件 projectName_MigrationDetails.txt 也将打开。

迁移日志文件顶部的『迁移结果』一节指示迁移的整体状态并引用下面一个联机版本的警告和错误表,该表带有描述和更正性操作。请参阅 Web 项目迁移的警告和错误消息

仅对 5.0.x 迁移而言,除日志文件中列示的任何迁移警告之外,还应清楚“文本条目 Web 组件”的“最大长度”(maxLength)属性不再受到支持。这可能会影响 Web 页面的外观。

将 V4.0 iSeries Web 项目迁移到 V6.0.1

下列信息描述如何将 iSeries Web 项目从 Development Studio Client for iSeries V4.0 迁移至 WebSphere Development Studio Client for iSeries V6.0.1。

迁移活动涉及下列阶段:

  1. 使用文件系统上现有的 4.0 Web 项目迁移项目
  2. 迁移 iSeries Web 项目内容
  3. 解决因迁移而生成的错误和警告

阶段 1:将文件系统上现有的 4.0 项目迁移到 V6.0.1

在 V6.0.1 中,新 Web 项目的缺省 Web Content 和 Java Source 文件夹名可通过首选项页进行配置。缺省名现在为 WebContent 和 JavaSource。这些缺省名将只用于新 Web 项目。V6.0.1 之前的版本中创建的 Web 项目将继续使用旧名称来工作。

要迁移 Web Content 文件夹的内容:

  1. 当启动 V6.0.1 产品(开始 > 程序 > IBM Rational > WebSphere Development Studio Client for iSeries)时,“工作空间启动程序”窗口打开,您可以在此窗口中指定要用于会话的目录。将缺省位置用作工作空间。
  2. 切换到“资源”透视图。
  3. 创建一个名称和 Servlet 版本与现有 4.0 Web 项目相同的新动态 Web 项目。要查找 Servlet 版本,查看现有 4.0 项目的 .websettings 文件并搜索 jsp-level 标记。如果 jsp 级别为 1.2,则将 Servlet 版本设置为 2.3,否则将 Servlet 版本设置为 2.2。单击完成。出现提示时不要切换到 Web 透视图。
  4. 选择新创建的项目的 Web Content 文件夹,右键单击并从上下文菜单中选择导入
  5. 选择文件系统作为导入源并单击下一步。单击浏览按钮并选择现有 4.0 Web 项目的 Web Content 文件夹(缺省名 webApplication)。单击确定
  6. 选择 Web Content 文件夹,但不选择复选框。单击全部选中。在右边的面板中,取消选择其中一个文件,然后重新选择该文件。这相当于导入 Web Content 文件夹的所有内容,但不导入 Web Content 文件夹本身。
  7. 选择仅创建选择的文件夹选项和覆盖现有资源而不发出警告选项并单击完成。现在,新创建的项目的 Web Content 文件夹应包含与 4.0 Web Content 文件夹类似的资源和文件夹结构。

要迁移 Java Source 文件夹的内容:

  1. 选择新创建的项目的 Java Source 文件夹,右键单击并从上下文菜单中选择导入
  2. 选择文件系统作为导入源并单击下一步。单击浏览按钮并选择现有 4.0 Web 项目的 Java Source 文件夹(缺省名:source)。单击确定
  3. 选择 Java Source 文件夹,但不选择复选框。单击全部选中。在右边的面板中,取消选择其中一个文件,然后重新选择该文件。这相当于导入 Java Source 文件夹的所有内容,但不导入 Java Source 文件夹本身。
  4. 选择仅创建选择的文件夹选项和覆盖现有资源而不发出警告选项并单击完成。现在,新创建的项目的 Java Source 文件夹应包含与 4.0 Java Source 文件夹类似的资源和文件夹结构。

要迁移 Web Project 文件夹的内容:

  1. 现在选择新创建的项目,右键单击并从上下文菜单中选择导入
  2. 选择文件系统作为导入源并单击下一步。单击浏览按钮并选择现有 4.0 Web 项目。
  3. 在左边的面板中,选择项目文件夹并单击全部选中。在右边的面板中,取消选择其中一个文件,然后重新选择该文件。在左边的面板中,取消选择 Web Content 和 Java Source 文件夹。这相当于导入 Web Project 文件夹的所有内容,但 Web Content 和 Java Source 文件夹以及 Web Project 文件夹本身除外。
  4. 在右边的面板中,如果下列文件出现在列表中,则取消选择它们:

    这些文件包含设计时需要的关于项目的信息。该信息不能迁移到 V6.0.1,因此必要时将重新创建这些文件。

  5. 选择仅创建选择的文件夹选项和覆盖现有资源而不发出警告选项并单击完成。现在,新创建的 Web Project 文件夹应包含与 4.0 Web Project 文件夹类似的资源和文件夹结构。

阶段 2:迁移 iSeries Web 项目内容

要迁移 iSeries Web Tool 项目内容:

  1. 在 Web 透视图的“项目导航器”视图中,右键单击项目名称并选择属性。选择左边的面板中的 Web 项目功能部件。从可用 Web 项目功能部件列表中,选择 Struts(如果尚未选择)。单击确定。 在“Web 项目功能部件”窗口中单击完成以接受缺省 Struts 版本(1.1)。
    注:
    如果遗漏此步骤,即会显示一个窗口,请求您添加 Struts 支持。
  2. 要点:此时关闭该项目然后重新打开以避免因删除资源而导致异常并确保该项目未在任何服务器上运行。
  3. 右键单击 Web 透视图中的项目名称,然后选择迁移 > iSeries Web 工具项目。“确认迁移”窗口指示将要迁移项目结构和内容。
  4. 要继续此过程,请单击确定。“进度信息”窗口显示迁移的进度。
  5. 当迁移完成时,将有消息指示结果。
  6. 如果迁移过程成功完成,则无需进行进一步的操作。如果迁移过程完成,但出现错误或警告,请继续阶段 3:解决因迁移而生成的错误和警告
  7. 迁移过程执行下列操作:

阶段 3:解决因迁移而生成的错误和警告

如果迁移过程遇到问题,则会打开一个窗口,它指示发生了错误或警告。Web 透视图中项目名称下面描述这些问题的迁移日志文件 projectName_MigrationDetails.txt 也将打开。

迁移日志文件顶部的『迁移结果』一节指示迁移的整体状态并引用下面一个联机版本的警告和错误表,该表带有描述和更正性操作。请参阅 Web 项目迁移的警告和错误消息

其他迁移考虑事项

除了上面描述的日志文件中列示的所有迁移错误外,必要时,还需要处理以下情况:

除了在上面阶段 4 描述的日志文件中列示的所有迁移警告外,还应了解下列可能影响 Web 页面外观的更改:

Web 项目迁移的警告和错误消息

错误代码 描述 操作
E100 在 JSP 文件的迁移过程中出现了未确定的错误。 解决或处理迁移日志文件中的所有其他错误或警告并再次运行迁移工具。
E101 JSP 文件中的 iSeries Web 组件有错误。 解决 iSeries Web 组件错误。
E200 处理导致未确定错误的 .wit 文件。 双击具有错误的 .wit 文件以调用“Web 交互”向导。完成向导的所有页并进行必要的更改。单击“完成”。
E201 在此交互所使用的页中定义的一个或多个 Web 组件名无效。 双击具有错误的 .wit 文件以调用“Web 交互”向导。此时会出现一个窗口,指示 Web 组件名无效并询问是否要更改它们。单击。进行所需的任何更改。对于更改了输入或输出参数的任何 Web 组件,填写“会话中的名称”、“保存至会话”和“链接”选项。完成向导的所有页并进行必要的更改。单击“完成”。
E202 此交互中定义的输出参数的“消息指示符”值设置为 true。在此发行版中,高级消息处理功能有了很大更改。需要重新定义“消息处理”选项。 双击具有错误的 .wit 文件以调用“Web 交互”向导。在“将输出参数映射并链接到输出字段”页上,将“消息控制器”值设置为 true,选择值“true”。现在您可以看到按钮;单击该按钮,定义消息控制规范。
E300 处理设计时控件(DTC)和/或生成的 iSeries Web 组件时出现未确定的错误。 解决或处理迁移日志文件中的所有其他错误或警告。重命名迁移日志文件并再次运行迁移工具。
E301–E302 按钮的设计控件属性“上一步”/“下一步”不再受支持。按钮 Web 组件按钮类型属性将被定义为“提交”。 使用“Web 交互”向导创建交互,将包含下一步/上一步按钮的页面指定为输入 JSP 页,并将“下一步”按钮的目标页指定为输出 JSP 页。在 V4.0 中,下一步/上一步按钮与多个输入页面一起使用。单击帮助 > 帮助内容打开帮助系统,然后再单击参考 > 用户界面参考 > iSeries Web 应用程序 > 多个输入和输出页面
E400 在代码生成模板文件的迁移过程中出现了未确定的错误。 确保代码生成模板不是只读的。解决迁移日志文件中的所有其他错误或警告并再次运行迁移工具。
E401 代码生成模板文件已定制。使用较新版本的模板。 确保已将对较早版本的模板进行的定制应用于较新版本的模板。例如,需要将 <workspace_location>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction. template.bak 中的定制内容正确插入到 <workspace_location>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction. template
警告代码 描述 操作
W100 JSP 页上的 iSeries Web 组件有警告。 处理 iSeries Web 组件警告。
W300 列表框或组合框的定界符属性包含多个字符。定界符属性中的第一个字符用于相应的 iSeries Web 组件定界符属性。 确保正确定义了选择框或组合框 Web 组件的所有选项的名称和值属性。
W301–W302 列表框或组合框在“数据”属性 [密钥] 或 [值] 中包含预选字符 *。 确保正确定义了选择框或组合框 Web 组件的所有选项的名称和值属性。
W303 JSP 文件中组名属性相同的所有单选按钮设计控件现在作为单选按钮组 Web 组件的一个选项出现。在 JSP 页中第一个单选按钮的“字体”选项卡和“颜色”选项卡上定义的属性用作“单选按钮组”的“颜色”和“字体”属性。也就是说,同一个组中后面的单选按钮将缺少“颜色”选项卡和“字体”选项卡属性。 通过选择相关的 JSP 文件并在服务器上运行此文件,确保“单选按钮组”在 JSP 页中以所期望的外观出现。通过选择相关的 JSP 文件并在服务器上运行,确保“单选按钮组”的“字体”和“颜色”属性以所期望的外观出现。
W304 按钮属性标签不再受支持。 按钮属性值已映射至相应按钮 Web 组件的“标签”属性。在按钮 Web 组件上出现的文本与按钮设计控件的不同。 如果在按钮 Web 组件上显示的文本不合适,请更改“标签”属性的值。
W305 子文件或表设计控件现在出现在 HTML FORM 标记外面。表 Web 组件不能出现在 HTML FORM 标记内。如果设计控件类型为子文件,则相应的 iSeries Web 组件为表 Web 组件。 确保表 Web 组件在 JSP 页上以所期望的外观出现。
W306–W320 设计控件事件属性不再受支持。
  • W306 - OnDblClick
  • W307 - OnMouseDown
  • W308 - OnMouseOut
  • W309 - OnMouseOver
  • W310 - OnSelect
  • W312 - 对单选按钮进行 OnChange 操作
  • W313 - 对复选框进行 OnChange 操作
  • W314 - OnMouseUp
  • W315 - 对单选按钮进行 OnKeyDown 操作
  • W316 - 对单选按钮进行 OnKeyPress 操作
  • W317 - 对单选按钮进行 OnKeyUp 操作
  • W318 - 对按钮进行 OnKeyDown 操作
  • W319 - 对按钮进行 OnKeyPress 操作
  • W320 - 对按钮进行 OnKeyUp 操作
若有必要,定义具有不同事件的关联操作。
W321 Web 组件定义了不再受支持的属性,原因为:1) 大多数浏览器不支持关联的 CSS 属性 2) 在 HTML 4.0 中已不推荐关联的 HTML 属性,且大多数浏览器不再支持该属性 无。