迁移程序调用 Bean

将 iSeries Java 和 Web 项目中的程序调用 bean 从 V5.1 或 5.1.2 迁移到 V6.0.1

本节描述如何将 Development Studio Client for iSeries™ V5.1 或 5.1.2 中创建的程序调用 bean 迁移到 V6.0.1。

在 V6.0.1 中,“程序调用”向导将程序调用 bean 的 PCML 文件放在 bean 软件包中。这是与先前版本不同的地方。如果要根据不在 bean 软件包中的现有 PCML 文件重新创建程序调用 bean,则可以在向导完成重新创建程序调用 bean 之后删除此 PCML 文件。

注:
在 V6.0.1 中,可直接使用 Web Service 向导从 ILE RPG 或 COBOL 源代码或 PCML 文件来创建 iSeries 程序 Web Service。而不必运行“程序调用”向导和 Web Service 向导。

迁移 Java 项目中的程序调用 bean

  1. 当启动 V6.0.1 产品(开始 > 程序 > IBM® Rational® > WebSphere Development Studio Client for iSeries)时,“工作空间启动程序”窗口打开,您可以在此窗口中指定要用于会话的目录。指定 V5.x 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式时,则单击确定
  3. 通过更改项目的 Java™ 构建路径除去运行时 .jar 文件:
    1. 右键单击该 Java 项目并选择属性
    2. 在左窗格中选择 Java 构建路径
    3. 选择选项卡,然后选择下列 JAR 文件并单击除去以将其从类路径中除去:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
      j2ee.jar
    4. 对所有 PCML 文件重新运行“程序调用”向导。如果您使用的是缺省软件包,则必须在 V6.0.1 中指定软件包名称。新生成的 Java bean 和 PCML 文件将位于指定的软件包中,您可以删除缺省软件包中旧的 Java bean 和 PCML 文件。

迁移 Web 项目中的程序调用 bean

如果您是程序调用服务 bean 用户,则应该知道在 V6.0.1 中“程序调用”向导总是生成 .config 文件。该文件可以是用户指定的文件或缺省 defaultPCW.config。您不应该再使用“运行时配置”向导。对于 V6.0.1 之前的任何 Web 项目,下面概述的 Web 工具项目迁移步骤将从项目的 web.xml 文件获取信息,并且将自动创建 defaultPCW.config(如果它尚未存在)。从 V6.0 开始,程序调用运行时配置将基于 .config 文件中的数据,而不是 web.xml 文件。

  1. 当启动 V6.0.1 产品(开始 > 程序 > IBM Rational > WebSphere Development Studio Client for iSeries)时,“工作空间启动程序”窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.1 或 5.1.2 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击确定
  3. (可选步骤:使用“J2EE 迁移”向导从 J2EE 级别 1.2 迁移到更高 J2EE 级别。)
  4. 从 WEB-INF\lib 文件夹中删除 iwdtrt.jar 和 jt400.jar。
  5. 对所有 PCML 文件重新运行“程序调用”向导。将在指定软件包中创建新的服务 bean 和 PCML 文件。从 Web 项目中删除任何旧的 PCML 文件。
  6. 对服务 bean 重新运行 Web Service 向导。

Web service 向导生成的代码需要手工迁移和清除。此迁移仅适用于 Web service bean 本身。请参阅随基本 Rational Software Developer Platform 产品提供的迁移指南中有关如何迁移 Web service 的 Web service 章节(请参阅查找其他重要信息,获得此指南的链接)。

将 iSeries Java 和 Web 项目中的程序调用 bean 从 V5.0 迁移到 V6.0.1

本节描述了如何将 Development Studio Client for iSeries V5.0 中创建的程序调用 bean 迁移到 V6.0.1。

注:
在 V6.0.1 中,可直接使用 Web Service 向导从 ILE RPG 或 COBOL 源代码或 PCML 文件来创建 iSeries 程序 Web Service。而不必运行“程序调用”向导和 Web Service 向导。

