扩展Eclipse的Java开发工具(二)

在用户界面中，如何显示扩展，显示在何处？ @kyb
 y  
　　这在很大程度上是一个温和的提示，因为我们已得到了答案。我们希望对一个或多个选中的方法显示上下文菜单选项，这些菜单选项允许我们只用一个操作就可以更改方法的可视性。我们更喜欢在可以显示方法的任何地方都能使用这些菜单选项，如在 Hierarchy 视图和 Package Explorer 中。这把我们带到下一个问题。 y:zQ-
T`N  
　　 j\*|p&EB  
　　通常如何扩展用户界面？ TJu(Fh  
　　通过示例来学习会更有趣，这方面 Plug-in Project 向导可以提供帮助，它提供了一些样本代码，我们可以修改这些代码来满足我们的需要。我们将回答该向导中的几个问题，它将自动启动用于插件开发的专门透视图，称为 Plug-in Development Environment（PDE），以准备测试。该向导包含了可以帮助我们入手的许多示例。事实上，我们的老朋友“Hello World”也在那里。为了沿袭这个传统，我们将生成这个“Hello World”，查看结果以验证是否正确安装了该环境，随后修改它以帮助我们回答当前的问题，并把我们带到下一个问题：对用户界面的扩展如何知道类似于“选择”这样的基本事件？这很重要，因为我们希望将我们新近引入的菜单选项应用到当前选中的方法上。 .qQc" i"  
　　 rO`!GN  
　　请注意，这些指示信息假定您正从全新的 Eclipse 安装开始。如果修改了该环境或更改了首选项，那么可能不会完全象如下所述那样工作。您可以考虑从全新的工作空间启动 Eclipse：打开命令提示符窗口，更改到 \eclipse 目录，然后使用 -data 参数启动 Eclipse，如清单 1 所示。 :BN2Q$z#  
　　 ek=A\aO  
　　清单 1. 启动全新的 Eclipse 实例 7K{<NETM  
　　 <}\g=zbX  
　　cd c:\eclipse2.1\eclipse b2y
rXH  
　　eclipse.exe -data workspaceDevWorks hzKL4iT  
　　 Xd=1FN I  
　　从使用 New Plug-in Project 向导创建一个插件项目开始。选择 File > New > Project。在 New Project 对话框中，在向导列表中选择 Plug-in Development and Plug-in Project，然后选择 Next。将项目命名为 com.ibm.lab.helloworld。该向导将根据这个名称创建插件标识，所以它在系统中必须是唯一的（按惯例，项目名和插件标识相同）。使用显示在“Project contents”下面的推荐缺省工作空间位置就可以了；选择 Next。 
s&hMJ0  
　　 M
|j"m8;6  
　　在下一页上，选择 Next 以接受缺省插件项目结构。该插件代码生成器页推荐了许多样本，向导可以帮助您进一步对该项目进行参数化。选择“Hello, World”选项，然后选择 Next。下一页（显示在图 4 中）推荐了插件名和插件类名。这些名称基于插件项目 com.ibm.lab.helloworld 的最后一个单词。这个示例不需要任何插件类便利方法，所以取消对三个代码生成选项的选择（如图 4 所示），然后选择 Next（不是 Finish；您还有一页要完成）。 gyFI73OY  
　　 Z,HS0|f+3  
　
|;4'zf-  
.I90Wh#  
　　 R2,>Qpm  
图 4. Simple Plug-in Content ,3vuF 2GHv  
/g.erjZ<  
　　您可以在下一页（显示在图 5 中）中指定参数，这些参数对于“Hello, Worlds”示例是唯一的，比如，将要显示的消息。 `&x z-k;  
　　 KBZ.~ij  
　 F y=%9}X  
{ ;UMV]Gc  
　　 ] O R>*4z  
图 5. Sample Action Set % u8 a`C  
d:>PM  
　　要简化所产生的代码，将该操作的目标包名从 com.ibm.lab.helloworld.actions 更改成 com.ibm.lab.helloworld，即与该项目的名称相同。尽管在实际的插件中，您可以选择用不同的包对相关的类进行分组，但在本例中，只有两个类，所以不必这样做。这样也遵循了“主”包名和项目名相同这个惯例。现在选择 Finish。 n3
6"7i2  
　　 ! cbV5D\  
　　您应该看到一个信息消息：“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 以根据这个消息的建议进行切换。 9<rz`vUz  
s\ITR#(`k  
要验证所有的东西是否都设置正确，让我们测试新插件。选择 Run > Run As > Run-Time Workbench。这将启动 Eclipse 的第二个实例，它将包含您的插件。这个新实例将创建一个新的名为 runtime-workspace 的工作空间目录，所以不必担心；对这个实例所作的任何测试都不会影响开发设置。您应该看到类似图 6 的样子，其中有一个新的下拉菜单，其标签为 Sample Menu，它有单一的选项 Sample Action。选择它将显示下面的信息消息。如果您不是从全新的工作空间启动，那么可以选择 Window > Reset Perspective 以查看新生成的下拉菜单；从现有工作空间启动时不会显示这个菜单，因为工作台“记得”上次 Eclipse 运行时哪些操作集是活动的（您还可以从 Window > Customize Perspective...下拉菜单选项上添加／删除操作集）。 pY'K8x]=
 
