在 Lotus Expeditor 上构建 IBM Lotus Sametime 让您能够使用 Eclipse 插件开发环境在多方面扩展 Lotus Sametime 功能。本文是系列文章的第一篇（共四篇），将带您了解使用 Eclipse 作为 Lotus Sametime 的 PDE 所需的配置步骤。

IBM Lotus Sametime V7.5.1 是一个可扩展的即时消息传递平台，而不仅仅是一个基于 IBM Lotus Expeditor 的客户机。Lotus Expeditor 是基于 Eclipse 开放源码和插件模型的富客户机平台，用于开发商业应用程序。

IBM Lotus Expeditor 是 IBM 的通用托管客户机软件，用于将复合应用程序扩展到膝上型电脑、台式机和移动设备上。可以用它扩展 IBM Lotus、IBM WebSphere、IBM Workplace 或 Eclipse 基础设施。Lotus Sametime 为了保持较小的内存和磁盘占用，附带了 Lotus Expeditor 全部功能的一个子集。

Eclipse 是一个基于 Java 的、开放源码的可扩展开发平台，使用它所提供的框架和服务可以构建使用插件组件的开发环境。一般说来，Eclipse 中的所有组件都是插件，平台将这些插件链接起来即可创建应用程序。同样，Eclipse 中还包含一个插件开发环境（PDE），让您能够开发自己的插件以扩展 Java IDE（集成开发环境）的功能或创建自己的应用程序。例如，如果您是一名使用 Eclipse 作为 IDE 的 Java 开发人员并且一直编写同一类型的程序包，则可以创建一个插件以扩展 IDE，使之包含一个包设置向导，利用此向导只需单击几个按钮便可为包设置通用的结构及组件。

这就为我们引入了 Lotus Sametime。Lotus Sametime V7.5.1 构建于 Lotus Expeditor 平台之上，进而也是 Eclipse 平台之上。同样，它也利用了 Eclipse 的可扩展性。您可以使用 Eclipse PDE 和 Lotus Sametime V7.5.1 软件开发工具包（Software Development Kit，SDK）创建自己的插件，为 Lotus Sametime 添加功能。例如，您可以在联系人列表下显示天气预报，或添加一个菜单选项以便在右击某人的姓名时可以指向他的位置。

Lotus Sametime SDK 包含一个 Integration Guide（其中有配置 Eclipse 平台进行插件开发的说明）和一个 Quick How To Guide（如何使用菜单和工具栏选项等常用扩展）。另外，Lotus Expeditor Toolkit 包含一个 Lotus Sametime 开发配置文件（在 PDE 中称作客户机服务），可用于消除这些设置步骤。Integration Guide 还讨论了 SDK 中的一些示例插件，它们是插件开发的起点。本文将介绍创建其中的一个示例 BuddyNote 所需的步骤。这些示例本身就是一些有用的用户工具，您可以随心所欲地使用。

开始之前

本系列文章面向的是那些有意通过开发插件以扩展 Lotus Sametime 功能的人员。读者应熟悉 Lotus Sametime 及其用法。

关于本系列

本系列文章共分四个部分，介绍了如何使用 Eclipse 平台开发 Lotus Sametime V7.5.1 插件：

• 第 1 部分（即本文）带领您了解如何配置开发 Lotus Sametime V7.5.1 插件的 Eclipse 环境。
• 第 2 部分引导您一步步地创建扩展 Lotus Sametime 用户界面的自定义插件。
• 第 3 部分演示如何使用 Eclipse 提供的工具调试插件。
• 第 4 部分展示如何部署自定义插件，让您能够通过设置 Feature 和 Update Site 项目共享您的插件。

关于本文

使用 Eclipse 开发工具创建 Lotus Sametime 插件之前，首先需要对 Eclipse 进行配置，使它能够识别 Lotus Sametime 所使用的运行时环境并将其开发和执行的目标平台指向 Lotus Sametime。本文将指引您按以下顺序进行此配置，将 Eclipse 打造成 Lotus Sametime V7.5.1 的插件开发环境（PDE）：

1. 为 Eclipse 安装 J9 插件。
2. 设置 Java 编译器设置、J9 JRE 设置和 Target Platform. 规范。
3. 启动配置设置。

完成这些配置步骤后，插件项目所需的 Eclipse 工作区即已就绪。您可以保存一个工作区副本用作以后创建插件项目时的模板。

系统要求

本文所需的应用程序和工具如下：

• Lotus Sametime V7.5.x（Lotus Sametime V7.5.1 的一个试用版本）。
• Eclipse 3.2.2。
• JDK 1.5 update 11。
• IBM Lotus Sametime SDK。
• J9 JDT 启动插件，用于 Eclipse 识别 Lotus Sametime SDK 中的 J9 JCL Desktop 自定义运行时环境。

安装 J9 插件

Lotus Sametime V7.5.1 包含 J9 JCL Desktop 自定义运行时环境，后者支持 J2SE 1.4.2 JRE 的大部分功能。Lotus Sametime V7.5.1 SDK 中包含一个用于插件开发的开发者版本。

安装 J9 JDT 启动插件的目的是使 Eclipse 能够将 J9 JCL Desktop 识别为有效的运行时，从而使您能够编译、运行和调试插件代码。请按以下步骤安装 J9 JDT 插件：

