使用 EGL 创建 Hello World 服务 >
< 上一课 | 下一课 >

第 2 课:设置服务

既然已编写了此服务的代码,那么可使其以 Web Service 形式提供给其他应用程序。以此方式提供该服务涉及创建服务绑定信息,此信息告诉其他应用程序在何处查找该服务以及服务中提供了哪些功能。该服务以 Web 服务描述语言(WSDL)文件的形式发布此信息。

作为 Web Service 的替代方法,EGL 客户机应用程序可以 EGL 服务的形式访问 EGL 服务应用程序。此方法的性能比 Web Service 的性能高,但只能在两个 EGL 应用程序之间使用。为获得最大兼容性,本教程使用 Web Service,Web Service 可在两个 EGL 应用程序之间、两个非 EGL 应用程序之间或者一个 EGL 应用程序与一个非 EGL 应用程序之间使用。要了解更多信息,请通过单击帮助 > 帮助内容来查看 EGL 文档。

服务绑定信息包含在 EGL 部署描述符中。在这些步骤中,您将使用项目的部署描述符并将项目的构建描述符配置为使用该部署描述符。

演示

验证部署描述符和构建描述符

创建 EGL 项目时,会自动创建名为 EGLService.egldd 的部署描述符文件。然后,创建服务时您选中了创建为 Web Service 复选框,这会自动将该服务添加至部署描述符。在本节中,您将验证这些设置。
  1. 在“项目导航器”视图中,展开 EGLService 项目和 EGLSource 文件夹。通过双击 EGLService.egldd 文件来打开 EGL 部署描述符文件。
  2. 在 EGL 部署描述符编辑器中,单击 Web Service 部署选项卡。
  3. 确保服务显示在要部署为 Web Service 的服务的列表中,如下图中所示:
    EGL 部署描述符文件,其中显示 Web Service 绑定信息
  4. 关闭部署描述符文件。
  5. 双击该项目的构建描述符以在构建部件编辑器中打开该构建描述符。 此文件名为 EGLService.eglbld,并且位于项目的 EGLSource 文件夹中。构建描述符文件包含构建描述符选项,这些选项描述 EGL 如何将项目生成为输出语言。
  6. 在构建描述符选项列表中,查找名为 deploymentDescriptor 的选项。 请注意,它被设置为部署描述符的名称,缺省情况下与项目同名。必须以此方式引用该部署描述符,才能使用该部署描述符。 构建部件编辑器如下所示:
    构建部件编辑器,其中显示设置为部署描述符名称的 deploymentDescriptor 选项
  7. 关闭构建描述符。
  8. 通过在 Project Explorer 视图中右键单击该项目然后单击生成来生成整个项目。

生成 WSDL 文件

WSDL 文件会将有关服务的信息传送至客户机,以描述服务中提供的功能并指定服务的位置。在本节中,您通过该服务生成了 WSDL 文件。稍后客户机应用程序将导入此 WSDL 文件并使用其中的信息。

EGL 使用部署描述符文件中的信息和服务部件本身来生成 WSDL 文件,但它还需要一条信息:服务器将在哪个端口上主管该服务。缺省情况下,该端口为 9080。遵循下列步骤以找出服务器的端口号:

  1. 打开“服务器”视图。 如果找不到“服务器”视图,请单击窗口 > 显示视图 > 服务器。
  2. 右键单击名为 WebSphere Application Server V6.1 的服务器,并通过在弹出菜单中单击启动来启动该服务器。 根据系统不同,服务器可能要花一些时间来启动。
  3. 等待直到服务器在其状态字段中显示已启动,如以下图中所示:
    显示服务器已启动的“服务器”视图
  4. 服务器启动后,在“服务器”视图中右键单击该服务器,然后单击运行管理控制台而不是“运行管理脚本”。 管理控制台将在编辑器中打开。
  5. 在管理控制台的左边,展开服务器并单击应用程序服务器。 服务器显示为应用程序服务器下的列表,如下图中所示:
    管理控制台中的服务器列表
  6. 在名称列中单击服务器名称。
  7. 在描述服务器的页面上,单击配置选项卡。
  8. 在“配置”选项卡上的通信下,单击端口链接。
  9. 在端口列表中,单击其端口名称标注为 WC_defaulthost 的端口。
  10. 在描述此端口的页面上的端口字段中写下该端口号。 在此图中,端口号为 9082。
    显示该端口号的管理控制台
  11. 关闭管理控制台而不做任何更改。
  12. 在顶部菜单中,单击窗口 > 首选项...。在左面板中,展开 EGL 并单击服务。
  13. 如果端口字段输入与管理控制台中的服务器端口号不匹配,请在此处输入控制台中的端口号。 窗口如下所示:
    “服务首选项”对 WSDL 生成显示的端口号与服务器所用的端口号相同。
  14. 单击完成。
  15. 在 Project Explorer 视图中,右键单击 HelloService.egl 文件(该文件在 EGLSource 文件夹的服务包中),然后单击 EGL 服务 > 生成 WSDL 文件。
  16. 在“创建 WSDL 文件”窗口中,单击完成。 EGL 在 EGLSource 文件夹的 wsdl 包中创建 WSDL 文件,并以图形方式在 WSDL 编辑器中显示该文件。
  17. 检查 WSDL 文件的图形表示法并在完成时关闭该文件。
现在您已配置该服务以供其他应用程序在运行时使用。WSDL 文件描述该服务,以便客户机可在运行时连接至该服务,并且部署描述符文件允许 EGL 在运行时使该服务可用。

在真实世界中,服务以独立于使用这些服务的客户机的方式运行。要模拟此情况,可创建应用程序服务器的新实例并在该实例上运行该服务。对于本教程,消耗这些额外资源并无好处,所以,在测试客户机时,您将在现有应用程序服务器上运行该服务。

< 上一课 | 下一课 >