为 J2EE 应用程序客户机模块中的被调用程序设置 TCP/IP 侦听器

如果要让调用程序使用 TCP/IP 来与 J2EE 应用程序客户机模块中的被调用程序交换数据,则必须为被调用程序设置 TCP/IP 侦听器。

您需要确保下列情况属实:

如果正在 J2EE 1.2 级别上使用项目,则建议您先建立随侦听器一起初始化的应用程序客户机项目,然后再将任何 EGL 代码生成到该项目中。如果未遵循该顺序(首先是侦听器,其次才是 EGL 代码),或者如果正在 J2EE 1.3 级别上使用项目,则需要执行提供从现有应用程序客户机项目对侦听器的访问描述的过程。

建立随侦听器一起初始化的应用程序客户机项目

要建立随侦听器一起初始化的应用程序客户机项目,执行下列操作:
  1. 单击文件 > 导入
  2. 在“选择”页上,双击应用程序客户机 JAR 文件
  3. 在“应用程序客户机导入”页上,指定几项详细信息:
    1. 在“应用程序客户机文件”字段中,指定一个 JAR 文件,该文件设置对 TCP/IP 侦听器的访问(但不包含 TCP/IP 侦听器):
      installationDir\egl\eclipse\plugins\
      com.ibm.etools.egl.generators_version\runtime\EGLTcpipListener.jar
      installationDir
      产品安装目录,如 C:\Program Files\IBM\RSPD\6.0。如果在安装您要使用的产品之前安装了 Rational® Developer 产品并将它保留了下来,则可能需要指定在先前安装中使用的目录。
      version
      插件的最新版本;例如,6.0.0。

      TCP/IP 侦听器本身位于 fdaj6.jar 中,当您第一次将 EGL 代码生成到应用程序客户机项目中时,fdaj.jar 将被放到该项目中。

    2. 单击新建单选按钮,该按钮位于应用程序客户机项目的标签后面。
    3. 新项目名字段中输入应用程序客户机项目的名称;然后,设置或取消设置使用缺省值复选框。如果设置了此复选框,则项目将存储在用项目名命名的工作空间目录中。如果取消设置了此复选框,则在新项目位置字段中指定项目名。
    4. 指定包含应用程序客户机项目的企业应用程序项目的名称:
      • 如果正在使用现有的 J2EE 1.2 企业应用程序项目,则单击现有单选按钮,该单选按钮位于企业应用程序项目的标签后面。在此例中,在现有项目名字段中指定项目名。
      • 如果正在创建新的企业应用程序项目,则执行下列操作:
        1. 单击新建单选按钮,该单选按钮位于企业应用程序项目的标签后面。
        2. 新项目名字段中输入企业应用程序项目的名称。
        3. 设置或取消设置使用缺省值复选框。
        4. 如果设置了此复选框,则项目将存储在用项目名命名的工作空间目录中。如果取消设置了此复选框,则在新项目位置字段中指定项目名。
  4. 单击完成
  5. 忽略两条警告消息,它们指示当将 EGL 输出生成到项目中时将自动添加 jar 文件(fda6.jar 和 fdaj6.jar)。
在应用程序客户机项目中,部署描述符属性 tcpiplistener.port 被设置为侦听器接收数据所用的端口号。缺省情况下,端口号是 9876。要更改端口号,执行下列操作:
  1. 在“项目资源管理器”视图中,展开应用程序客户机项目,然后展开 appClientModule,再展开 META-INF
  2. 单击 application-client.xml > 打开方式 > 部署描述符编辑器
  3. 部署描述符编辑器包括一个“源代码”选项卡;单击该选项卡并更改 9876 值,这是分组中最后一个标记的内容,如下所示:
    <env-entry-name>tcpiplistener.port</env-entry-name>
    <env-entry-type>java.lang.Integer</env-entry-name>
    <env-entry-value>9876</env-entry-value>
  4. 要保存部署描述符,请按 Ctrl-S 键。

提供从现有应用程序客户机项目对侦听器的访问

如果将 EGL 代码生成到不是与侦听器一起初始化的应用程序客户机项目中,则需要更新部署描述符(application-client.xml)和清单文件(MANIFEST.MF):
  1. 在“项目资源管理器”视图中,展开应用程序客户机项目,然后展开 appClientModule,再展开 META-INF
  2. 单击 application-client.xml > 打开方式 > 部署描述符编辑器
  3. 部署描述符编辑器包括一个“源代码”选项卡。单击该选项卡。在文本中,紧跟在包含 <display-name> 标记的行下面,添加下列条目(但是,如果机器上的端口 9876 已被使用,则用另一个端口号替换 9876):
    <env-entry>
      <env-entry-name>tcpiplistener.port</env-entry-name>
      <env-entry-type>java.lang.Integer</env-entry-name>
      <env-entry-value>9876</env-entry-value>
    </env-entry>
  4. 要保存部署描述符,请按 Ctrl-S 键。
  5. 在“项目资源管理器”视图中,单击 MANIFEST.MF > 打开方式 > JAR 依赖项编辑器
  6. “JAR 依赖项编辑器”包括一个“依赖项”选项卡。单击该选项卡。
  7. 查看“依赖项”部分以确保选择了 fda6.jar 和 fdaj6.jar。
  8. 在“Main 类”部分中,在“Main 类”字段中,输入以下值或使用“浏览”机制来指定以下值:
      CSOTcpipListenerJ2EE
  9. 要保存清单文件,请按 Ctrl-S 键。

部署应用程序客户机项目

要启动 TCP/IP 侦听器,请执行下列两个过程中的任何一个过程:
  • 通过使用 WebSphere® 应用程序客户机的启动配置,从工作台中启动侦听器:
    1. 切换至 J2EE 透视图
    2. 单击运行 > 运行
    3. 在“启动配置”页上,单击 WebSphere V5 应用程序客户机(如果正在 J2EE 1.3 级别上使用项目,则必须这样做)或 WebSphere V4 应用程序客户机
    4. 选择现有的配置。另外,也可以单击新建并设置配置:
      1. 在“应用程序”选项卡中,选择企业应用程序项目
      2. 在“自变量”选项卡中,添加自变量:
        -CCjar=myJar.jar
        myJar.jar
        应用程序客户机 jar 文件的名称。仅当 ear 文件包含多个客户机 jar 文件时,此自变量才是必需的。在大多数情况下,此值是应用程序客户机项目的名称,后跟扩展名 .jar。
        如果您希望确认项目名与 jar 文件名的关系,则执行下列操作:
        1. 在“项目资源管理器”视图中,展开企业应用程序项目,然后展开 META-INF
        2. 单击 application.xml > 打开方式 > 部署描述符编辑器
        3. “部署描述符”编辑器包括一个“模块”选项卡。单击该选项卡。
        4. 在页的最左边,单击 jar 文件并(在页的最右边)查看与该 jar 文件相关联的项目名。
  • 如果已安装 WebSphere Application Server(WAS),则可以使用 launchClient.bat,此文件位于 WAS 安装目录的子目录 bin 中。
    可以按照以下方式从命令提示符调用 launchClient:
    launchClient myCode.ear -CCjar=myJar.jar
    myCode.ear
    企业归档的名称
    myJar.jar
    应用程序客户机 jar 文件的名称,如有关工作台过程的内容所述

    有关 launchClient.bat 的详细信息,请参阅 WebSphere Application Server 文档。

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