Eclipse的擴展機制是其一個重要特色,但隨著Eclipse功能越做越強,插件越來越多,你會發現GUI上的圖標越來越多,Menu,toolbar,context menu都被占滿了,其實很多item並不是我們需要的,但是contribute這些item的插件我們是需要的,那怎麼去掉它們擴展的那些菜單項呢?
1.在Plugin.xml中定制
這是最簡單的辦法,很多時候我們自己想寫代碼來去掉一些菜單項,但效果並不好.所以能在Plugin.xml中定制的,我們就 盡量寫在plugin.xml裡面.下面舉一個右鍵菜單的例子:
擴展右鍵菜單需要擴展org.eclipse.ui.popupMenus擴展點,我們一般都在它下面new一個action,但這個action擴展之後不管在 任何界面都會出現,如果我們想在某些條件下隱藏掉它該怎麼辦?仔細觀察下org.eclipse.ui.popupMenus擴展點,其實我們還可以新建 objectContribution擴展
<extension point="org.eclipse.ui.popupMenus">
<objectContribution
id="my.example.objectContribution"
nameFilter="*example*"
objectClass="java.io.File">
<action
class="my.example.MyAction"
id="my.example.MyAction"
label="Exe"
menubarPath="additional">
</action>
</objectContribution>
</extension>
objectContribution裡面也包含一個action,但這個action在popupmenu裡出現是有條件的:我們給它定義了一個 nameFilter, 只有當selection()的path中包含了"example"才會顯示,否則這個action是不會出現在 popupmenu裡的.這裡的selection假設選中的是一個File,如果選中的是你自己寫的類,那namefilter會在你的類的 toString方法裡面找keyword.
2.使用Eclipse的Activities擴展
plugin.xml並不能解決所有問題,當我們實在沒有辦法在plugin.xml中限制某些extension的出現的時候,可以考慮使用 Eclipse的Activities.Activities的官方定義大家可以google一下eclipse的help.我個人的理解就是它可以和 perspective一樣控制UI的顯示,但是Perspective設計的太易於擴展了,假如Plugin A在perspective上擴展了一個UI,那麼Plugin B在每次進入這個perspective的時候就一定可以看得見它,而且在Eclipse的擴展機制下,Plugin B是沒有權利去刪了Plugin A的contribution的(Eclipse的ExtensionRegistry倒是提供了一個removeExtension方法,但運行的時候會報錯).在這樣的情況下,Activities的價值就體現出來了,你只要給它一個Extension的id,它就可以幫你把這個Extension disable掉.例如:
<extension
point="org.eclipse.ui.activities">
<activity
id="my.example.activity"
name="WizardActivity">
</activity>
<activityPatternBinding
activityId="my.example.activity"
pattern="my\.example/mywizard">
</activityPatternBinding>
</extension>
比較重要的是activityPatternBinding中的pattern屬性,它是由plugin id + "/" + local-id組成.比如在插件my.example中擴展了 org.eclipse.ui.newWizards,id是mywizard,那麼上面這個activityPatternBinding就會disable掉my.example的mywizard擴展,你在 GUI中就看不見這個 wizard了.pattern是支持正則表達式的,所以如果有"."的話需要用轉義字符\.注意,這裡的disable的意思並不是說我把 mywizard這個擴展刪掉了,而是屏蔽了它,mywizard仍然在 ExtensionRegistry中.
3.用代碼來動態控制UI
方法2只是隱藏掉一些擴展,但是有一些需求並不是簡單的隱藏就可以了,我最近碰到的一個需求就是:有一個flag,只有當flag==1的時候擴展是可見的,否則是不可見的,需要disable這個擴展.這時就必須要加一些代碼才能實現了,還是以方法2中的mywizard為例:
IWorkbenchActivitySupport workbenchActivitySupport = PlatformUI.getWorkbench().getActivitySupport();
IActivityManager activityManager = workbenchActivitySupport.getActivityManager();
Set enabledActivityIds = new HashSet(activityManager.getEnabledActivityIds());
if(flag==1)
{
if (enabledActivityIds.add("my.example.activity"))
workbenchActivitySupport.setEnabledActivityIds(enabledActivityIds);
}
else{
if(enabledActivityIds.remove("my.example.activity"))
workbenchActivitySupport.setEnabledActivityIds(enabledActivityIds);
}
Activities可以是enable或者disable的,當你在plugin.xml中定義好了一個Activity,缺省它是disable 的,就是說activityPatternBinding 匹配的擴展是會被disable的,但你也可以把Activities設成enable的(在 plugin.xml或者用代碼都可以設置),它匹配的擴展是可以正常使用的.
在上面的code sample中,我們通過activityManager.getEnabledActivityIds()得到所有enable的 Activities.如果flag==1,那my.example.activity 也應該被加入到enable Activities中,這樣mywizard就可以顯示在界面上,反之,就要在enable Activities中remove掉my.example.activity,它就變成
disable,會把mywizard隱藏.
