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

第 3 课:创建 EGL 服务客户机

下一步是创建客户机项目以使用该服务。您在本教程中创建的客户机处于同一工作空间中时,可认为它在完全独立的位置或在另一平台上。因为服务和客户机不必以同一代码语言编写,所以还可认为此客户机应用程序以另一语言编写或使用完全不同的一组工具创建。

演示

  1. 单击文件 > 新建 > 项目。
  2. 展开 EGL 并单击 EGL 项目。
  3. 单击下一步。
  4. 将新 EGL 项目命名为 EGLClient。
  5. 单击 Web 项目。
  6. 单击下一步。
  7. 确保已选择创建新的构建描述符。 除非使用 WAS 并且先前已将设置更改为禁止将项目添加至 EAR,否则不必更改高级设置。
  8. 您可能会看到一个窗口询问您是否要切换至 J2EE 透视图。如果看到此窗口,请单击否。

创建客户机 Web 页面

为使用该服务,您将在客户机中创建 Web 页面来检索输入、将该输入传递至服务并显示来自服务的输出。您将创建 JSF 处理程序(用于控制 Web 页面的一种 EGL 逻辑部件类型),然后 EGL 将创建 Web 页面来支持此 JSF 处理程序。
  1. 在 Project Explorer 视图中,单击 EGLClient 项目以选择该项目。
  2. 单击文件 > 新建 > 其他。
  3. 展开 EGL 并单击 JSF 处理程序。
  4. 单击下一步。
  5. 在“新建 EGL JSF 处理程序”窗口中,确保源文件夹字段已设置为项目的 EGLSource 文件夹:
    EGLClient\EGLSource
  6. 在包字段中,输入以下名称:
    jsfhandlers
  7. 在 EGL 源文件名称字段中,输入以下名称:
    ClientPage
    窗口如下所示:
    “新建 EGL JSF 处理程序”窗口
  8. 单击完成。 “新建 JSF 处理程序”将在编辑器中打开。

    直到指示信息要求您保存该文件时才进行保存。保存 JSF 处理程序时,EGL 会检查 view 属性中引用的 Web 页面是否存在。 如果不存在,那么 EGL 会创建该文件,并根据 JSF 处理程序中的变量以及这些变量的 DisplayUse 属性自动添加字段。如果在添加所有变量之前保存了该文件,那么新的 Web 页面不会包括所有这些变量。如果出现这种情况,那么可删除 JSP 文件(而不是 JSF 处理程序文件)并再次生成 JSF 处理程序以获取新 Web 页面。

  9. 从新 JSF 处理程序中除去样本代码以便仅保留以下内容:
    package jsfhandlers;
    
    handler ClientPage type JSFHandler
       {view = "jspLocation/jspName.jsp"}
       
    end
  10. 按此示例中所示将 view 属性的值设置为 ClientPage.jsp:
    {view = "ClientPage.jsp"}
  11. 在 JSF 处理程序中,创建以下变量:
    name string {DisplayUse = input};
    city string {DisplayUse = input};
    output string {DisplayUse = output};
  12. 在变量之下添加以下函数:
    function getHello()
    
    end
    稍后会对此函数添加代码。 JSF 处理程序如下所示:
    JSF 处理程序中的代码
  13. 保存该文件。 保存该文件时,EGL 会根据该文件自动创建 Web 页面。此文件使用 view 属性的值 ClientPage.jsp 命名,并且该文件将放在项目的 WebContent 文件夹中。
    如果未获取 JSP 文件,那么 EGL 不会配置为自动生成 JSF 处理程序部件。通过在 Project Explorer 视图或 EGL 编辑器中右键单击 JSF 处理程序然后单击生成来手动生成 JSF 处理程序。然后,遵循下列附加步骤来设置 JSF 处理程序的自动生成:
    1. 单击窗口 > 首选项。
    2. 在“首选项”窗口中,展开 EGL,然后单击生成。
    3. 在“生成”页面上,选中处理程序复选框。
    4. 单击确定。

    现在,JSF 处理程序将在您保存它们时自动生成。

  14. 在编辑器中打开 ClientPage.jsp 文件。 此页面上的字段基于您在 JSF 处理程序中创建的变量。这些字段已预先绑定至这些变量。这样一来,页面上的这些字段的值更改时,这些变量也将更改以便匹配。同样,JSF 处理程序中的变量的值更改时,页面上的字段的值也将更改以便匹配。

    此页面还有若干错误消息字段。这并非意味着页面有错误;如果运行时存在任何错误,那么这些字段将在页面上显示错误。

  15. 查找“页数据”视图。如果找不到此视图,请单击窗口 > 显示视图 > 页数据。此视图显示提供给页面的数据,包括您在 JSF 处理程序中创建的变量。它还会显示 JSF 处理程序中的函数。
  16. 在“页数据”视图中,展开 JSF 处理程序 > 操作并查找 getHello() 函数。
  17. 将 getHello() 函数从“页数据”视图直接拖到页面底部。 页面上将出现绑定至该函数的按钮。用户在运行时按页面上的该按钮时,JSF 处理程序中的该函数将运行。
  18. 保存该页面。
该页面如下所示:
客户机 Web 页面的外观

现在 Web 页面已准备好使用 Web Service。在下一课中,您会通过此 Web 页面将项目设置为充当服务的客户机。

< 上一课 | 下一课 >