　　 n5=!L=  
 cqu{ \k  
T6;T<d  
Jahp'S]  
　　 RJqEHF  
ZLb]q=["o  
图 6. Hello, Eclipse world 8nQC |.s  
+ejw<4Cn  
　　让我们快速浏览一下插件清单文件 plugin.xml。双击它，以在 Plug-in Manifest 编辑器中打开它。这个编辑器提供了几个类似于向导的页和一个“原始”源代码页。通过选择 Source 选项卡转到源代码页。您将看到与以下清单 2 显示的代码相似的内容；我们感兴趣的是用粗体显示的那几部分。 $S,79R~t"  
　　 Pb;QmmG8*  
　　清单 2. 所生成的“Hello, World” plugin.xml QE)o &s  
　　 lOiCb@0DG}  
　　　　　　point="org.eclipse.ui.actionSets">> !x5BL(-%  
　　　　　　　　label="Sample Action Set" VV7;J&aA  
　　　　　visible="true" *(+[:AGl  
　　　　　id="com.ibm.lab.helloworld.actionSet"> :Gdn_Z'9<  
　　　　　　　　　　label="Sample &Menu" MwY5,/~R  
　　　　　　id="sampleMenu"> 7$Sh_:W  
　　　　　　　　　　　name="sampleGroup"> ?S. :XP#+s  
　　　　　 p3?jlBb%  
　　　　 qJczT1a  
~k6!OGU<  
#fq5 N6  
　　　　　　　　　　label="&Sample Action"
;@M/;]  
　　　　　　icon="icons/sample.gif" '_(v1:b[s  
　　　　　　class="com.ibm.lab.helloworld.SampleAction" 6V@ u:/N]  
　　　　　　tooltip="Hello, Eclipse world" FJ1fZ9  
　　　　　　menubarPath="sampleMenu/sampleGroup" iz`?EL+7  
　　　　　　toolbarPath="sampleGroup" ;:lFD6MH  
　　　　　　id="com.ibm.lab.helloworld.SampleAction"> h<6.ZN +>  
　　　　 k`eK+-\ j  
　　　 dT6Vh=  
　　 6,M}@bX*An  
　　 B:qT^J  
　　并不需要过于深入地研究这个代码。我们“旅行”的第 II 部分的目的只是让您熟悉一些基本机制，借此我们可以介绍 JDT 的扩展。这里，您会看到这样一种技术的一个样本：它将菜单和菜单选项作为操作集添加到工作台。它以一个用 标记声明的扩展开始。工作台用户界面插件定义了这个扩展点 org.eclipse.ui.actionSets，以及几个类似的扩展点，通过这几个扩展点可以向各种用户界面元素提供其它插件。 "R.,;3R^]  
　　 iKr\yUv9  
　　我们还未回答如何将菜单选项添加到 Java 方法的上下文菜单中。一个简单示例可以给我们一些提示。首先打开显示“Hello, World”消息的类 SampleAction，请注意其 run 方法。它不是特别有趣；不过我们还看到了另一个方法 selectionChanged。啊哈！下一个问题的答案有了。 ^S3LadD  
　　 ` DsOm!s  
　　对用户界面的扩展如何知道类似于“选择”这样的基本事件？ Z] @99]"n  
　　 yEb[h(  
　　工作台“选择”更改时会告知所提供的操作（象我们提供的菜单下拉选项）。这在 selectionChanged 方法前面的 Javadoc 注释中得到了确认。让我们修改这个方法以告知有关“选择”的更多信息。首先，如果您还没有关闭工作台的运行时实例，那么现在就关闭。然后对 selectionChanged 方法添加清单 3 中的代码。 phhLU"E  
　　 ,.TK l4n  
　　清单 3. selectionChanged 方法，首次修改 PP|o3tqd  
　　 _< 5h=]T  
　　public void selectionChanged(IAction action, ISelection selection) { *5EgZ  
　　　System.out.println("==========> selectionChanged"); b7[L 3uF
 
　　　System.out.println(selection); gp5,VzI  
　　} SWLg:q-1M  
　　 F FOmR!u  
　　有了这个调试代码，我们将看到选择了什么，并了解到有关什么使 Eclipse 工作的更多信息。保存该方法，然后重新启动运行时工作台。 !4_.f\:~  
Hg + uO  
重要：Eclipse 有一个延迟装入的策略，以在用户执行需要插件代码的操作时才装入插件。所以您必须先选择 Sample Action 菜单选项，以在调用 selectionChanged 方法之前装入您的插件。 BA6(a=rmC  
　　 g)r)gR  
　　现在选择其它东西，如编辑器中的文本、Navigator 中的文件，当然还有 Outline 视图中的成员（回忆一下：您必须创建一个 Java 项目和示例 Java 类来做到这一点，因为运行时实例使用不同的工作空间）。清单 4 显示了您将在 Eclipse 的开发实例的控制台中看到的某个示例输出。 'nSi<5}5  
　　 '';7 >ivEv  
　　清单 4. selectionChanged 输出，首次修改 v1/,DpbU  
　　 *-nav[  
　　==========> selectionChanged .V1C_bb  
　　[package com.ibm.lab.soln.jdt.excerpt [in [Working copy] ChangeIMemberFlagAction.java UpRV=}|  
　　　　[in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]
*;Qq)YP  
　　==========> selectionChanged aX-G'A`W  
　　 EHv#Q]enm  
　　==========> selectionChanged _VSC$i~  
　　org.eclipse.jface.text.TextSelection@9fca283 @n\4 kqe  
　　==========> selectionChanged :-Vcq4(Cz
 
　　 .{qr[^ #  
　　==========> selectionChanged *@0&~1  
　　[package com.ibm.lab.soln.jdt.excerpt [in [Working copy] ChangeIMemberFlagAction.java 8(PU)  
　　　　[in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]] Fq(HS=N  
　　==========> selectionChanged T AX[go(T  
　　[IMember[] members [in ChangeIMemberFlagAction [in [Working copy] ChangeIMemberFlagAction.java iPbv *ge  
　　　　[in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]] F<[8"tf  
　　==========> selectionChanged uM{,I'  
　　 `"=_ fqm!  
　　==========> selectionChanged 6:0=A" jUF  
　　[ChangeIMemberFlagAction.java [in com.ibm.lab.soln.jdt.excerpt `Zh}|BNFb  
　　　　　[in src [in com.ibm.lab.soln.jdt.excerpt]]] 3L<@_ k%  
　　　package com.ibm.lab.soln.jdt.excerpt V,([y,V695  
　　　import org.eclipse.jdt.core.Flags U
~:Y  
　　　import org.eclipse.jdt.core.IBuffer "n~g2A&]  
　　　...lines omitted... 7$Dfl\Qk  
　　　　void selectionChanged(IAction, ISelection)] N)c-85_  
　　==========> selectionChanged &_ O)(4i  
　　[boolean isChecked(IAction, IMember) [in ToggleIMemberFinalAction ;/edE*o  
　　　　[in ToggleIMemberFinalAction.java [in com.ibm.lab.soln.jdt.excerpt
5 D `$X  
　　　　[in src [in com.ibm.lab.soln.jdt.excerpt]]]]]] 9%>>]To  
　　 X`=fU84  
　　很明显，这个“选择”不象 String 的实例那么基本，但没有明示涉及了什么类，因为这些类很明显覆盖了它们的缺省 toString 方法。如果不用多做一点研究就可以明白这些类向我们显示的信息，那我们就轻松了，但目前我们还没有达到这种程度。回到 selectionChanged 方法，浏览 selection 参数的接口 ISelection 的层次结构。其层次结构表明它的通用子类型接口并不多，只有 IStructuredSelection（用于列表）和 ITextSelection。通过输出所选的类，我们可以使 selectionChanged 方法稍微更智能一点。如清单 5 所示修改 selectionChanged 方法。 *D_KrIy@v  
　　 -v+0+N.Db  
　　清单 5. selectionChanged 方法，第二次修改 Sw' $ZMz  
　　 Lc:fo`Z  
　　public void selectionChanged(IAction action, ISelection selection) { @j,1dH,.  
　　　System.out.println("==========> selectionChanged"); i=agE  
　　　if (selection != null) { JqQg~1@  
　　　　if (selection instanceof IStructuredSelection) { 4mOW1$P1  
　　　　　IStructuredSelection ss = (IStructuredSelection) selection; !MmMsJr#  
　　　　　if (ss.isEmpty()) ('}tDc3  
　　　　　　System.out.println(""); r1mjaO  $  
　　　　　else Wy{ AC!  
　　　　　　System.out.println("First selected element is " + ss.getFirstElement().getClass()); Hw U1i  
　　　　} else if (selection instanceof ITextSelection) { w #,IcSVVh  
　　　　　ITextSelection ts = (ITextSelection) selection; wR-\zt||i  
*GkfG> :J  
　System.out.println("Selected text is <" + ts.getText() + ">"); z7QE  
　　　　} pF ` @PUr  
　　　} else { nAeQ=Nr  
　　　　System.out.println(""); Ar^k}8|C  
　　　} |V.em@`M]  
　　} L#( ;0,_  
　　 Te J{/}  
　　同样，请记住关闭运行时实例，然后重新启动。现在当您选择用户界面的各种元素时，它们是不是提供了更多信息，如清单 6 所示。 z3. 2d
/  
　　 O#O 1MTZ  
　　清单 6. selectionChanged 输出，第二次修改 %i5<CJ/ez#  
　　 y wplNgz!f  
　　????selected some methods in the Outline view uIQZm#Zf  
　　==========> selectionChanged BB:~IXBg  
　　First selected element is class org.eclipse.jdt.internal.core.SourceMethod Up {dp'%  
　　==========> selectionChanged IEAm4-R  
　　First selected element is class org.eclipse.jdt.internal.core.SourceMethod F%OSD{0p  
　　==========> selectionChanged K<Z?[_"  
　　 .w*wIu^d  
　　 , }TmX0,<s  
　　　　activated the Java editor _0xK~.@\  
　　==========> selectionChanged 4^ (ZK&=*  
　　Selected text is
RwTl9?^i}  
　　==========> selectionChanged g6 ?+  
　　 r~rr9V  
　　 d Hv'FJ  
　　　　selected same methods and classes, package in the Package Explorer OqM%7K  
　　==========> selectionChanged [EH1f/k.W  
　　First selected element is class org.eclipse.jdt.internal.core.SourceMethod Gi(`mUpeWL  
　　==========> selectionChanged K@ZK^I~_  
　　First selected element is class org.eclipse.jdt.internal.core.SourceType "TI]lL X  
　　==========> selectionChanged  BLmYsJ  
　　First selected element is class org.eclipse.jdt.internal.core.PackageFragment NXSAu:3s
 
　　 poHLNk*.  
　　　　activated the Navigator view, selected some files, folders, and projects MC$ (fHGc  
　　==========> selectionChanged R=YtH5=x  
　　First selected element is class org.eclipse.core.internal.resources.File ;:;d[jH  
　　==========> selectionChanged B: ISC1:q<  
　　 aIB"_&;,  
　　==========> selectionChanged w96`E&{4  
　　First selected element is class org.eclipse.core.internal.resources.File \hcXCXwh(`  
　　==========> selectionChanged m/F4]d)G  
　　First selected element is class org.eclipse.core.internal.resources.Project ]G&cnB-3X  
　　==========> selectionChanged B7.=|l  
　　First selected element is class org.eclipse.core.internal.resources.Folder 0rV =1L)T  
　　==========> selectionChanged < s!Ta#f  
　　 /9Ie`]|c  
　　 e -i~[$}  
　　　　reactivated the Package Explorer, 1K.# "  
　　　　selected some classes and methods in JARs of reference libraries V+TEdr   
　　==========> selectionChanged y 8"9^>  
　　First selected element is class org.eclipse.jdt.internal.core.JarPackageFragment ^#'iMKZ  
　　==========> selectionChanged 6Fy[uM0a  
　　First selected element is class org.eclipse.jdt.internal.core.ClassFile p.`-pz#  
　　==========> selectionChanged Y= zc`^QP  
　　First selected element is class org.eclipse.jdt.internal.core.BinaryMethod Lyx1Js=  
　　 MFzKA:1  
　　特别地，我们确认在用户界面中看到的东西与 JDT 模型类一一对应。我们之所以了解所显示的是作为选择的模型，而不是类似于字符串和图像的较低级的基本类型，要归功于另一个 Eclipse 框架，称为 JFace。这个框架在象字符串这样的基本类型（接近操作系统的窗口小部件希望使用这些基本类型）和更高级的模型对象（您的代码更愿意使用这些对象）之间进行映射。本文只是略微提及这个主题，因为我们设定的目标是扩展 JDT。参考资料一节推荐了有关 JFace 的其它参考资料，它们将拓展您的理解。本文将只讨论理解 JDT 扩展的基础所必需的知识。 {P)#ef  
　　 ziUv&O  
　　回到输出，特殊的选项结果引起了我们的注意：它们对应于用户界面中 Java 成员的选择。清单 7 中重复了它们。 FA]MC  
　　 piG{7c@H%  
　　清单 7. selectionChanged 输出，再次研究 dC*D Ql`  
　　 1gm4>[  
　　==========> selectionChanged Fxq!}Y  
　　First selected element is class org.eclipse.jdt.internal.core.SourceMethod Fj:CmpA'  
_w=- jO^  
　==========> selectionChanged /Ko-.J Ez  
　　First selected element is class org.eclipse.jdt.internal.core.BinaryMethod rZW[ v  
　　 ?IkL/
u  
　　这些类的包名中间的 internal 使人有点担心。但是，正如您通常会发现的，Eclipse 会有一个公共（public）接口，它对应于（内部）实现类，就如这里的例子。快速类查找揭示出：这些类都实现了看来很有希望成为这个问题答案的一组公共接口，也就是 ISourceReference、IJavaElement，尤其还有 IMember 查看本文来源