对 IBM Lotus Notes V8 和 IBM Lotus Sametime V7.5.1 使用 IBM Lotus Expeditor Toolkit V6.1.1

文档选项 未显示需要 JavaScript 的文档选项 讨论 英文原文

级别： 中级

Pierre Carlson, 开发人员, IBM

2009 年 4 月 28 日

通过本文，您将开始使用 IBM Lotus Expeditor Toolkit 为 IBM Lotus Notes V8 和 IBM Lotus Sametime V7.5.1 开发应用程序。您将了解可选择的安装选项、如何配置这个工具箱以及如何在目标环境中启动示例应用程序。

如您所知，IBM Lotus Notes V8 和 IBM Lotus Sametime V7.5 是在 IBM Lotus Expeditor V6.1 平台上构建的。因此，许多相同的应用程序可以在所有这些平台上运行。对于 Java、J2EE 和 Eclipse RCP 开发人员，这意味着通过使用 Lotus Expeditor Toolkit，可以使用已经掌握的相同的工具和技能为 Lotus Notes、Lotus Sametime 和 Lotus Expeditor 构建应用程序。在本文中，学习如何结合使用 Lotus Expeditor Toolkit 与 Eclipse 集成开发环境（IDE）或 IBM Rational Application Developer for WebSphere Software 为 Lotus Notes 和 Lotus Sametime 构建和测试 Java 和 J2EE 应用程序。关于 Lotus Expeditor Toolkit 和 Lotus Expeditor 平台开发的一般性概述，请参考 developerWorks 文章 “IBM Lotus Expeditor Toolkit V6.1.1 入门”。

谁应该使用这个工具箱？

Lotus Expeditor Toolkit 是供 Java、Eclipse RCP 和 J2EE 开发人员使用的。通过使用这个工具箱提供的工具，可以重用您现有的技能和资源来部署现有的应用程序，或者为目标运行时环境构建新的应用程序。尽管环境与 IBM Lotus Domino Designer 的环境很不一样，但是 Lotus Domino 开发人员可以使用这个工具箱编写 Java 应用程序与现有的基于 NSF 的应用程序进行交互。Lotus Sametime 开发人员可以通过 Lotus Expeditor Toolkit 继续使用现有的项目，并利用这个工具箱提供的简化的配置和启动功能。

回页首

下载

可以从 developerWorks Lotus Toolkits 页面 下载 Lotus Expeditor Toolkit V6.1.1 的一个免费版本。下载的文件包含一个更新站点，可以安装在基于 Eclipse 3.2.2 或更高版本的 IDE 中，比如 IBM Rational Application Developer for WebSphere Software V7.0.0.2。

回页首

先决条件

Lotus Expeditor Toolkit 至少需要 Eclipse 3.2.2。对于大多数功能，包括本文中使用的示例，还应该安装 Eclipse Web Tools Platform（WTP）1.5.4。可以从 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 software 补丁包。见表 1。

回页首

Lotus Notes V8 开发人员

在本节中，讨论针对 Lotus Notes 时的配置和启动。如果您只为 Lotus Sametime 进行开发，那么可以跳到后面的 “Lotus Sametime V7.5 开发人员” 一节。

配置 Lotus Notes JRE

在安装 Lotus Expeditor Toolkit 之前，需要配置 Lotus Notes V8 JRE 以使用这个工具箱。启动您打算使用的 IDE 环境（Eclipse、Rational Application Developer 等等），然后执行以下步骤：

1. 选择 Window – Preferences – Java – Installed JREs。
2. 单击 Add。
3. 在 Add JRE 窗口中，执行以下步骤：
   
   • 将 JRE Type 设置为 Standard VM。
   • 输入 Notes 8 VM 作为 JRE Name。
   • 单击 Browse 按钮，找到并选择位于 <Notes_Install>\framework\rcp\eclipse\plugins\
     com.ibm.rcp.j2se.win32.x86_1.5.0.SR4-200707311521\jre 的 jre 目录，然后单击 OK。
4. 单击 OK，然后再次单击 OK。

在执行步骤 4 之前，完成的配置应该像图 1 这样。

现在可以安装工具箱了。

安装工具箱

下载 Lotus Expeditor Toolkit ZIP 文件之后，将文件解压到一个临时位置。可以在浏览器中打开 autorun.html 文件，查看工具箱安装说明、版本说明和其他文档。

Lotus Expeditor Toolkit 分为四个特性，这些特性属于两类，见图 2。桌面类包含 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。在为 Lotus Notes V8 进行开发时，只需要安装 Lotus Expeditor Toolkit 6.1.1.20070731 特性。

当安装过程完成时，系统提示重新启动平台。单击 OK。

配置工具箱

重新启动 IDE 平台之后，出现 Toolkit Configuration 对话框。可以按照以下步骤配置 IDE 环境。最终的设置见图 3。

