Image对象是一个包装了本地资源的Java结构，不能被Java的垃圾回收器管理。加载图像而不卸载，会导致内存泄漏。

Eclipse使用ImageDescriptor来描述Image，ImageDescriptor可以通过getImageDescriptor()方法来获得。

创建编辑器的上下文操作，targetID="#TextEditorContext"，为eclipse默认文件编辑器的上下文菜单标识符。实现类必须实现IEditorActionDelegate接口。

Java编辑器对应的ID为：#TextEditorContext和 #CompilationUnitEditorContext，定义好targetID，就把我们的插件id指向视图菜单的id了。这样Java编辑器就会添加我们的菜单项了。

targetID用来与特定的编辑器，查看器，菜单绑定。

命令与键绑定，和操作相关联。命令只是操作的声明，操作的具体实现细节由操作本身来完成。将命令从操作实现中分离出来。

Org.eclipse.ui.commands扩展点 定义命令

Org.eclipse.ui.bindings扩展点 与命令和键绑定

视图的实现类都必须实现org.eclipse.ui.IViewPart接口，一般都会集成org.eclipse.ui.ViewPart类。

视图的行为由一个实现了org.eclipse.ui.IViewPart接口的类定义

IStructuredContentProvider结构化内容提供者负责从输入对象中提取对象，把它传递给表格查看器进行显示。AddressViewContentProvider实现IStructuredContentProvider（内容与查看器的绑定）和 AddressManagerListener接口（监听模型变化）。

AddressViewContentProvider通过AddressManager获取模型来提供显示

AddressViewContentProvider实现AddressManagerListener的addressesChanged方法。

LableProvider标签提供者将获取内容提供者返回的一个表格行对象，并提取要显示到的列上的值。

ITableLabelProvider接口要求实现getColumnText和getColumnImage两个主要的方法，getColumnText返回指定单元格的显示文本，getColumnImage返回指定单元格的显示图标。

根据对表格列的判断来显示相应区域的文本和图像。

public String getColumnText(Object element, int columnIndex)，其中element表示单元格所在行的对象，columnIndex表示单元格所在的列，返回显示的文本。

public Image getColumnImage(Object element, int columnIndex)，其中element表示单元格所在行的对象，columnIndex表示单元格所在的列，返回此单元格的显示图标。

ViewerSorter查看器排序器用于对内容提供者提供的元素进行排序，继承ViewerSorter类。

一个视图仅可以有一个内容提供者，一个标签提供者和一个排序器，但过滤器可以有很多个。

ViewerFilter类用于确定显示内容提供者返回的哪些行对象，不显示哪些行对象。

获取当前选中项，先查找视图，找到该视图后，调用getSelection()得到当前选择项，然后马上转换为IStructuredSelection，以后的操作就是统一的了，因为有IStructuredSelection接口。如果是在action中遇到这种需求，就将event调用getSelection()，然后转换为IStructuredSelection，后续操作相同。

Eclipse的每个视图（View）都有自己的菜单和工具条，View通过与自己相关的IViewSite对象与这些东西打交道，确切的说，是通过这个IViewSite对象的IActionBars对象来管理，ActionBars对象负责菜单、工具条和状态栏。

makeActions是创建操作，必要的IAction对象，这些对象可用在菜单、工具条里。

hookContextMenu是把刚刚创建的IAction对象放进与View相关的MenuManager里。

当触发了menu事件时，重新填充（fillContextMenu）

setRemoveAllWhenShown(true)的作用是清空以前显示的菜单项。不把removeAllWhenShow置为true的话，每点一下右键你就会看到菜单项多出一倍来。

用MenuManager可以创建出一个Menu对象，然后我们用表格的setMenu方法将表格控件与Menu控件联系在一起就好了。

getSite().registerContextMenu(menuMgr, viewer)这是context menu能不能显示的关键。一个视图中可以有多个context menu，而每一个context menu都必须注册给workbench。这需要通过调用org.eclipse.ui.IWorkbenchPartSite.registerContextMenu(MenuManager menuManager, ISelectionProvider selectionProvider)或者（当有多个注册的context menu时）org.eclipse.ui.IWorkbenchPartSite.registerContextMenu(String menuId, MenuManager menuManager, ISelectionProvider selectionProvider) 增加的参数menuId用于区分不同的context menu。

