< 上一课 | 下一课 >

第 2 课:建立工作空间

在编写逻辑之前,请创建两个 EGL 项目并导入 Dojo 样本。

EGL 应用程序按一个或多个项目进行组织,每个项目都是工作空间中的一个物理文件夹。项目中包含一个已为您提供的 EGL 源文件夹,该文件夹中包含一个或多个,这些包中又包含 EGL 源文件。以下层次结构是您使用 EGL 进行工作的基础:项目,EGL 源文件夹,然后是包含 EGL 源文件的包。

EGL 源文件中包含 EGL 部件,这些 EGL 部件是您创建的类型定义。例如,服务部件中包含逻辑,而记录部件可以是您在服务部件中声明的变量的基础。

包很重要,因为它们将部件分成不同的场景或名称空间
  • 部件名称可在两个不同的包中重复出现,并且任何 EGL 源代码可以准确引用每个部件。使用名称空间的主要好处在于,不同的团队可以开发不同的 EGL 部件,而不会导致名称冲突。
  • 所给定包中的每个部件名称在该包中是唯一的:
    • 通过指定部件名称,一个包中的部件就很容易引用同一个包中的另一个部件。例如,以下是对基于记录部件 MyRecordPart 的记录的声明:
      myRecord MyRecordPart{};
    • 通过指定包名和部件名称,或者通过涉及到导入该部件的快捷方式,一个包中的部件还可以引用另一个包中的部件。本教程提供了一些示例。

一个项目可以引用另一个项目中的部件,但是仅当进行引用的项目的 EGL 构建路径标识所引用项目时才能引用。本教程又提供了一些示例。但是,在所有情况下,应避免在不同的项目中使用同一包名,因为使用同一包名可能会导致名称解析发生问题。

在本教程中,下一项任务是创建下列项目:
MortgageServiceProject
用于保存 EGL 服务部件及相关定义
MortgageUIProject
用于保存 Rich UI 处理程序和相关定义

虽然您可以将所有代码都包括在单个项目中,但是,以下显示的分区的内容使您很容易以不同方式来部署两种代码。

创建 EGL 服务项目

  1. 如果您位于除 EGL 透视图之外的工作台透视图中,那么通过单击窗口 > 打开透视图 > [其他] > EGL 切换到 EGL 透视图。 此透视图的图标位于工作台的右上角。
    EGL 图标指示 EGL 透视图,显示在选项卡上的“最小化”、“最大化”和“关闭”图标下方。
  2. 单击文件 > 新建 > EGL 项目,或者单击菜单栏上的新建 EGL 项目图标。
    “新建项目”图标是菜单栏上的第二组图标(总共四个图标)中的第一个图标。
  3. 在“EGL 项目”窗口中输入以下信息:
    1. 项目名称字段中输入以下名称:
      MortgageServiceProject
    2. EGL 项目类型部分,单击常规项目
      具有项目名称“MortgageServiceProject”的“新建 EGL 项目”窗口。
    3. 单击下一步
  4. 在第二个“EGL 项目”窗口中,EGL 提供的缺省值应当正确。请验证以下信息:
    1. 目标运行时平台为 Java。 此设置指示 EGL 将根据 EGL 服务部件来生成 Java 源代码。
    2. 构建描述符选项下,已选中创建构建描述符单选按钮。构建描述符将控制 Java 源代码的生成过程。因为您正在为服务创建单独的项目,所以您可以使用 EGL 为您创建的缺省构建描述符。
  5. 单击完成
EGL 将创建一个名为 MortgageServiceProject 的项目。请注意目录中的文件夹:
EGLSource
将包和源文件保存在此文件夹中。
EGLGen/JavaSource
EGL 将它生成的 Java 文件保存在此文件夹中。
JavaSource
将定制的任何 Java 源文件保存在此文件夹中。在生成过程中未覆盖这些文件。
JRE 系统库
EGL 对支持 Java 运行时环境的 JAR 文件使用此文件夹。
“项目资源管理器”视图将显示新项目和文件夹。

创建 EGL Rich UI 项目

  1. 单击菜单栏上的新建 EGL 项目图标。
  2. 在“新建 EGL 项目”窗口中输入以下信息:
    1. 项目名称字段中输入以下名称:
      MortgageUIProject
    2. EGL 项目类型部分,单击 Rich UI 项目
      具有项目名称“MortgageUIProject”的“EGL 项目”窗口。
    3. 单击下一步
  3. 在第二个“EGL 项目”窗口中,EGL 提供的缺省值应当正确。请验证以下信息:
    1. 已选中对项目使用缺省位置
    2. 窗口小部件库列表中包含下列项目:
      • EGL Rich UI 窗口小部件
      • EGL Dojo 窗口小部件
    3. EGL 项目功能部件组中,已选中创建 EGL 部署描述符
  4. 单击下一步
  5. EGL 设置页面上,选择 MortgageServiceProject 已将服务项目添加至新项目的构建路径,以便 UI 项目可以使用在此服务项目中定义的部件。
  6. 单击完成
EGL 将创建一个名为 MortgageUIProject 的项目,并将支持项目添加至 Rich UI、Dojo 窗口小部件和 Dojo 运行时库的工作空间。除了 EGL 为常规项目创建的目录以外,Rich UI 项目包括以下目录:
WebContent
包含支持文件,例如,级联样式表 (CSS) 和图像。
“项目资源管理器”视图将显示新项目和文件夹。

导入 EGL Dojo 窗口小部件样本

  1. 从工作台的顶部菜单中,单击帮助 > 帮助内容
  2. 在“帮助内容”中,展开样本 > 技术样本 > EGL,并单击 EGL Dojo 窗口小部件
    已展开的“样本”菜单。
  3. 在“内容”窗格中,单击获取样本
    “内容”窗格
  4. 在“导入”窗口中,缺省值正确。单击完成
已将最新版本的 com.ibm.egl.rui.dojo.samples 项目添加至工作空间。
“项目资源管理器”视图中的 Dojo 样本项目。

更改 MortgageUIProject 的构建路径

EGL 构建路径用于确定在尝试解析逻辑中的引用时 EGL 将检查的项目。要添加您刚导入的项目,请完成下列步骤:

  1. 在“项目资源管理器”视图中,右键单击 MortgageUIProject,然后单击属性。在“MortgageUIProject 的属性”窗口的左侧,单击 EGL 构建路径 EGL 将在您的工作空间中显示项目列表。
  2. 选择 com.ibm.egl.dojo.samples 项目。 您不需要选择 com.ibm.egl.dojo.widgets 项目,因为此项目已经存在于 com.ibm.egl.dojo.runtime.local 项目的构建路径中。已完成的“构建路径”窗口看起来应类似于下图:
    所选择的五个项目中的四个项目。
    所作的这些选择意味着,当您对用于向程序提供其他详细信息的 import 语句进行组织时,EGL 将在所选择的所有项目中查找以解析引用。
  3. 单击确定

课程复习要点

在本课程中,您已完成下列任务:
  • 为抵押贷款服务创建了一个 EGL 项目
  • 为 Rich UI 应用程序创建了一个 EGL 项目
  • 已导入 EGL Dojo 样本项目
  • 已调整第二个项目的 EGL 构建路径

在下一课中,您将创建一项专用服务来计算每月的抵押贷款还款金额。

< 上一课 | 下一课 >

反馈