eclipse3.7插件构建自定义右键菜单
1.1 简介
在开发工具上添加自己需要的功能,可以基于eclipse的插件进行扩展以满足新功能的需要。下面就说说如何在eclipse上如何添加菜单项。
1.2 建立工程
新建eclipse插件工程
工程名自定义一下,我的工程名是com.popmenu.extend
选择下一步,在这里可以用向导给我们自动生成的,也可以建立完成之后到扩展点自己添加,这里我们选择默认的模板。
选择popup模板
点击下一步
其中Target Object’s Class:这里指定了目标对象,就是说在哪里点击右键能够显示对应的菜单。
Submenu Name:这个是指定你要显示的菜单在右键弹出后的名称,我们起名叫“构建系统”。
Action Label:这个指定了显示的子菜单的名称,这里修改为“模板构建”。
Java Package Name:这里指定了点击模板构建后的处理类的包名,使用默认。
Action Class:这个是处理类的名称,改为TemplateAddAction。
Action is enabled for:表示选择的是单选还是多选,这里用默认。
点击完成。
生成的项目结构如下:
1.3 Eclipse的资源API
工作空间、项目、文件夹、文件对应的类型接口分别为IWorkspace、IProject、IFolder、IFile。资源相关
的接口都继承了IResource接口,由于工作空间并不只是资源的管理者,因此IWorkspace并没有继承IResource
接口,为了将工作空间作为资源的管理者这一功能体现出来,抽象出了IWorkspaceRoot 的接口(即工作空间
根目录),通过IWorkspace的getRoot 就可以得到对应的工作空间根目录。由于工作空间根目录、项目、文件
夹都是可以容纳其他资源的,因此为它们抽取了一个基类接口IContainer。
类的层次结构图如下:
资源接口的常见方法
(1) IResource
l delete:删除此资源。
l getFileExtension:返回文件的扩展名。
l getFullPath:返回此资源相对于工作空间根目录的相对路径,返回值类型是IPath。
l getLocation:返回此资源在文件系统中的绝对路径,返回值类型是IPath。
l exists:判断此资源是否存在。处理资源与使用Java.io.File 处理文件非常相似。IResource只是一个句柄。当调用像getProject、getFolder 这样的方法时,会将句柄返回给资源,即使指定的资源并不存在。因此在必要的时候要使用exists 方法来确定资源是否存在。
l getParent:得到父资源容器,返回值类型为IContainer。
l getProject:返回此资源所属的项目,返回值类型为IProject。
l getProjectRelativePath:返回此资源在项目中的相对路径,返回值类型是IPath。
l getWorkspace:返回此资源所属的工作空间,返回值类型为IWorkspace。
l isSynchronized:判断资源是否与文件系统同步。
(2) IContainer
l exists(IPath path):判断指定的路径path是否在本容器内存在。
l findMember:返回指定路径的资源,返回值类型为IResource。
l getDefaultCharset:返回此容器内资源的默认编码。
l getFile:返回指定路径的文件,返回值类型为IFile。
l getFolder:返回指定路径的文件夹,返回值类型为IFolder。
l members:返回容器下的所有直接资源,返回值类型为IResource[]。
(3) IFolder
l create:创建此文件夹所代表的资源。
l getFile:返回此文件夹下指定路径下的文件,返回值类型为IFile。
l getFolder:返回此文件夹下指定路径下的文件夹,返回值类型为IFolder。
(4) IFile
l appendContents:向文件中附加数据流,方法中有一个参数是InputStream类型,要添加的数据流就是在此流中。
l create:用数据流创建文件,方法中有一个参数是InputStream类型,要创建的文件的数据流就是在此流中。
l getCharset:返回文件的编码。
l setCharset:设定文件的编码。
l getContents:返回文件的流,返回值类型为InputStream。
l setContents:用数据流设定文件的内容,方法中有一个参数是InputStream类型,要设定的文件的数据流就是在此流中。
(5) IWorkspaceRoot
l getProject:返回指定名字的项目,返回值类型为IProject。
l getProjects:返回工作空间中所有的项目,返回值类型为IProject[]。
1.4 设置工程
双击plugin.xml,选择Dependencies,在eclipse的插件项目中如果想添加依赖,必须在此处添加不能通过工程右键进行添加,否则会找不到对应的jar提示错误。因为这里用到了org.eclipse.jdt.core包所以添加。
点击添加:
然后点击Extensions出现扩展点的选择界面。
可以看到我们添加的菜单的内容。选中objectContribution将其它objectClass设置成 org.eclipse.jdt.core.IJavaElement 表示在java工程上边能够看到提示菜单,设置完成后就可以运行一下示例看看效果了。
右键选择工程run as -> eclipse application。
如果想在其它视图下也可以看到菜单,需要设置adaptable的属性为true,这样在其它视图就也可以看到右键的内容了。