上下文菜单比工具栏多一步创建上下文菜单。

属性视图支持所有实现IResource接口的资源。

一个视图（View）希望得到另外一个视图显示的内容，或者选择的内容。在Eclipse中，比较标准的做法是通过ISelectionProvider和ISelectionListener来完成的。

Eclipse为了解决这个问题，提供了所谓的Site，以及ISelectionService机制，来处理视图之间的简单的交互。简单的说，ViewSite提供了一个交互的中心点，其它View向ViewSite提供选择事件，或者向其注册监听器，而事件的触发与转发则由ViewSite()来完成。只需在View中实现ISelectionListener接口，就可以监听其他Workbench部分发生的选择事件。

向Workbench注册监听器

getSite().getPage().addSelectionListener(this);

向特定WorkbenchID注册监听器

getSite().getPage().addSelectionListener(String WorkbenchID, ISelectionListener);

并实现selectionChanged方法来处理监听器捕获到的事件。

一个ISelectionProvider如果希望被别的View进行监听的话，则应该向其Site()进行注册。

getViewSite().setSelectionProvider(viewer);

IPropertySource的实现类必须为每个显示在属性视图中的项创建一个属性描述符。

ComboBoxPropertyDescriptor可以在属性视图的单元格中显示复选框，但必须为其定义标签提供者和一组String数组为显示内容。getText的参数是getPropertyValue的返回值，这个返回值必须是整数。在ComboBoxPropertyDescriptor中，每个项是按照它们的索引号来区分的。在initProperties中，将类别名用整数表示。

Integer item = (Integer)element;

表格查看器添加状态栏支持，则表格查看器添加监听器ISelectionChangedListener。

“插件是为系统提供功能的代码和/或数据的结构化包。可以以代码库（带有公共 [应用程序接口] API 的 Java 类）、平台扩展甚至文档的形式来提供功能。插件可以定义扩展点、定义良好的位置，其他插件可以在这些位置添加功能。”

Eclipse使用OSGi作为插件系统的基础。动态添加新插件和停止现有插件的能力。以动态方式管理组件生命周期的一个健壮的系统。

OSGi是基于Java的框架，旨在用于需要长运行时间、动态更新和对运行环境破坏最小的系统。

OSGi规范定义了绑定包生命周期的基础架构和绑定包的交互方式。这些规则通过使用特殊 Java类加载器来强制执行。

在一般Java应用程序中，CLASSPATH中的所有类都对所有其他类可见。相反，OSGi类加载器基于OSGi规范和每个绑定包的manifest.mf文件中指定的选项来限制类交互。

在3.1之前版本的Eclipse中，在每个插件的plugin.xml文件中定义插件依赖关系以及扩展和扩展点。在使用OSGi的新版本Eclipse中，依赖关系信息被分解到manifest.mf文件中，而 plugin.xml文件只包含扩展和扩展点的XML定义。

插件级的依赖关系改为需要显式导出和导入包的依赖关系。插件开发人员必须进行专门选择来使插件中的功能可供外部使用。该限制允许内部包保留在内部，避免插件暴露不必要的类。

Eclipse的扩展和扩展点 可插拔

每一个希望被别的模块扩展的模块，都必须声明一系列的扩展点，即插座；希望在这个模块上扩展功能的模块，需要按照扩展点的什么来编写扩展，即插头。扩展点提供服务，扩展是要服务。

延迟装载，只有在一个插件被其他模块调用的时候，才装载到内存中。

通过将扩展的声明和实现分离，eclipse实现类延迟装载。

扩展点和扩展的声明都是通过XML文件完成的，即清单文件MANIFEST.MF，描述了一个插件能够做什么，而JAVA代码则具体完成这些功能。系统启动时，只需搜索清单文件，建立一张索引表，知道有哪些插件以及能够提供什么服务。当eclipse第一次启动时，eclipse运行时会遍历plugins文件夹中的目录，扫描每个插件的清单文件信息，并建立一个内部模型来记录它所找到的每个插件的信息。