1. 在 Test Environment 下拉框中选择 Lotus Notes 8。
2. 单击 Browse，然后选择 <Notes_Install>\framework\eclipse 目录并单击 OK。
3. 在 VM Name 下拉框中选择 Notes 8 VM。
4. 单击 OK。

还建议在 Auto-Configuration Preference 对话框中选择 “Attempt to configure the toolkit the first time a workspace opens” 选项。这会让配置对话框只在工作空间中第一次使用工具箱时出现。如果需要，以后可以通过选择 Window – Preference – Client Services 修改这个首选项。在单击 OK 时，针对 Lotus Expeditor Client for Desktop 开发重新配置 IDE。

现在就可以开始开发在 Lotus Notes V8 中运行的 Lotus Expeditor 和 J2EE 应用程序和组件了。

导入示例

Lotus Expeditor Toolkit 提供了许多能够在 Lotus Expeditor 和 Lotus Notes V8 环境中运行的示例。在使用 Rational Application Developer 时，可以使用 Samples Gallery 导入示例。从 Rational Application Developer 启动 Samples Gallery 的方法是选择 Help - Samples Gallery。Samples Gallery 显示在一个新窗口中。Lotus Expeditor 示例出现在 Samples Gallery 的 Showcase samples、Application samples 和 Technology samples 部分中。

现在解释一下在只使用 Eclipse IDE 的情况下如何导入示例。在安装工具箱时会安装这些示例，需要将它们导入工作空间。按照以下步骤将属性代理示例导入 IDE 工作空间。

1. 选择 File – Import – General – Existing Projects into Workspace，然后单击 Next。
2. 选择 Select archive file 选项，然后单击 Browse。
3. 使用 Browse 对话框选择属性代理示例。这个示例存档位于 <toolkit_install>\plugins\
   com.ibm.rcp.tools.samplegallery2_6.1.1.20070731\archive\propertybroker.jar。
4. 单击 Open，然后单击 Finish。

属性代理示例导入工作空间，见图 4。

启动工具箱

Lotus Expeditor Toolkit 提供一个预配置的定制启动器，可以用它启动 Lotus Notes，不需要额外的配置设置。这个启动器名为 Client Services，访问它的方法是在 IDE 菜单中选择 Run - Run。选择左面板中的 Client Services launcher，然后单击 New 按钮。这会创建 Client Services 启动器的一个新实例，见图 5。

如果选择启动配置的 Target 附签（见图 6），就会看到已经选择了 Lotus Notes V8 目标。因为在任何时候只能运行一个 Lotus Notes 实例，所以在从 IDE 启动之前应该关闭 Lotus Notes。单击 Run 按钮启动 Lotus Notes V8 平台。

登录 Lotus Notes 之后，会看到常规的 Lotus Notes 工作空间。

如果按照前面的说明导入了属性代理示例，现在就可以从 Lotus Notes Open 菜单启动这个示例。选择 Open – Property Broker Color Sample。打开这个示例之后，双击左边的一种颜色名称，就会使右边的视图变成这种颜色。视图之间的通信是使用属性代理组件实现的，这个组件是 Lotus Expeditor 平台的一部分，因此可以在 Lotus Notes V8 中使用。见图 7。

回页首

Lotus Sametime V7.5.1 开发人员

安装工具箱

下载工具箱 ZIP 文件之后，将文件解压到一个临时位置。可以在浏览器中打开 autorun.html 文件，查看工具箱安装说明、版本说明和其他文档。

Lotus Expeditor Toolkit 分为四个特性，这些特性属于两类，见图 8。桌面类包含 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。在为 Lotus Sametime V7.5.1 进行开发时，要安装 Lotus Expeditor Toolkit 6.1.1.20070731 特性和 Lotus Expeditor Development Runtimes VM 6.1.1.200707311521 特性。这会安装工具箱和运行 Lotus Sametime 所需的虚拟机。

当安装过程完成时，系统提示重新启动平台。单击 OK。

配置工具箱

重新启动 IDE 平台之后，出现 Toolkit Configuration 对话框。可以按照以下步骤配置 IDE 环境。最终的设置见图 9。

1. 在 Test Environment 下拉框中选择 Lotus Sametime。
2. 单击 Browse，然后在 Target Location 框中选择 IBM Lotus Sametime Connect 安装目录（即 C:\Program Files\IBM\Sametime Connect）并单击 OK。
3. 在 VM Name 下拉框中选择 jclDesktop Win32 x86（如果运行 Linux，那么选择 jclDesktop Linux x86）。
4. 单击 OK。

还建议在 Auto-Configuration Preference 对话框中选择 “Attempt to configure the toolkit the first time a workspace opens” 选项。这会让配置对话框只在工作空间中第一次使用工具箱时出现。以后可以通过选择 Window – Preference – Client Services 在任何工作空间中修改这个首选项。在单击 OK 时，针对 Lotus Expeditor Client for Desktop 开发重新配置 IDE。

导入示例

