擴展Eclipse的Java開發工具(二)

2019-11-18 13:02:57

字體：大中小

來源：轉載

供稿：網友

　　在用戶界面中，如何顯示擴展，顯示在何處？
　　這在很大程度上是一個暖和的提示，因為我們已得到了答案。我們希望對一個或多個選中的方法顯示上下文菜單選項，這些菜單選項答應我們只用一個操作就可以更改方法的可視性。我們更喜歡在可以顯示方法的任何地方都能使用這些菜單選項，如在 Hierarchy 視圖和 Package EXPlorer 中。這把我們帶到下一個問題。
　　
　　通常如何擴展用戶界面？
　　通過示例來學習會更有趣，這方面 Plug-in PRoject 向導可以提供幫助，它提供了一些樣本代碼，我們可以修改這些代碼來滿足我們的需要。我們將回答該向導中的幾個問題，它將自動啟動用于插件開發的專門透視圖，稱為 Plug-in Development Environment（PDE），以預備測試。該向導包含了可以幫助我們入手的許多示例。事實上，我們的老朋友“Hello World”也在那里。為了沿襲這個傳統，我們將生成這個“Hello World”，查看結果以驗證是否正確安裝了該環境，隨后修改它以幫助我們回答當前的問題，并把我們帶到下一個問題：對用戶界面的擴展如何知道類似于“選擇”這樣的基本事件？這很重要，因為我們希望將我們新近引入的菜單選項應用到當前選中的方法上。
　　
　　請注重，這些指示信息假定您正從全新的 Eclipse 安裝開始。假如修改了該環境或更改了首選項，那么可能不會完全象如下所述那樣工作。您可以考慮從全新的工作空間啟動 Eclipse：打開命令提示符窗口，更改到 /eclipse 目錄，然后使用 -data 參數啟動 Eclipse，如清單 1 所示。
　　
　　清單 1. 啟動全新的 Eclipse 實例
　　
　　cd c:/eclipse2.1/eclipse
　　eclipse.exe -data workspaceDevWorks
　　
　　從使用 New Plug-in Project 向導創建一個插件項目開始。選擇 File > New > Project。在 New Project 對話框中，在向導列表中選擇 Plug-in Development and Plug-in Project，然后選擇 Next。將項目命名為 com.ibm.lab.helloworld。該向導將根據這個名稱創建插件標識，所以它在系統中必須是唯一的（按慣例，項目名和插件標識相同）。使用顯示在“Project contents”下面的推薦缺省工作空間位置就可以了；選擇 Next。
　　
　　在下一頁上，選擇 Next 以接受缺省插件項目結構。該插件代碼生成器頁推薦了許多樣本，向導可以幫助您進一步對該項目進行參數化。選擇“Hello, World”選項，然后選擇 Next。下一頁（顯示在圖 4 中）推薦了插件名和插件類名。這些名稱基于插件項目 com.ibm.lab.helloworld 的最后一個單詞。這個示例不需要任何插件類便利方法，所以取消對三個代碼生成選項的選擇（如圖 4 所示），然后選擇 Next（不是 Finish；您還有一頁要完成）。
　　　擴展Eclipse的Java開發工具(二)（圖一）

　　圖 4. Simple Plug-in Content
　　您可以在下一頁（顯示在圖 5 中）中指定參數，這些參數對于“Hello, Worlds”示例是唯一的，比如，將要顯示的消息。
　　　擴展Eclipse的Java開發工具(二)（圖二）

　　圖 5. Sample Action Set
　　要簡化所產生的代碼，將該操作的目標包名從 com.ibm.lab.helloworld.actions 更改成 com.ibm.lab.helloworld，即與該項目的名稱相同。盡管在實際的插件中，您可以選擇用不同的包對相關的類進行分組，但在本例中，只有兩個類，所以不必這樣做。這樣也遵循了“主”包名和項目名相同這個慣例。現在選擇 Finish。
　　
　　您應該看到一個信息消息：“Plug-ins required to compile java classes in this plug-in are currently disabled. The wizard will enable them to avoid compile errors.”。選擇 OK 繼續。假如這是個全新的工作空間，那么您還將看到另一個信息消息：“This kind of project is associated with the Plug-in Development Perspective. Do you want to switch to this perspective now?”。選擇 Yes 以根據這個消息的建議進行切換。
　　
　　要驗證所有的東西是否都設置正確，讓我們測試新插件。選擇 Run > Run As > Run-Time Workbench。這將啟動 Eclipse 的第二個實例，它將包含您的插件。這個新實例將創建一個新的名為 runtime-workspace 的工作空間目錄，所以不必擔心；對這個實例所作的任何測試都不會影響開發設置。您應該看到類似圖 6 的樣子，其中有一個新的下拉菜單，其標簽為 Sample Menu，它有單一的選項 Sample Action。選擇它將顯示下面的信息消息。假如您不是從全新的工作空間啟動，那么可以選擇 Window > Reset Perspective 以查看新生成的下拉菜單；從現有工作空間啟動時不會顯示這個菜單，因為工作臺“記得”上次 Eclipse 運行時哪些操作集是活動的（您還可以從 Window > Customize Perspective...下拉菜單選項上添加／刪除操作集）。
　　擴展Eclipse的Java開發工具(二)（圖三）