1. 若 Eclipse IDE 正在运行，请将其关闭。
2. 从 “系统要求” 一节中的链接下载 J9 JDT 启动插件 ZIP 文件。
3. 将下载的 J9 JDT 启动插件 ZIP 文件的内容解压缩到 Eclipse 安装目录的 eclipse 子目录（例如 C:\eclipse32\eclipse）中。
   
   注意：此目录包含 plugins 文件夹和 eclipse.exe 文件。如果解压缩后打开 plugins 文件夹，您应看到图 1 所示的屏幕。

设置 J9 运行时和目标平台

安装了 J9 JDT 启动插件后，需要设置 Eclipse 用于编译和运行插件代码的 J9 JRE。还需要对 Java 编译器和目标平台设置作些更改。

1. 在 Eclipse 中，使用 Workspace Launcher 创建一个新工作区 Lotus Sametime751，关闭 Welcome 屏幕并选择 Window – Preferences。
2. 选择 General - Editors 子附签，然后选择 Text Editors。选中 Show line numbers 选项，如图 2 所示。

3. 展开左侧列中的 Java 条目，然后选择 Compiler。将 Compiler compliance level 设置为 1.4，取消选择 “Use default compliance settings”，并将 “Generated .class files compatibility” 和 “Source compatibility” 设为 1.4。
4. 检查屏幕与是否与图 3 中的设置相同，然后单击 Apply。如果提示您进行编译器重建，则单击 Yes。

5. 返回左侧列中的 Java 条目，然后选择 Installed JREs，如图 4 所示。

6. 单击 Add 并将以下设置输入到图 5 所示的对话框中。
   
   
   • JRE type: J9 VM
   • JRE name: JCL Desktop
   • JRE home directory: \ st751sdk\client\connect\j9-runtime\win32
   • Default VM Arguments: -jcl:max

7. 单击 OK 返回 Installed JREs 对话框，然后选择刚才创建的配置（JCL Desktop）。单击 Edit 访问 Edit JRE 对话框，如图 6 所示。

8. 单击 Add External JARs 并浏览到 \lib\jclmax\ext，其中 是步骤 5 中指定的 JRE 主目录。选择列出的所有 JAR 文件并单击 Open。JAR 文件将出现在 Edit JRE 对话框中的 JRE 系统库下面。
9. 再次单击 Add External JARs 并浏览到 \lib\jclmax\opt-ext。选择所有的文件并单击 Open 返回到 Edit JRE 对话框。
10. 检查 Edit JRE 对话框是否如图 7 所示，然后单击 OK 返回到 Installed JREs 对话框。

11. 在图 8 所示的 Preference - Installed JREs 对话框中，选择 JCL Desktop 选项为默认值。

12. 在左侧列中，展开 Plug-ins 附签并选择 Target Platform，如图 9 所示。使用 Location 字段旁边的 Browse 按钮选择包含 Lotus Sametime 可执行文件的目录。

13. 在图 10 所示的 Target Platform. 对话框中，选择 Source Code Locations 附签。

14. 单击 Add 按钮并浏览到 Eclipse 3.2 IDE 安装的 plugins 目录（例如，C:\eclipse322\eclipse\plugins）。选择此处的四个源插件的 src 目录（如图 11 所示）：
    
    
    • org.eclipse.platform.source.win32.win32.x86_3.2.2.r322_v20070119-RQghndJN8IM0MsK
    • org.eclipse.platform.source_3.2.2.r322_v20070119-RQghndJN8IM0MsK
    • org.eclipse.rcp.source.win32.win32.x86_3.2.2.r322_v20070104-8pcviKVqd8J7C1U
    • org.eclipse.rcp.source_3.2.2.r322_v20070104-8pcviKVqd8J7C1U

15. Click OK to save the configuration.

创建启动配置

为 Lotus Sametime 插件开发配置 Eclipse 的最后一步是创建启动配置。启动配置用于使用前一节指定的 Lotus Sametime V7.5.1 目标平台运行或调试插件。

1. 在 Eclipse 菜单中选择 Run - Run 打开 Run Configuration 对话框。
2. 从配置列表中选择 Eclipse Application。
3. 单击 New 图标。
4. 给配置提供一个 Name，例如 ST 751。
5. 选中 Run an application，并使用下拉菜单选择 RTCApplication。检查设置是否如图 12 所示。

6. 选择 Main 附签右侧的 (x)=Arguments 附签，然后在 VM Arguments 下面输入以下内容，如图 13 所示：
   
   Xint -Xtrace:none -Xgcpolicy:gencon
   Dcom.ibm.pvc.webcontainer.port=7777

7. 单击 Run 按钮查看 Lotus Sametime V7.5.1 执行。退出 Lotus Sametime，然后就可以开始开发插件了。

结束语

作为共分 4 部分的系列文章的第 1 部分，本文简要介绍了使用 Eclipse 开发 Lotus Sametime V7.5.1 插件所需的配置设置。在第 2 部分中，您将开发一个自定义插件 BuddyNote，该插件扩展了 Lotus Sametime 用户界面，让您能够在联系人列表中创建和存储各个联系人的信息。