内容


IBM Lotus Expeditor Toolkit V6.1.1 入门

Comments

IBM Lotus Expeditor Toolkit 提供了一个完整的、综合的工具集,允许您开发、调试、测试、打包客户机应用程序,并将其部署到 IBM Lotus Expeditor V6.1.1、IBM Lotus Sametime V7.5.1 和 IBM Lotus Notes V8 中。您可以使用该工具箱开发以下类型的客户机应用程序:

  • Eclipse Rich Client Platform (RCP) 应用程序(仅限桌面客户机)
  • Eclipse 嵌入式富客户机平台应用程序
  • Web 应用程序
  • 嵌入式事务处理应用程序
  • Portlet 应用程序(仅限桌面客户机)
  • 数据库应用程序
  • 消息传递应用程序
  • Web 服务应用程序

工具箱提供的向导使您能够创建 Client Services 项目来开发客户机应用程序。工具箱使用目标定义提供了一种方便的方法,使您能够指定运行时环境、构建时环境以及一组可在该平台上运行的组件。例如,当创建一个 Client Services 项目后,从可用目标列表中选择一个目标定义,然后从目标定义中的列表选择一组特性。工具箱使用该信息为项目自动建立 Java 构建路径和运行时。之后,您可以对项目进行编辑、编译和调试。工具箱提供了默认的目标定义列表;但是,您还可以创建自己的定义。

谁应该使用该工具箱?

Lotus Expeditor Toolkit 专门针对 Java、Eclipse RCP 和 J2EE 开发人员而开发。使用该工具箱提供的工具,您可以重用已有的技能和资源部署现有应用程序,或者为您的目标运行时环境构建新的应用程序。

下载

可以从 developerWorks Lotus Toolkits 页面 下载获得 Lotus Expeditor Toolkit V6.1.1 的未授权且不受支持的版本。下载得到的文件包含一个更新站点,可安装到基于 IDE 的现有的 Eclipse 3.2.1 或更高版本,包括 WebSphere Software V7.0 的 IBM Rational Application Developer。

先决条件

最低需求情况下,Lotus Expeditor Toolkit 需要使用 Eclipse 3.2.1。对于大多数功能,包括本文使用的示例功能,您还应该安装 Eclipse Web Tools Platform (WTP)。可从 Eclipse 中预定义的 Callisto Discovery 站点安装。如果您还没有安装某个 Eclipse 版本和 Eclipse Web Tools Platform,则可以从 IBM Callisto Simultaneous Release 项目页面 下载并安装 Eclipse 的 Java EE 项目包。Java EE 项目包结合 Lotus Expeditor Toolkit 提供了开发面向 Lotus Expeditor 的 Java、Web 和 Web 服务应用程序所需的所有内容。仅使用 Eclipse Callisto (3.2.2)、WTP 和工具箱即可创建大多数应用程序类型。如果要创建嵌入式事务处理应用程序或 portlet 应用程序,则需要安装 Rational Application Developer V7.0。如果您还不是 Rational Application Developer 用户,则可以下载并安装 该软件的评估版。在 Rational Application Developer 中安装 Lotus Expeditor Toolkit 之前,确保将 Rational 软件更新到最新版本的补丁。

表 1. 需要使用的软件
应用程序类型或所需功能Lotus Expeditor Toolkit 的最低软件需求
标准 Java 和 Eclipse RCP 和 eRCP Eclipse 3.2.2
Web Application Java、JSP、ServletEclipse 3.2.2 和 Eclipse Web Tools Platform 1.5.4
Web Application Portlet 嵌入式事务容器 Rational Application Developer V7.0.0.2 或 IBM Rational Software Architect V7.0.0.2

安装

下载工具箱 ZIP 文件之后,在一个临时位置解压该文件。要访问工具箱安装说明、版本说明和其他文档,在浏览器中打开 autorun.html 文件。如图 1 所示,Lotus Expeditor Toolkit 被划分为四个特性,归为两个类别。桌面类别包括 Lotus Expeditor Toolkit 6.1.1.20070731、Lotus Expeditor Development Runtimes VM 6.1.1.200707311521 和 Lotus Expeditor Development Runtimes 6.1.1.200707311521。设备类别包括 Lotus Expeditor Tooling for Devices 6.1.1.0-20070626。

图 1. Lotus Expeditor Toolkit V6.1.1 更新站点
Lotus Expeditor Toolkit 6.1.1 更新站点
Lotus Expeditor Toolkit 6.1.1 更新站点