　　圖 6. Hello, Eclipse world
　　讓我們快速瀏覽一下插件清單文件 plugin.xml。雙擊它，以在 Plug-in Manifest 編輯器中打開它。這個編輯器提供了幾個類似于向導的頁和一個“原始”源代碼頁。通過選擇 Source 選項卡轉到源代碼頁。您將看到與以下清單 2 顯示的代碼相似的內容；我們感愛好的是用粗體顯示的那幾部分。
　　
　　清單 2. 所生成的“Hello, World” plugin.xml
　　
　　　　point="org.eclipse.ui.actionSets">>
　　　　　　label="Sample Action Set"
　　　visible="true"
　　　id="com.ibm.lab.helloworld.actionSet">
　　　　　　label="Sample &Menu"
　　　　id="sampleMenu">
　　　　　　　name="sampleGroup">
　　　
　　
　　　　　　label="&Sample Action"
　　　　icon="icons/sample.gif"
　　　　class="com.ibm.lab.helloworld.SampleAction"
　　　　tooltip="Hello, Eclipse world"
　　　　menubarPath="sampleMenu/sampleGroup"
　　　　toolbarPath="sampleGroup"
　　　　id="com.ibm.lab.helloworld.SampleAction">
　　
　　　
　　
　　
　　并不需要過于深入地研究這個代碼。我們“旅行”的第 II 部分的目的只是讓您熟悉一些基本機制，借此我們可以介紹 JDT 的擴展。這里，您會看到這樣一種技術的一個樣本：它將菜單和菜單選項作為操作集添加到工作臺。它以一個用標記聲明的擴展開始。工作臺用戶界面插件定義了這個擴展點 org.eclipse.ui.actionSets，以及幾個類似的擴展點，通過這幾個擴展點可以向各種用戶界面元素提供其它插件。
　　
　　我們還未回答如何將菜單選項添加到 Java 方法的上下文菜單中。一個簡單示例可以給我們一些提示。首先打開顯示“Hello, World”消息的類 SampleAction，請注重其 run 方法。它不是非凡有趣；不過我們還看到了另一個方法 selectionChanged。啊哈！下一個問題的答案有了。
　　
　　對用戶界面的擴展如何知道類似于“選擇”這樣的基本事件？
　　
　　工作臺“選擇”更改時會告知所提供的操作（象我們提供的菜單下拉選項）。這在 selectionChanged 方法前面的 Javadoc 注釋中得到了確認。讓我們修改這個方法以告知有關“選擇”的更多信息。首先，假如您還沒有關閉工作臺的運行時實例，那么現在就關閉。然后對 selectionChanged 方法添加清單 3 中的代碼。
　　
　　清單 3. selectionChanged 方法，首次修改
　　
　　public void selectionChanged(IAction action, ISelection selection) {
　　　System.out.println("==========> selectionChanged");
　　　System.out.println(selection);
　　}
　　
　　有了這個調試代碼，我們將看到選擇了什么，并了解到有關什么使 Eclipse 工作的更多信息。保存該方法，然后重新啟動運行時工作臺。
　　
　　重要：Eclipse 有一個延遲裝入的策略，以在用戶執行需要插件代碼的操作時才裝入插件。所以您必須先選擇 Sample Action 菜單選項，以在調用 selectionChanged 方法之前裝入您的插件。
　　
　　現在選擇其它東西，如編輯器中的文本、Navigator 中的文件，當然還有 Outline 視圖中的成員（回憶一下：您必須創建一個 Java 項目和示例 Java 類來做到這一點，因為運行時實例使用不同的工作空間）。清單 4 顯示了您將在 Eclipse 的開發實例的控制臺中看到的某個示例輸出。
　　
　　清單 4. selectionChanged 輸出，首次修改
　　
　　==========> selectionChanged
　　[package com.ibm.lab.soln.jdt.excerpt [in [Working copy] ChangeIMemberFlagAction.java
　　[in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]
　　==========> selectionChanged
　　
　　==========> selectionChanged
　　org.eclipse.jface.text.TextSelection@9fca283
　　==========> selectionChanged
　　
　　==========> selectionChanged
　　[package com.ibm.lab.soln.jdt.excerpt [in [Working copy] ChangeIMemberFlagAction.java
　　[in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]
　　==========> selectionChanged
　　[IMember[] members [in ChangeIMemberFlagAction [in [Working copy] ChangeIMemberFlagAction.java
　　[in com.ibm.lab.so

上一篇：Eclipse使用入門

下一篇：擴展Eclipse的Java開發工具(一)