在IBM Lotus Sametime V7.5.1中配置Eclipse環境

在 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 所示的螢幕。

圖 1. 安裝有 J9 的 Eclipse plugins 資料夾
 

設定 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 所示。

圖 2. Preferences 對話方塊 - Text Editors

3. 展開左側列中的 Java 條目，然後選擇 Compiler。將 Compiler compliance level 設定為 1.4，取消選擇 “Use default compliance settings”，並將 “Generated .class files compatibility” 和 “Source compatibility” 設為 1.4。
4. 檢查螢幕與是否與圖 3 中的設定相同，然後單擊 Apply。如果提示您進行編譯器重建，則單擊 Yes。

圖 3. Eclipse Preferences – Compiler

5. 返回左側列中的 Java 條目，然後選擇 Installed JREs，如圖 4 所示。

圖 4. Preferences 對話方塊 – Installed JREs

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

圖 5. 新增 JRE Dialog

7. 單擊 OK 返回 Installed JREs 對話方塊，然後選擇剛才建立的配置（JCL Desktop）。單擊 Edit 訪問 Edit JRE 對話方塊，如圖 6 所示。

圖 6. Edit JRE 對話方塊 – JCL Desktop

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 對話方塊。

圖 7. Edit JRE 對話方塊 – 新增了 JAR 檔案的 JCL Desktop

11. 在圖 8 所示的 Preference - Installed JREs 對話方塊中，選擇 JCL Desktop 選項為預設值。

圖 8. JRE 選擇

12. 在左側列中，展開 Plug-ins 附籤並選擇 Target Platform，如圖 9 所示。使用 Location 欄位旁邊的 Browse 按鈕選擇包含 Lotus Sametime 可執行檔案的目錄。

圖 9. Eclipse Preferences - Target Platform

13. 在圖 10 所示的 Target Platform. 對話方塊中，選擇 Source Code Locations 附籤。

圖 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

圖 11. 原始碼目錄

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 所示。

圖 12. Run 對話方塊

6. 選擇 Main 附籤右側的 (x)=Arguments 附籤，然後在 VM Arguments 下面輸入以下內容，如圖 13 所示：
   
   Xint -Xtrace:none -Xgcpolicy:gencon
   Dcom.ibm.pvc.webcontainer.port=7777

圖 13. (x) = Arguments 附籤

7. 單擊 Run 按鈕檢視 Lotus Sametime V7.5.1 執行。退出 Lotus Sametime，然後就可以開始開發外掛了。

結束語

作為共分 4 部分的系列文章的第 1 部分，本文簡要介紹了使用 Eclipse 開發 Lotus Sametime V7.5.1 外掛所需的配置設定。在第 2 部分中，您將開發一個自定義外掛 BuddyNote，該外掛擴充套件了 Lotus Sametime 使用者介面，讓您能夠在聯絡人列表中建立和儲存各個聯絡人的資訊。

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/14751907/viewspace-438857/，如需轉載，請註明出處，否則將追究法律責任。