根据您的目标运行时环境,可以安装这几个特性的不同组合。最基本的特性是 Lotus Expeditor Toolkit V6.1.1 特性。它包含核心工具,所有开发人员都应该安装该特性。Lotus Expeditor Development Runtimes VM 6.1.1 包含 jclDesktop 的一个版本,可将它与 Lotus Expeditor for Desktop 和 Lotus Sametime V7.5.1 结合使用。Lotus Expeditor Development Runtimes 6.1.1 包含 Lotus Expeditor for Desktop 客户机运行时的一个版本,可用来通过 Lotus Expeditor Toolkit 构建和测试代码。如果要开发设备应用程序,则应安装 Lotus Expeditor Tooling for Devices 6.1.1.0。该特性包含设备客户机的一个 win32 版本,可用来在 Windows 桌面平台上构建和调试应用程序。确定了需要安装的特性后,执行 autorun.html 文件提供的详细的安装说明。考虑到本文及后续文章的目的,建议您安装桌面类别中所有三个工具箱特性。无论您最初的选择是什么,始终可以返回到更新站点并安装所需的其他组件。安装了 Lotus Expeditor Toolkit 并重新启动 Eclipse 后,将显示图 2 所示的配置对话框。

图 2. Toolkit Configuration 对话框
Toolkit Configuration 对话框
Toolkit Configuration 对话框

配置

要开发面向 Lotus Expeditor for Desktop 的应用程序,在 Test Environment 选项中选择 Lotus Expeditor for Desktop。这样做将把目标平台默认设置为工具箱提供的 Lotus Expeditor for Desktop 版本。此外,将选择 jclDesktop VM,并将编译器遵从性级别设置为 1.4。

要开发面向 Lotus Expeditor for Devices 的应用程序,在 Test Environment 选项中选择 Lotus Expeditor for Devices。只有在安装了 Lotus Expeditor Tooling for Device 特性后该选项才可用。这些做将把目标平台默认设置为工具箱提供的 Lotus Expeditor for Devices 版本。同时选择 jclDevice VM,并将编译器遵从性级别设置为 1.4。

注意:您可以在 Linux 上为设备平台开发代码;然而,不能在这些系统中运行平台。您必须创建一个更新站点,其中具有希望安装的特性,并将特性部署到设备中。在针对 Lotus Expeditor for Devices 平台进行开发时,推荐使用 Windows XP 平台。

同样建议您在 Auto-Configuration Preference 对话框中选择 “Attempt to configure the toolkit the first time a workspace opens” 选项。该选项的作用是,只有在工作区中首次使用工具箱时才显示配置对话框。您稍后可以在任何工作区中修改该参数。单击 OK 后,将针对 Lotus Expeditor for Desktop 开发重新配置 Eclipse IDE。

如果针对 Lotus Notes V8 或 Lotus Sametime V7.5.1 进行开发,遵循 Lotus Expeditor for Desktop 配置说明进行设置。该过程将完成本文带来的工具箱概览之旅。

Toolkit 参数选择

如果希望稍后修改工具箱的配置,通过选择 Window - Preferences - Client Services 可访问配置参数页面。在该页面中,可将环境重新配置为其他任何受支持的环境。单击 Configure 按钮,并通过启动时出现的对话框修改 IDE。将对话框中的修改保存后,将使用新的参数选择更新 Eclipse。

所构建的应用程序要在 Lotus Expeditor 上运行,必须通过 OSGi Manifest 文件向平台提供关于其内容的信息。有关 OSGi manifest 的其他信息,请参阅 Lotus Expeditor Developers Guide 中的 “Creating manifest 文件” 主题。

Lotus Expeditor Toolkit 还提供了自动管理 OSGi manifest 依赖关系的功能。(若要了解更多信息,请阅读 developerWorks 文章 “了解 Eclipse 插件如何使用 OSGi”。)默认设置自动将 Import-Package 语句作为必要内容添加到 manifest 文件。如果希望将 Require-Bundle 语句用于 manifest 依赖关系,则选择 “Give preference to Require-Bundle” 选项,并单击 OK。一般来讲,默认设置中选择 Import-Package 非常合适。有关 OSGi manifest、Require-Bundle 、Import-Package 的其他细节,请参考 Lotus Expeditor Information Center 的 “类加载” 主题。通过选择 Windows – Preferences – Client Services – Development,可稍后修改参数选择。

导入示例

Lotus Expeditor Toolkit 针对 Desktop 和 Device 应用程序提供了大量示例。在使用 Rational Application Developer 时,可以使用 Samples Gallery 导入示例。要从 Rational Application Developer 中启动示例,只需选择 Help - Samples Gallery 即可。Samples Gallery 将显示在新窗口中。在 Samples Gallery 的 Showcase 示例、Application 示例和 Technology 示例部分下,包含一些 Lotus Expeditor 示例和/或一个属于 Devices 类别的 Lotus Expeditor samples 示例,如图 3 所示。