RCP包括基于OSGi的运行时框架Equniox，基于SWT/JFace的图形模块，eclipse平台的UI和Runtime模块。基于Eclipse的应用程序所需的最小插件集称为Eclipse Rich Client Platform（RCP）

Platform Runtime 平台运行库是内核，它在启动时检查已安装了哪些插件，并创建关于它们的注册表信息。即在eclipse运行时发现和管理插件。为降低启动时间和资源使用，它在实际需要任何插件时才加载该插件。除了内核外，其他每样东西都是作为插件来实现的。

Workspace 工作区是负责管理用户资源的插件。这包括用户创建的项目、那些项目中的文件，以及文件变更和其他资源。工作区还负责通知其他插件关于资源变更的信息，比如文件创建、删除或更改。

Workbench 工作台为Eclipse提供用户界面。它是使用标准窗口工具包（SWT）和一个更高级的 API（JFace）来构建的；SWT 是 Java 的 Swing/AWT GUI API 的非标准替代者，JFace 则建立在 SWT 基础上，提供用户界面组件。

插件可以扮演双重角色，其他插件服务的使用者和其他插件服务的提供者。

manifest.mf

Bundle-Activator

该类用于启动和停止绑定包。该类扩展 org.eclipse.core.runtime.Plugin，实现了 BundleActivator 接口。

Bundle-Version

该属性指定绑定包的版本号。包导入和必需的绑定包规范可以包括绑定包版本号。

Export-Package

该属性指定要公共暴露给其他插件的所有包。

Import-Package

该属性指定要从必需插件中显式导入的所有包。默认情况下，必须为要启动的绑定包解析所有包。还可以将包导入指定为可选项，以支持包不存在的情况。显式导入的类在 Require-Bundle 插件中的包之前解析。

Require-Bundle

该属性指定要在给定绑定包中导入使用的绑定包及其已导出的包。指定的绑定包在显式包导入之后解析。

----------------------            --------------------
|plugin A            |            |plugin B          |
|   ---------------  | contibute  |  --------------  |
|   | ext point p | <--------------- | extension  |  |
|   ---------------  |_           |  --------------  |
|         ||         | |          |        ||        |
|   ---------------  | |implement |  --------------  |
|   | interface I | <--|------------ | class  C   |  |
|   ---------------  | |          |  --------------  |
---------------------- |          ----------/ -------
                       |  create, call       |
                       ----------------------|

你可以把extension point想为接口, 而我们扩展这些extension,其实就是实现了这个接口

假设plugin A定义了一个extension point,  plugin B定义了一个extension,是基于plugin A的这个extension point的,它的实现类是class C,那eclipse启动后, 会读取每个plugin的配置plugin.xml,然后发现plugin B有一个基于ext point p的扩展,那它就会用interface I作为对象, 然后实例化一个class C, 就等于实现了这个extension

eclipse的内部实现
IPluginRegistry registry = Platform.getPluginRegistry();
IExtensionPoint extensionPoint = registry.getExtensionPoint(xpid); //通过扩展点ID获得扩展点
IExtension[] extensions = extensionPoint.getExtensions(); //获得该扩展点的所有扩展
// For each extension ...
for (int i = 0; i < extensions.length; i++) {
    IExtension extension = extensions[i];
    IConfigurationElement[] elements = extension.getConfigurationElements(); //获得扩展点配置元素
    configurationElement[j].createExecutableExtension(“Class”); //为每个回调对象创建实例

    ……
}
eclipse就是注册每一个extension和extension point，然后用extension point来实例化它对应的那个extension。

发生事件并向其它对象请求处理的对象被称为“事件对象”，而处理事件的对象被称为“回调对象”。回调对象由扩展者插件定义，由宿主插件创建实例。

对org.eclipse.ui.popupMenus扩展点

1、  viewerContribution，也就是通过视图的id。这样只有视图id和给定的id一致的时候，它的弹出菜单才会增加我们定义的菜单项。实现类必须实现IObjectActionDelegate接口

