一个实现了ViewPart和EditroPart的简单RCP例子

这儿结合一个实例来更进一步的了解RCP的一些原理，怎样开发rcp程序，以及在初学RCP时会遇到哪些问题。

示例开发时环境：

------eclipse3.2

------jdk1.5.0_08

首先说一下我理解的RCP。一个rcp就是一个应用程序，只是这个应用程序不像大多数我们常用的应用程序。现在经常用的应用程序在发布后想再扩展一些功能，就需要重新在原有代码基础上进行修改。而rcp程序有一个优点，它可以实现插件是扩展。即可在现有程序的基础上增加一个插件，这个插件实现了我们要扩展的功能。

其实，整个eclipse体系中，核心的东西是一个很小的内核。其余的都是许许多多的插件由这个很小的内核组织起来，形成我们看到的eclipse的一个完整的开发环境。举个例子，我们整个实验室可以认为是一个eclipse开发环境。我们每个人就是一个插件，负责不同的方向，实现不同的功能；师兄可以认为是那个内核，负责把我们组织起来，把每个人的功能发挥出来。现在RCP也是同样的道理，可以认为一个RCP就是一个简化了的eclipse平台，它只包含5个插件:runtime是核心类，osgi是定义的一个标准，用来规范不同的插件，让他们可以相互协作。剩下的三个插件Workbench、SWT、JFace是用来显示给用户界面的。因此我们主要的精力应该放在对这三个插件的开发上。

前面介绍了一下eclipse和rcp的体系结构，在实际程序中遇到最多的还是一下几个主要概念，Workbench、Workbenchwindow、WorkbenchPage、Perspective、WorkbenchPart。其中WorkbenchPart又包含ViewPart和EditorPart；可以看出这几个概念是针对用户界面的。 理解了这几个概念以及它们之间的关系。基本上rcp就差不多了解了。需要注意的是这几个概念及其关系有个整体的把握即可，在初学阶段不应该花大量时间去研究它们为什么会存在这种关系，为什么是这样，而不是那样等等很抽象的一些东西上面。

下面就结合上面的几个主要概念，做一个比较简单的例子，几个主要步骤如下：

1、新建一个工程

2、创建一个ViewPart

3、为ViewPart创建菜单

4、添加菜单Action

5、创建一个EditorPart

6、创建调用EditorPart的Action

下面是具体步骤：

第一步：建立一个RCP工程。

file—> new—>project，选择plug-in project—>next 给工程起个名字MyRcp，其他不变—>next 这步中注意：在对话框最下面 Would
you like to create a rich client application? 一定要选择yes —>next 这步选择一个模版：RCP applicatin with an intro

—>next 直至finish

第二步：创建一个ViewPart

打开plugin.xml文件，会出现一个编辑器，找到extension选项卡 add—>输入org.eclipse.ui.views 确定即可在extension选项页中会发现org.eclipse.ui.views，右键单击，选择new---views

设置 id=myrcp.view 记住此id，因为后面打开ViewPart时会用到。

Name=myrcp.view。

Class=myrcp.intro.CustomerViewPart此类继承了ViewPart接口。

在myrcp.intro包中创建这个类，注意创建时要实现ViewPart接口。具体如何实现如下:

在myrcp.intro包上右键—>new—>class 在对话框中给要建的类起名为：CustomerViewPart,

Superclass 对应的文本框中右侧Browse 在其中输入ViewPart确定即可。

现在只是扩展了一个ViewPart，并且实现了一个ViewPart对应的类，具体ViewPart上面有什么我们还没有定义。下一步在这个ViewPart上面添加一个talbeviewer，并且在tableviewer中要显示几行数据。说明一下，这几行数据是通过固定赋值的方式实例化三个Customer对象，因此在画tableviewer之前要做一下准备工作。

(1)、创建Customer对象类--------Customer.java。

(2)、建一个Customer工厂类------CustomerFactory.java 实际就是实例化几个Customer对象。

(3)、创建tableviewer的ContentProvider类-------CustomerContentProvider.java。

(4)、创建tableviewer的LabelProvider类--------CustomerLabelProvider.java。

tableviewer要想显示数据必须实现ContentProvider和LabelParvider类。

这四个.java文件放在附件的customer和provider文件夹中。

在CustomerViewPart的createPartControl（）方法中加入创建tableviewer的代码。代码如下：

---------------------------------------------------------------------

viewer = new TableViewer(parent,SWT.MULTI|SWT.FULL_SELECTION);

TableColumn nameColumn = new TableColumn(viewer.getTable(),SWT.NONE);

nameColumn.setWidth(50);

nameColumn.setText("姓名");

TableColumn sexColumn = new TableColumn(viewer.getTable(),SWT.NONE);

sexColumn.setWidth(50);

sexColumn.setText("性别");

TableColumn bornDateColumn = new TableColumn(viewer.getTable(),SWT.NONE);

bornDateColumn.setWidth(150);

bornDateColumn.setText("出生日期");

TableColumn postColumn = new TableColumn(viewer.getTable(),SWT.NONE);

postColumn.setWidth(70);

postColumn.setText("职业");

viewer.getTable().setHeaderVisible(true);

