将 Java 代码生成到项目中

如果要生成 Java™ 程序或包装器,则建议您(在某些情况下是必需的)设置构建描述符选项 genProject,此选项导致生成到项目中。

当生成到项目中时,EGL 提供了各种服务。执行下面的任务时,服务会根据项目类型的不同而有所变化:
应用程序客户机项目
当生成到应用程序客户机项目中时,EGL 执行以下操作:
  • 通过将下列条目添加至项目的 Java 构建路径来提供对 EGL jar 文件(fda6.jar 和 fdaj6.jar)的准备时访问:
      EGL_GENERATORS_PLUGINDIR/runtime/fda6.jar
      EGL_GENERATORS_PLUGINDIR/runtime/fdaj6.jar

    有关每个条目开头部分的变量的详细信息,请参阅设置变量 EGL_GENERATORS_PLUGINDIR

  • 提供对 EGL jar 文件的运行时访问:
    • 将 jar 文件导入到每个引用应用程序客户机项目的企业应用程序项目中
    • 更新应用程序客户机项目中的清单,以使企业应用程序项目中的 jar 文件可用
  • 将运行时值放到部署描述符中,以便可以避免从生成的 J2EE 环境文件中剪切和粘贴条目;有关此主题的概述,请参阅设置部署描述符值
接下来的任务如下所示:
  1. 如果正在通过 TCP/IP 调用生成的程序,则提供对侦听器的运行时访问,如设置 TCP/IP 侦听器中所述
  2. 提供对非 EGL jar 文件的访问
  3. 既然已经将输出文件放到项目中,您可以继续设置 J2EE 运行时环境了
EJB 项目
当生成到 EJB 项目中时,EGL 执行以下操作:
  • 通过将下列条目添加至项目的 Java 构建路径来提供对 EGL jar 文件(fda6.jar 和 fdaj6.jar)的准备时访问:
      EGL_GENERATORS_PLUGINDIR/runtime/fda6.jar
      EGL_GENERATORS_PLUGINDIR/runtime/fdaj6.jar

    有关位于每个条目开头的环境变量的详细信息,请参阅设置变量 EGL_GENERATORS_PLUGINDIR

  • 提供对 EGL jar 文件的运行时访问:
    • 将 fda6.jar 和 fdaj6.jar 导入到每个引用 EJB 项目的企业应用程序项目中
    • 更新 EJB 项目中的清单,以使企业应用程序项目中的 fda6.jar 和 fdaj6.jar 在运行时可用
  • 自动指定 JNDI 名称,以便 EGL 运行时代码可以访问 EJB 代码;但仅当生成 EJB 会话 bean 时才执行此步骤。
  • 在大多数情况下,将运行时值放到部署描述符中,以便可以避免从生成的 J2EE 环境文件中剪切和粘贴条目;有关此主题的概述,请参阅设置部署描述符值

    如果 EGL 在部署描述符中找不到必需的会话元素,则 EGL 不会将运行时值放到部署描述符中。例如,当在包装器之前生成 Java 程序时,或者当构建描述符选项 sessionBeanID 被设置为在部署描述符中找不到的值时,就会发生这种情况。有关会话元素的详细信息,请参阅 sessionBeanID

接下来的任务如下所示:
  1. 提供对非 EGL jar 文件的访问
  2. 生成部署代码
  3. 既然已经将输出文件放到项目中,您可以继续设置 J2EE 运行时环境了
J2EE Web 项目
EGL 执行下列操作:
  • 通过将 fda6.jar 和 fdaj6.jar 导入到项目的 WebContent/WEB-INF/lib 文件夹中来提供对 EGL jar 文件的访问
  • 将运行时值放到部署描述符中,以便可以避免从生成的 J2EE 环境文件中剪切和粘贴条目;有关此主题的概述,请参阅设置部署描述符值
接下来的任务如下所示:
  1. 提供对非 EGL jar 文件的访问
  2. 既然已经将输出文件放到项目中,应按对 EGL 生成的代码设置 J2EE 运行时环境中所述继续进行
Java 项目
如果要生成到非 J2EE Java 项目中以便进行调试或生产,则 EGL 执行下列操作:
  • 通过将下列条目添加至项目的 Java 构建路径来提供对 EGL jar 文件(fda6.jar 和 fdaj6.jar)的访问:
      EGL_GENERATORS_PLUGINDIR/runtime/fda6.jar
      EGL_GENERATORS_PLUGINDIR/runtime/fdaj6.jar

    有关每个条目开头部分的变量的详细信息,请参阅设置变量 EGL_GENERATORS_PLUGINDIR

  • 生成属性文件,但仅当构建描述符包含下列选项值时才这样做:
    • genProperties 设置为 GLOBAL 或 PROGRAM;并且
    • J2EE 设置为 NO。

    如果请求全局属性文件(rununit.properties),EGL 将该文件放在 Java 源文件夹中,该文件夹包含 Java 包。(Java 源文件夹可能是项目中的文件夹或项目本身。)如果改为请求程序属性文件,EGL 会将该文件放在程序中。

    在运行时,程序属性文件中的值用来设置标准 JDBC 连接。有关详细信息,请参阅了解如何建立标准 JDBC 连接

既然已经将输出文件放在项目中,您可以执行下列操作了:
  • 如果程序访问关系数据库,则确保 Java构建路径包含驱动程序的安装目录。例如,对于 DB2®,指定包含 db2java.zip 的目录。
  • 如果代码访问 MQSeries®,则提供对非 EGL jar 文件的访问
  • 将链接属性文件放在模块中

有关生成到非现有项目中的后果的详细信息,请参阅 genProject

相关任务
生成 EJB 项目的部署代码
部署链接属性文件
设置部署描述符值
提供对非 EGL jar 文件的访问
设置变量 EGL_GENERATORS_PLUGINDIR
为 EGL 生成的代码设置 J2EE 运行时环境
了解如何建立标准 JDBC 连接

相关参考
genProject
sessionBeanID

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.