2、  objectContribution，通过对象类型。当在视图里选定的对象类型和给定的一致时，在视图的弹出菜单增加我们定义的菜单项。实现类必须实现IViewerActionDelegate接口

 对org.eclipse.ui.viewAction扩展点

       viewContribution 添加视图工具栏与添加视图下拉子菜单。实现类都必须实现IViewActionDelegate接口

创建编辑器的上下文操作，targetID="#TextEditorContext"，为eclipse默认文件编辑器的上下文菜单标识符。实现类必须实现IEditorActionDelegate接口

所有视图必须实现org.eclipse.ui.IViewPart接口

IViewPart和IEditorPart都继承自IWorkbenchPart

ResourceNavigator即可被实例化，又可以被继承

ContentOutline和PropertySheet视图不能被再次实例化也无法被继承，它们仅有的实例是由工作台创建并管理的，可以被引用。可以通过IWorkbenchPage的showView()方法显示ContentOutline和PropertySheet。BookmarkNavigator和TaskList

视图模式

VIEW_ACTIVATE
          Show view mode that indicates the view should be made visible and activated.

         激活定义视图的插件并在当前页面中显示视图

VIEW_CREATE
          Show view mode that indicates the view should be made created but not necessarily be made visible.

VIEW_VISIBLE
          Show view mode that indicates the view should be made visible.

         该视图可见，但不会立即显示该视图

createPartControl(Composite)定义视图的用户界面。

TableViewer的责任是用特定的对象填充到Table窗体组件中。是我们最终在窗体要看到的对象。

IStructuredContentProvider和ITableLabelProvider的实现类是用来帮助TableViewer来完成这个任务的。

结构化内容提供者IStructuredContentProvider负责从输入对象中提取对象，并把它们传递给表格查看器进行显示。

标签提供者LabelProvider将获得内容提供者返回的一个表格行对象，并提取要显示到列上的值。

所以，要实现一个在TableView中显示特定对象只需要实现IStructuredContentProvider实现类的getElements方法。和ITableLabelProvider的getColumnText和getColumnImage方法。

查看器排序器ViewerSorter用于对内容提供者提供的元素进行排序。

视图过滤器

获取到的有关“当前选择项”内容，先查找视图，找到该视图后，调用getSelection()得到当前选择项，然后马上转换为IStructuredSelection，以后的操作就是统一的了，因为有IStructuredSelection接口。如果是在action中遇到这种需求，就将event调用getSelection()，然后转换为IStructuredSelection，后续操作相同。

KeyEvent

Character, 就是按键对应字符

stateMask则是用来检测Alt，Shift，Ctrl这些键有没有同时被按下。stateMask与这些键的键码进行位与运算，如果得到的结果不是0就说明这些键被按下了，比如如果stateMake & SWT.ALT不为零，我们就可以认为Alt键被按下了。

属性视图支持所有实现IResource接口的资源。

Java是一种强类型语言，每个实例都必须有指定的类型。实际上，Java类型有两种声明类型和运行时类型(也可以相应的说是静态类型 和动态类型)。

可以把IAdaptable想象为一个能够动态进行类型转换的途径。其实这种机制可以让我们将目标类转换为它并没有实现的接口。

大部分IAdaptable的实现是一些if语句的叠加，实现getAdapter()方法。getAdapter()方法的调用者需要传入一个代表特定接口的Class对象，该方法则会返回一个具有该接口的对象。

在Eclipse中，比较标准的做法是通过ISelectionProvider和ISelectionListener来完成的。Eclipse为了解决这个问题，提供了所谓的Site，以及ISelectionService机制，来处理试图之间的简单的交互。简单的说，ViewSite提供了一个交互的中心点，其它View向ViewSite提供选择事件，或者向其注册监听器，而事件的触发与转发则由ViewSite()来完成。

注意SelectionProvider和SelectionListener并不直接对应。这个地方有一点容易混淆，就是Eclipse实际上提供有两套与Selection相关的事件与接口：

ISelectionChangedListener <--> ISelectionProvider