viewer.getTable().setLinesVisible(true);

viewer.setContentProvider(new CustomerContentProvider());

viewer.setLabelProvider(new CustomerLabelProvider());

CustomerFactory.getCustomer().clear();

viewer.setInput(CustomerFactory.getCustomer());

---------------------------------------------------------------------

代码加入后一定会出现错误，

错误1：viewer没有定义，在CustomerViewPart定义一个TalbeViewer类型的属性viewer。

错误2：有几个包没导进来，方法ctrl+shift+o。

要想显示出ViewPart还需要在perspective.java的createInitialLayout()函数中加入如下代码

-------------------------------------------------------------------------------------

String editorArea=layout.getEditorArea();

layout.addView("myrcp.view",IPageLayout.LEFT, 0.5f, editorArea);

---------------------------------------------------------------------

第一个参数代表要显示ViewPart的id上文提到过

参数二：位置

参数三：所占比例

参数四：所在区域

第二步：为ViewPart创建菜单

为ViewPart加一个menu以及toolbar。当关闭ViewPart后仍可以通过它们来重新打开。

这儿注册的menu及toolbar是属于窗口的。因此可以直接在extension中对其扩展。

(这步操作比较繁琐，容易出问题)

方法：extension页中 add—>org.eclipse.ui.actionSets

(1)、右键org.eclipse.ui.actionSets new一个actionSet。Id=myrcp.OpenView

Name=myrcp.OpenView。注意visible一定要选择true

(2)、在这个actionSet上new一个menu。Id= OpenViewMenu

Label=Open

(3)、在这个menu上new一个separator。Name=ViewGroup。

(4)、回到第二步的actionSet，在它上面再new一个action。会看到有很多个属性。

设置如下：

Id=myrcp.openaction

Label=&Open

Menubarpath=OpenViewMenu/ViewGroup即上面定义的menu的id和separator的name。

toolbarPath= ViewGroup

icons=选择一个.gif的图片。补充一下，这之前应该把包含几个.gif格式的文件放到工程所在的目录下，这儿有个icons文件夹，在eclipse中刷新工程按F5

class=myrcp.intro.sampleAction

sampleAction是一个实现了接口IWorkbenchWindowActionDelegate的action类。

它用来触发点击菜单后打开ViewPart的动作

(5)、在myrcp.intro包中创建sampleAction类。注意实现接口 IWorkbenchWindowActionDelegate

(6)、在sampleAction中添加如下代码

定义一个变量：private IWorkbenchWindow window

重写run函数

---------------------------------------------------------------------

public void run(IAction action){

try{

window.getActivePage().showView("myrcp.view");

}catch (PartInitException e){

e.printStackTrace();

}

}

重写init函数

---------------------------------------------------------------------

public void init(IWorkbenchWindow window){

this.window = window;

}

---------------------------------------------------------------------

第三步：创建一个EditorPart

扩展一个EditorPart，回到extension页面。add----org.eclipse.ui.editors

（1）、New一个editor。

Id=myrcp.editor name=myrcp.editor

选择一个icons（必须）

Class=myrcp.intro.CustomerEditor。

创建这个类，它实现了EditorPart。（这儿不用直接创建，在包myrcp.intro中，导入EditorPart的java文件，在文件夹editor下）。

（2）、EditorPart会对应一个EditorInput，目的是实现对editor的输入数据。

因此再导入一个EditorInput。（在文件夹editor下）

第四步：为EditorPart创建一个Action

EditorPart已经扩展了，但没有地方可以调用它让他显示出来。可以为它加个toolbar或者memubar来打开。

有两种方法，第一种：如同打开ViewPart，定义一实现接口IWorkbenchWindowActionDelegate的action，然后在window窗口中扩展menu及toolbar。通过它们打开editor。但这样不容易对ViewPart中表格的数据进行控制。如取得一条记录的相关信息显示在editor中。或者有些属性内容太长在表格中无法全部显示出来，编辑时就会用到editor。

另一种方法就是直接给ViewPart添加一个toolbar。让这个toolbar来控制打开EditorPart。

这儿采用第二种方法。

(1)、在CustomerViewPart中定义一个函数contributeToActionBars(), 在此函数中，new一个Action，将此Action注册到ViewPart的toolbar中。

函数代码如下：

------------------------------------------------------------------

private void contributeToActionBars(){

ClickAction =new Action(){

public void run(){

Object customer =((StructuredSelection)viewer.getSelection()).getFirstElement();

CustomerEditorInput in = new CustomerEditorInput((Customer)customer);

try {

getSite().getWorkbenchWindow().getActivePage().openEditor(in,CustomerEditor.ID);

} catch (PartInitException e) {

MessageDialog.openError(getSite().getWorkbenchWindow().getShell(), "Error", "Error opening view:" + e.getMessage());

}

}

};

ClickAction.setText("编辑");

IActionBars bar=getViewSite().getActionBars();

bar.getToolBarManager().add(new ActionContributionItem(ClickAction));

}

这儿也会出现错误，ClickAction没有定义。在ViewPart中定义一个Action类型的ClickAction。

最后在createPartControl（）中调用contributeToActionBars（）即可