迁移 Java 项目中的程序调用 bean

  1. 当启动 V6.0.1 产品(开始 > 程序 > IBM Rational > WebSphere Development Studio Client for iSeries)时,“工作空间启动程序”窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V5.0 工作空间的目录位置。
  2. 如果提示确认是否要转换为新的用户界面格式,则单击确定
  3. 通过更改项目的 Java 构建路径除去运行时 .jar 文件:
    1. 右键单击该 Java 项目并选择属性
    2. 在左窗格中选择 Java 构建路径
    3. 选择选项卡,然后选择下列 JAR 文件并单击除去以将其从类路径中除去:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
      j2ee.jar
    4. 对所有 PCML 文件重新运行“程序调用”向导。在该向导的“配置认证”页上,取消选择生成配置文件选项。

迁移 Web 项目中的程序调用 bean

以下章节将描述如何迁移 Web Content 文件夹、Java Source 文件夹和 Web Project 文件夹的内容。

要迁移 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. 选择仅创建选择的文件夹选项和覆盖现有资源而不发出警告选项并单击完成。现在,新创建的项目的 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 文件夹类似的资源和文件夹结构。

  1. (可选步骤:使用“J2EE 迁移”向导从 J2EE 级别 1.2 迁移到更高 J2EE 级别。)
  2. 从 WEB-INF\lib 文件夹中删除 iwdtrt.jar 和 jt400.jar。
  3. 对所有 PCML 文件重新运行“程序调用”向导。

此迁移仅适用于服务 bean 本身。请参阅随基本 Rational Software Developer Platform 产品提供的迁移指南中有关如何迁移 Web service 的 Web service 章节(请参阅查找其他重要信息,获得此指南的链接)。

将 iSeries Java 和 Web 项目中的程序调用 bean 从 V4.0 迁移到 V6.0.1

本节描述如何将 Development Studio Client for iSeries V4.0 中创建的程序调用 bean 迁移到 V6.0.1。

注:
在 V6.0.1 中,可直接使用 Web Service 向导从 ILE RPG 或 COBOL 源代码或 PCML 文件来创建 iSeries 程序 Web Service。而不必运行“程序调用”向导和 Web Service 向导。

迁移 Java 项目中的程序调用 bean

  1. 当启动 V6.0.1 产品(开始 > 程序 > IBM Rational > WebSphere Development Studio Client for iSeries)时,“工作空间启动程序”窗口打开,您可以在此窗口中指定要用于会话的目录。在此窗口中指定 V4.0 工作空间的目录位置。
  2. 当提示确认是否要转换为新的用户界面格式时,单击确定
  3. 通过更改项目的 Java 构建路径除去运行时 .jar 文件:
    1. 右键单击该 Java 项目并选择属性
    2. 在左窗格中选择 Java 构建路径
    3. 选择选项卡,然后选择下列 JAR 文件并单击除去以将其从类路径中除去:

         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
  4. 对所有 PCML 文件重新运行“程序调用”向导。在该向导的“配置认证”页上,取消选择生成配置文件选项。

此迁移仅适用于程序调用 bean 本身。“程序调用”向导生成的代码需要手工迁移和清除。

迁移 Web 项目中的程序调用 bean

要迁移 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 文件夹应包含与 5.0 Web Project 文件夹类似的资源和文件夹结构。
  1. (可选步骤:使用“J2EE 迁移”向导从 J2EE 级别 1.2 迁移到更高 J2EE 级别。)
  2. 从 WEB-INF\lib 文件夹中删除 wdt400rt.jar 和 wdt400tb.jar。
  3. 对所有 PCML 文件重新运行“程序调用”向导。
  4. 此迁移仅适用于服务 bean 本身。

从 V5.1 开始,必须在指定的软件包中生成 bean,然后才能调用 Web Service 向导。Web service 向导生成的代码需要手工迁移和清除。

此迁移仅适用于 Web service bean 本身。请参阅随基本 Rational Software Developer Platform 产品提供的迁移指南中有关如何迁移 Web service 的 Web service 章节(请参阅查找其他重要信息,获得此指南的链接)。