这个是JFace中的选择监听机制，对试图或者控件而言，它提供对原始的选择事件的通知与响应。ISelectionProvider需要注册在Site上，以供ISelectionSerivce使用，将选择事件扩散到其他的ISelectionListener中。

ISelectionListener <--> ISelectionService

这个是在Site中使用的，ISelectionService不需要自己实现，已经实现好了，ISelectionListener则需要注册到ISelectionService上，以对其它SelectionProvider的事件响应进行监听。

在Eclipse本身的实现中，PropertySheet和Outline都使用了这种机制。不过需要注意的是，缺省的PropertySheet需要接受一个IStructuredSelection，而不仅仅是一个ISelection。因此，如果ISeletionProvider需要提供一个能够让PropertySheet进行显示的对象的话，除了除了要实现ISelection接口外，还需要对其进行封装成一个IStructuredSelection。这个比较简单，直接调用StructuredSelection构造函数即可。

Protected类型不希望其他类使用该方法。

A site maintains the context for a part,
including the part, its pane, active contributions, selection provider, etc.
Together, these components make up the complete behavior for a
part as if it was implemented by one person.

The PartSite lifecycle is as follows ..

  (1) a site is constructed
  (2) a part is constructed and stored in the part
  (3) the site calls part.init()
  (4) a pane is constructed and stored in the site
  (5) the action bars for a part are constructed and stored in the site
  (6) the pane is added to a presentation
  (7) the SWT widgets for the pane and part are created
  (8) the site is activated, causing the actions to become visible

以前做插件用到的ActionSet都只是依葫芦画瓢,没有真正理解它,现在开始好好学习学习,主要是看"Building Commercial-Quality Plug-ins"写的

Action的组成包括几个部分,一个是在plugin.xml中的声明,一个是在Eclipse UI中会用到的IAction实例化对象, 另一个是封装在IActionDelegate中的action执行代码. action的实例化是基于plugin.xml配置文件和IActionDelegate定义的,Eclipse可以先在界面上将action显示出 来,直到用户点击了菜单或者工具条按钮才会去真正的加载插件,这也就是所谓的Eclipse的延迟加载机制

IActionDelegate有几个子类需要说明一下:
IActionDelegate2 如果实现IActionDelegate需要一些其他的信息,而这些信息在IActionDelegate销毁时需要同时被销毁时, 它可以提供相关是生命周期事件方法来处理
IEditorActionDelegate 是跟editor相关的
IObjectActionDelegate 是跟上下文菜单相关的
IViewActionDelegate 是跟view相关的
IWorkbenchWindowActionDelegate是跟menubar和toolbar相关的

Actions和Eclipse中的其他东东一样,也是通过扩展点org.eclipse.ui.actionSets来添加到Eclipse IDE的各个地方,actions的外在表现形式主要有menubar, toolbar, context menu这样几种

在actionSets的下级节点是actionSet, 它有几个属性,id,label都不用说了,还有一个visible属性,表示在打开Eclipse时是否显示该action,通常我们可以通过 Window > Customize Perspective...来设置action是否可见

在actionSet下可以添加menu节点, 它的id,label属性不用说了,其中的path是用来指定菜单的显示位置的,一般设置为additions

action并不是直接添加到menu上的, 而是跟menu内部的group关联的,所以我们必须先在menu下创建group,即新建groupMarker, 其name必须保证在当前menu下唯一, menu还有一种叫separator的group, 在separator group处添加的menu item会在这个组中的第一个菜单项上面添加一条水平线.而groupMarker则不会有线, 当其他action要添加到该menu group下时,使用水平线进行分组就显得非常必要

group只是用来标识menu的位置,即指这个位置可以添加菜单项, 而不是实际的menu item, 实际的menu item是action

因为menu会有层次关系,所以actionSet中专门用一个menu节点来表现这种层次关系, 而toolbar则没有这种情况,所以这里没有提供toolbar节点

在actionSet下添加action就是最终我们要toolbar上显示的按钮和menubar上的menu item, 这里有几个属性, id和label不用说了,menuBarPath是menu要显示的位置, 比如"com.qualityeclipse.favorites.workbenchMenu/content",这个值就是actionSet+" /"+group name, toolbarPath 就是toolbar item的显示位置, 比如"Normal/additions", 还有几个属性不常用到,但是有必要解释一下