图 3. Rational Samples Gallery 中的订单条目示例
Rational Samples Gallery 中的订单条目示例
Rational Samples Gallery 中的订单条目示例

要导入示例,在左边的窗格中选择希望导入的示例,然后在右面的窗格单击 Import the sample 选项。我们使用 Order Entry 示例(从 Showcase 示例部分选项)演示启动功能;然后导入该特性。当显示如图 4 所示的 Order Entry 示例对话框时,单击 Finish。

图 4. Import Order Entry 示例
Import Order Entry 示例
Import Order Entry 示例

示例项目被导入到工作区中。如果您已将 Eclipe 配置为针对设备客户机使用,那么需要针对 Lotus Expeditor for Desktop 重新配置环境。

如果您使用的是 Eclipse 而不是 Rational Application Developer,则可以从文件系统中导入示例。使用 Eclipse 和 Web Tools Platform 导入示例,请遵循以下步骤:

  1. 选择 File - Import - General - Existing Projects into Workspace。
  2. 单击 Next。
  3. 选择 Select archive file 选项,然后单击 Browse。
  4. 浏览至 <eclipse_install>\plugins\com.ibm.rcp.tools.samplegallery_6.1.1.<date>\archive\orderentry.jar,然后单击 Open。
  5. 检查所有项目旁边的复选框是否被选中,然后单击 Finish,如图 5 所示。
图 5. 在 Eclipse 中导入 Order Entry 示例
在 Eclipse 中导入 Order Entry 示例
在 Eclipse 中导入 Order Entry 示例

Order Entry 示例实际上是两个单独的界面示例。Order Entry Web 示例是基于 Web(JSP/servlet)的应用程序示例,可在 Lotus Expeditor Client 上本地运行。它需要使用 Rational Application Developer 或者是 Eclipse 和 Web Tools Platform (WTP) 来构建 Web 应用程序。Order Entry 示例还包括 Order Entry Rich Client 示例,该示例显示一个基于 SWT 的用户界面。示例所使用的业务逻辑可由 Web 和 Rich Client 这两个版本的示例共享。只能使用 Eclipse SDK 构建和运行 Rich Client 示例。

启动

Lotus Expeditor Toolkit 提供了一个自定义的启动程序,可用于启动 Lotus Expeditor for Desktop、Lotus Expeditor for Devices、Lotus Sametime 和 Lotus Notes。访问该启动程序的方法是从 IDE 菜单中选择 Run - Run。该启动程序被命名为 Client Services。在左边的窗格中选择 Client Services launcher,然后单击 New 按钮。这将为 Client Services 启动程序创建一个新实例,如图 6 所示。

图 6. Lotus Expeditor Toolkit Client Services 启动程序
Lotus Expeditor Toolkit Client Services 启动程序
Lotus Expeditor Toolkit Client Services 启动程序

启动程序填充了要启动经过配置的平台需要的全部选项。单击 Run 按钮启动客户机平台。Lotus Expeditor Client 启动,如果您是第一次在所选的工作区启动,则系统会要求您创建新密码;否则,您可以输入以前创建的密码。

启动 Web 版本的示例的方法是单击 Open 按钮,然后从下拉列表中选择 Order Entry Web Sample。

您将看到 Web 版本的示例的启动页面,如图 7 所示。单击 Start 按钮开始使用示例应用程序。使用 Web 用户界面创建一些新的订单。

图 7. Order Entry Web Sample 的起始页
Order Entry Web Sample 的起始页
Order Entry Web Sample 的起始页

现在启动富客户机版本的示例,方法是单击 Open 按钮并选择 Order Entry Rich Client Sample。

您将看到 Rich Client 版本的示例的启动页面。如果您在 Web 版本中创建了订单,您将看到这些订单反射到了 Rich Client 版本中,如图 8 所示。

图 8. Order Entry Rich Client Sample 的起始页
Order Entry Rich Client Sample 的起始页
Order Entry Rich Client Sample 的起始页

此时,示例的 Web 和富客户机版本都在运行。由于这两个不同的应用程序共享一组公用的后端逻辑,在其中一个用户界面中创建的订单可以反射在另一个用户界面中。您可以在这两种示例版本之间切换,通过在用户界面顶部选择不同的应用程序附签创建新的订单。

作为示例的一部分,同样提供了一个基本的 Order Entry Server。如果希望了解如何处理订单,请参考 Sample Gallery 或开发人员指南中提供的 Order Entry Sample 说明

工具箱项目

