IBM Lotus Expeditor Toolkit V6.1.1 入門

本文從較高的層次帶領您瀏覽 IBM Lotus Expeditor Toolkit。通過本文了解如何安裝和配置這個工具箱，如何將示例匯入到工具中，以及如何在附帶的 Expeditor 測試環境中啟用示例。

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、Servlet	Eclipse 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 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 對話方塊
 

配置

要開發面向 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 中的訂單條目示例

要匯入示例，在左邊的窗格中選擇希望匯入的示例，然後在右面的窗格單擊 Import the sample 選項。我們使用 Order Entry 示例（從 Showcase 示例部分選項）演示啟動功能；然後匯入該特性。當顯示如圖 4 所示的 Order Entry 示例對話方塊時，單擊 Finish。

圖 4. 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. 瀏覽至 \plugins\com.ibm.rcp.tools.samplegallery_6.1.1.\archive\orderentry.jar，然後單擊 Open。
5. 檢查所有專案旁邊的核取方塊是否被選中，然後單擊 Finish，如圖 5 所示。

圖 5. 在 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 啟動程式

啟動程式填充了要啟動經過配置的平臺需要的全部選項。單擊 Run 按鈕啟動客戶機平臺。Lotus Expeditor Client 啟動，如果您是第一次在所選的工作區啟動，則系統會要求您建立新密碼；否則，您可以輸入以前建立的密碼。

啟動 Web 版本的示例的方法是單擊 Open 按鈕，然後從下拉選單中選擇 Order Entry Web Sample。

您將看到 Web 版本的示例的啟動頁面，如圖 7 所示。單擊 Start 按鈕開始使用示例應用程式。使用 Web 使用者介面建立一些新的訂單。

圖 7. Order Entry Web Sample 的起始頁

現在啟動富客戶機版本的示例，方法是單擊 Open 按鈕並選擇 Order Entry Rich Client Sample。

您將看到 Rich Client 版本的示例的啟動頁面。如果您在 Web 版本中建立了訂單，您將看到這些訂單反射到了 Rich Client 版本中，如圖 8 所示。

圖 8. 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 專案型別

表 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

所使用的目標可以在不同的位置選擇。要為工作區設定預設目標（即為新專案或新的啟動配置設定），可在 Window - Preferences - Client Services - Development 引數頁面設定 Default Target Selection，如圖 11 所示。

圖 11. 從 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 平臺開發應用程式。

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