尽管 Lotus Expeditor Toolkit 为 Lotus Sametime 提供了许多示例，但是我们使用来自 Lotus Sametime V7.5.1 SDK 的 Recent Buddies 示例。如果您还没有安装 Lotus Sametime V7.5.1 SDK，那么可以从 developerWorks Lotus Toolkits 页面 下载它。下载 SDK 并将它解压到本地文件系统（c:\st571sdk）。

按照以下步骤导入这个示例：

1. 选择 File – Import – General – Existing Projects into Workspace，然后单击 Next。
2. 选择 Select archive file 选项。
3. 单击 Browse。
4. 找到并选择 <SDK>\ client\connect\samples 目录中的 com.ibm.collaboration.realtime.sample.recentbuddies_7.5.1.jar 文件。
5. 单击 Finish（见图 10）。

启动工具箱

Lotus Expeditor Toolkit 提供一个定制启动器，可以用它启动 Lotus Sametime，不需要额外的配置设置。这个启动器名为 Client Services，访问它的方法是在 IDE 菜单中选择 Run - Run。选择左面板中的 Client Services launcher，然后单击 New 按钮。这会创建 Client Services 启动器的一个新实例，见图 5。如果选择启动配置的 Target 附签，就会看到已经选择了 Lotus Sametime 目标。单击 Run 按钮启动 Lotus Sametime 平台和示例应用程序，见图 11。

回页首

在 Lotus Sametime、Lotus Notes 和 Lotus Expeditor 之间转移组件

因为用 Lotus Expeditor Toolkit 构建的许多组件和应用程序可以部署在任何基于 Lotus Expeditor 的平台上（即 Lotus Notes V8、Lotus Sametime V7.5.1 和 Lotus Expeditor V6.1），所以工具箱支持在环境之间转移组件。如果希望改变工具箱的配置，可以通过选择 Window - Preferences - Client Services 访问配置首选项。在这个页面上，可以将环境重新配置为支持的任何环境。单击 Configure 按钮，然后使用与启动时相同的对话框修改 IDE。在保存对话框中的修改之后，Eclipse 执行更新。图 12 显示在 Lotus Notes V8 侧栏中运行的 Lotus Sametime Recent Buddies 示例和嵌入的 Lotus Sametime。

回页首

结束语

本文讨论了为 Lotus Notes V8 和 Lotus Sametime V7.5.1 安装并配置 Lotus Expeditor Toolkit 的过程。还讨论了如何配置环境、导入示例应用程序和使用目标运行时环境启动应用程序。关于 Lotus Expeditor Toolkit 的项目类型和高级特性的更多信息，请参考 developerWorks 文章 “IBM Lotus Expeditor Toolkit V6.1.1 入门”。

参考资料

• 阅读 developerWorks Lotus 文章，“IBM Lotus Expeditor Toolkit V6.1.1 入门”。
  
  
• 阅读 developerWorks Lotus 文章，“使用普及消息传递和 IBM Lotus Expeditor 微代理（micro broker）实现端到端的集成”。
  
  
• 阅读 developerWorks Lotus 文章，“在 IBM Lotus Expeditor 中构建脱机应用程序”。
  
  
• 阅读 developerWorks Lotus 文章，“使用 IBM Lotus Expeditor V6.1 在桌面和移动设备上开发并部署富客户机应用程序”。
  
  
• 阅读 developerWorks Lotus 文章，“Migrating Eclipse RCP applications to IBM Lotus Expeditor”。
  
  
• 阅读 developerWorks Lotus 文章，“为 IBM Lotus Expeditor Property Broker 创建协作组件”。
  
  
• 阅读 IBM Redbook， Building Composite Applications in Lotus Expeditor V6.1 。
  
  
• 访问 developerWorks Lotus Expeditor 页面。
  
  
• 访问 Lotus Notes 8 的可编程性。
  
  
• 访问 IBM Lotus Sametime Gateway。
  
  
• 参考 IBM Lotus Expeditor 文档页面。
  
  

• 下载 IBM Lotus Expeditor Toolkit V6.1.1 的试用版。
  
  
• 下载 IBM Callisto Package。
  
  

• 参与论坛讨论。
  
  
• 参与 developerWorks Lotus 团队博客。

关于作者

		Pierre Carlson 从 1998 年开始在 IBM Austin 的系统和应用程序开发方面担任过各种开发和领导角色。作为 Lotus Expeditor Toolkit 的架构师，他领导了该产品未来版本的设计和规划工作。在此之前，Pierre 是 WebSphere Everyplace Client Toolkit 和 WebSphere Everyplace Deployment JSR-172 Web Services 运行时和工具团队的负责人，领导开发团队开发 IBM Interactive Solutions Marketplace，并开发操作系统、打印驱动程序以及其他系统。Pierre 在业余时间攻读计算机科学的硕士学位。

对本文的评价

太差！ (1) 需提高 (2) 一般；尚可 (3) 好文章 (4) 真棒！(5) 将您的建议发给我们或者通过参加讨论与其他人分享您的想法.

回页首