allowLabelUpdate这个要在retarget属性为true的时候有效,还不是很清楚

class 是menu或button要执行的动作, 如果使用的是pulldown风格的action,还需要实现IWorkbenchWindowPulldownDelegate接口,它的构造函数是无 参数的,如果要传递参数,还需要是要实现IExecutableExtension 接口, 这个接口还不是很清楚

definitionId 这个是用来指定action对应的command唯一标识符的

enablesFor 是一个表达式,用来表示当前action是否可用

retarget 不是很理解

state主要是针对style属性为radio和toggle的,表示当前action是否被选中

style:默认是push,还有radio,表示一组menu中只能有一个被选中, toggle当它是checkbox好了, pulldown说明是子菜单项或者是下拉toolbar menu

对于action所使用的图标,我们可以从Eclipse下的plugins\org.eclipse.ui_3.1.2.jar 和 plugins\org.eclipse.jdt.ui_3.1.2.jar得到一些gif的图片

Eclipse中actionSet以及下级元素都是有id的,而且他们可以通过一种path的方式来进行指定,比如 com.qualityeclipse.favorites.workbenchMenu/content,如果上一级节点是workbench menu bar或者是view content menu的话,那么它的上一级节点是不用指定的,只要指定group就好

为了方便其他的插件的action能添加到该插件的actionSet下, 在为插件定义group的时候, 会添加一个为additions的group, additions是eclipse使用的一个默认标识符,用来表示其他action或menu显示的位置, 在class中它的对应常量是IWorkbenchActionConstants.MB_ADDITIONS, 比如我们定义了一个menu,指定其path为additions, 这表示我们的menu将添加到window的左边,因为这个就是workbench menubar的additons所在的位置, 如果指定的是window/additions, 那么将作为子菜单项添加到window下

当一个actionSet下定义的action跟另一个actionSet下定义的menu关联的时候将发生Invalid Menu Extension (Path is invalid): some.action.id的异常, 为了避免这种问题,menu需要在两个actionSet都定义

toolbarPath的指定也跟menuBarPath有同样的情况, 比如定义为Normal/additions, 这里的Normal指的是workbench toolbar, additions就是action要显示的group位置

action的class属性是封装了执行动作的类,它实现了IWorkbenchWindowActionDelegate, 在它里面有几个方法需要介绍一下, 一个是selectionChanged, 用来动态修改action的state状态值, 是否可用,以及action的text属性等, 比如对于enableFor属性来说, 它根据选中对象的数量来判断action是否可用, 但是通过selectionChanged可以通过当前选定的对象的情况来调用setEnable()方法从而更精确的控制action是否可用, 有时候当插件还没有加载,在调用action的run方法时会加载插件,这时可能在调用run()方法之前没有调用selectedChange方法, 因此在run()方面里面需要写一些防护性代码,比如空值的判断之类的, 另外run()是在主UI线程中执行的,因此,如果该执行耗时较长,需要将其放到后台线程中执行.

插件运行之后在menubar和toolbar上看到定义的actionSet,可以试试下面的方法:
在Window > Customize Perspective... 下看看是不是actionSet没有选中
使用Window > Reset Perspective刷新当前视图
关闭重新打开当前视图
如果还没有出来,可以在在run或者debug的设置中将"Clear workspace data before launching "选中, 然后再启动运行

虽然通过扩展点可以非常方便的在Eclipse上添加,但是这个玩意儿多了也不是什么好事, 可能会降低用户体验,因此需要进行控制, actionSet扩展点也有相关的设置来指定是否可见, 而且还可以调用IActionSetDescriptor.setInitiallyVisible() 来控制顶层菜单是否可见, 另一种解决办法就是在首选项中提供一个checkbox让用户决定是否显示顶层菜单,其编程实现就是在代码中调用 IActionSetDescriptor.setInitiallyVisible()和 IWorkbenchPage.hideActionSet()来进行控制
来自：http://hi.baidu.com/xianle/blog