如果已经准备好创建自己的应用程序,您可以使用 Lotus Expeditor Toolkit 创建项目。工具箱提供了五种不同类型的项目,通过从 Eclipse 菜单中选择 File - New - Projects - Client Services category 可以查看这些项目。这五种项目类型分别是 Client Services Project、Client Services Web Project、Client Services Portlet Project、Client Services Embedded Transaction Project 和 Client Services Fragment Project,如图 9 所示。

图 9. Lotus Expeditor 项目类型
Lotus Expeditor 项目类型
Lotus Expeditor 项目类型

表 2 列出了项目类型的建议应用。

表 2. 项目类型及其建议应用
项目类型建议用法
Client Services 项目基本 Java 代码、使用 SWT 和 JFace 构建的用户界面、JDBC 访问,或者多数 Lotus Expeditor Java API 访问。
Client Services Fragment project本机代码包、特定于平台的代码包和属性、XML 文件等中的经过转换的内容包
Client Services Web 项目Servlets、JSPs、Axis 1.3 Web 服务客户机。
Client Services Portlet 项目JSR-168 portlets;在安装 Portlet 工具时,这些项目只能用于 Rational Application Developer。
Client Services Embedded Transaction 项目 Enterprise Java Beans (EJBs);在安装 EJB 工具时,这些项目只对 Rational Application Developer 可用。

高级选项

除了 Lotus Expeditor Toolkit 提供的默认配置外,还有一些有用的高级配置选项。Lotus Expeditor Desktop Client 和 Device Client 被设计为可以使用一些自定义配置进行配置和安装,从而满足您的需求。Lotus Expeditor Toolkit 增强了 Eclipse 的目标概念,允许您模拟开发环境中不同的客户机配置,从而匹配客户系统中安装的版本。当配置 Lotus Expeditor Toolkit for Desktop 时,工作区目标被设置为 Default Target。Lotus Expeditor Toolkit 提供了另外两种 Lotus Expeditor 配置供您使用。核心目标提供了一组 Lotus Expeditor 子集,匹配其最小工作集。Default with Embedded Sametime Target 允许您同时启动 Lotus Expeditor 和嵌入式版本的 Lotus Sametime。图 10 展示了运行 Order Entry 富客户机示例的 Lotus Expeditor Client,同时在侧栏运行嵌入式 Lotus Sametime。

图 10. 在 Lotus Expeditor 中同时运行 Order Entry 富客户机示例和嵌入式 Lotus Sametime
在 Lotus Expeditor 中同时运行 Order Entry 富客户机示例和嵌入式 Lotus Sametime
在 Lotus Expeditor 中同时运行 Order Entry 富客户机示例和嵌入式 Lotus Sametime

所使用的目标可以在不同的位置选择。要为工作区设置默认目标(即为新项目或新的启动配置设置),可在 Window - Preferences - Client Services - Development 参数页面设置 Default Target Selection,如图 11 所示。

图 11. 从 Clients Services – Development 页面设置工作区默认目标
从 Clients Services – Development 页面设置工作区默认目标
从 Clients Services – Development 页面设置工作区默认目标

您还可以为每个项目重写工作区的默认目标。在创建项目期间,可以在系统中选择任何可用目标。要限制选择,在 Client Services – Development 参数页面的 “Select the Targets to be available for development” 选项中,取消选择不需要的目标(参见图 11)。在创建启动配置后,通过选择启动程序的 Target 附签,您可以重写要使用的启动。

您可以使用工具箱提供的 Core 目标作为模板,创建自己的 Lotus Expeditor 自定义配置,并从工具箱中启动配置。要创建自己的目标,导入 Core 目标并使用 Eclipse 目标编辑器添加您的自定义 Lotus Expeditor 平台包含的特性。目标文件还包含一些额外的字段,不能在 Eclipse 编辑器中使用。要编辑这些字段,在文本编辑器中打开 .target 文件。请参阅 Lotus Expeditor Developers Guide 中 “Creating a Target Definition” 一节内容,以了解更多有关创建自定义目标的信息。

结束语

在本文中,您回顾了 Lotus Expeditor Toolkit 的安装和配置过程。了解了如何导入示例应用程序以及如何在嵌入式 Lotus Expeditor Test Environment 环境中启动应用程序。您还简要了解了使用工具箱创建的项目。最后,向您介绍了工具箱的一些高级特性,可以使用这些高级特性针对自定义 Lotus Expeditor 平台开发应用程序。


相关主题


评论

添加或订阅评论,请先登录注册

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Lotus, WebSphere
ArticleID=255507
ArticleTitle=IBM Lotus Expeditor Toolkit V6.1.1 入门
publish-date=09242007