RCP中文入门知识

RCP 中文入门教程 Page 1 of 21
RCP中文入门教程
赵阳 2005.12.26
简单地讲, 一个RCP应用就是一个可独立于Eclispe IDE开发环境运行的Eclipse 插件.
下面我们以一个简单的例子开始我们的RCP旅程.
一、 新建插件工程
因为RCP应用本身就是一个Eclispe插件, 所以从新建一个Eclispe插件工程开始.
1) 启动Eclispe, 从Eclispe的 File菜单创建一个插件工程:
File à New à Project à Plug-in Development à Plug-in Project
点击Next, 进入New Plug-in Project插件向导:
在Project Name中输入工程名称: simplebrowser (最好小写)
勾选 ”Create an OSGi bundle mainfest” 使用OSGi打包清单.
OSGi是Eclipse 3.0 以上版本用于动态装载插件的标准, 在Eclipse 2.1中是不需要的.
最好选中它.
点击Next按钮.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 2 of 21
修改Plug-in ID 及其他插件属性值. 这里采用默认值, 在 ”Rich Client Application” 一栏
中, “Would you like to create a rich client application ?” 一项选择 ”Yes” 设置创建的插件
为RCP应用. 点击Next.
在模板中选择最基本的Hello Rcp 模板, 点击 “Finish” 按钮, Eclispe将会创建一个简单
的RCP应用并且自动打开插件清单编辑器的主页面. 在这里你可以方便的配置你的
RCP应用, 免去手工编写和修改配置文件的麻烦.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 3 of 21
在插件清单编辑器的OverView 页, 点击 “Lanch an Eclipse application” 链接就会看到你
的RCP应用运行时的样子.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 4 of 21
2) 工程创建完成后, Eclipse将自动生成以下内容:
l Application类
l ApplicationActionBarAdvisor 类
l ApplicationWorkbenchAdvisor 类
l ApplicationWorkbenchWindowAdvisor
类
l SimplebrowserPlugin 类
l Perspective 类
l plugin.xml 文件
l build.properties 文件
a) Application类
Application类是RCP应用的主程序, 相当
于整个RCP应用的控制器.
Application类的职责是创建一个工作台(Workbeanch)然后添加一个工作台顾问类
(WorkbeanchAdvisior). 它是启动RCP应用运行的第一个程序.
这个类实现了 Eclipse 的 IPlatformRunnable 接口. 对于绝大多数的RCP应用, 这个
类的代码都是不用修改的.
工作台(Workbeanch)是RCP框架的一部分, 一个RCP应用只能有一个工作台, 但是
可以有多个工作台窗口(WorkbeanchAdvisior). 工作台的结构如下:
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 5 of 21
b) Advisor类
ApplicationActionBarAdvisor, ApplicationWorkbenchAdvisor和ApplicationWorkbenchWindowAdvisor
这三个类是 RCP应用的三个核心Advisor类. 它们都继承于相应的抽象Advisor父
类. 是RCP应用生命周期中非常重要的三个类.
ApplicationWorkbenchAdvisor
在主程序 Application 类的run() 方法中引用了 ApplicationWorkbenchAdvisor 类.
这个 Workbench Advisor 类对 Workbench 的外观进行了配置.
ApplicationWorkbenchAdvisor 继承了WorkbenchWindowAdvisor 抽象类, 插件工程
向导自动填充了createWorkbenchWindowAdvisor和getInitialWindowPerspectiveId
方法体, 我们同样可以覆写( override )父类的其他方法. 这个类的方法会在工作台
( Workbench )的生命周期的各个关键时刻由RCP平台调用. 是最重要的一个
Advisor类.
下面是对Workbench Advisor 类中几个重要的方法的简要说明:
方法 说明
initialize 在启动工作台 ( Workbench ) 前进行初始化.
这个方法有只有一个参数: IWorkbenchConfigurer
preStartup 在初始化完成之后, 打开第一个窗口之前调用, 在这里可以对打开编辑器
和视图的初始化参数进行设置.
postStartup 在所有窗口打开或恢复以后开始事件循环之前调用. 在这里可以进行一些
类似自动批处理的工作.
preShutdown 在事件循环结束以后, 关闭任何一个窗口之前调用
postShutdown 在所有窗口关闭之后, 关闭工作台 ( Workbench ) 之前调用, 可以用来保存
当前应用的状态, 清理 initialize 方法创建的内容
现在我们不需要对这个类进行任何修改.
ApplicationWorkbenchWindowAdvisor
ApplicationWorkbenchWindowAdvisor 继承了WorkbenchWindowAdvisor 类, 这个
类主要负责对 Worbench Window 进行控制, 例如状态栏, 工具条, 标题, 窗口尺寸等.
这个类中的方法在 Workbench Window 的生命周期中起着重要作用.
方法 说明
preWindowOpen 在 WorkBench Window 的构造函数中调用, 用于设置窗口
的一些特征, 如 是否显示状态栏. 但是这个时候还没有创建
任何窗体控件, 所以在这里还不能引用它们.
postWindowRestore 在窗口恢复到以前保存的状态之后, 打开窗口之前调用..这
个方法在新建窗口, Workbench第一次运行, 以及没有保存
窗口状态的情况下都不会调用. 在这里可以调用
IWorkbench.close() 方法关闭Workbench 和所有打开的
Workbench Window.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 6 of 21
postWindowCreate 在窗口创建以后, 打开以前调用. 或者是窗口恢复到以前保
存的状态后, 在执行postWindowRestore 方法之后调用.
openIntro Intro就是你第一次打开Eclispe的时候看到的内容, 这个方
法的默认的实现是:
如果IWorkbenchPreferences . SHOW_INTRO 属性被设置为
True, 那么在第一次打开窗口的时候将会调用这个方法, 在
Intro显示过之后该属性将会设置为False. 后来, 只有在
WorkbenchConfigurer.getSaveAndRestore() 方法返回True,
并且关闭窗口时intro仍然显示的时候才会调用这个方法.
postWindowOpen 在 Workbench 窗口打开之后调用, 可以在这里开/关(Tweak)
窗体控件, 例如设置Title, 改变窗口尺寸等等.
preWindowShellClose 这个方法在Workbench窗口关闭之前 ( 严格的讲是它的
Shell被关闭之前 ) 由关联到这个窗口的ShellListener调用.
如果窗口由于其他什么原因已经关闭了, 则不会调用这个
方法.
如果这个方法返回false, 那么关闭Shell的请求将会被忽
略, 所以, 这个是唯一的一个可以阻止用户关闭窗口行为的
地方, 也是提示用户是否保存当前工作和设置的最佳场所.
postWindowClose 在Workbench窗口关闭之后调用, 这个时候窗口中的控件
都已经被清除了. 在这里可以清除由. postWindowOpen 方
法创建的内容.
createWindowContents 这个方法用来创建一个窗口的内容,
默认的实现添加了一个菜单栏, 一个工具条, 一个状态栏,
一个透视图栏, 和一个快速视图栏. 这些控件的可见性可以
使用 IWorkbenchWindowConfigurer 中的 setShow* 方法进
行设置.
可以通过在子类中覆写( override ) 这个方法来实现自定义
的窗口内容和布局, 但是必须要调用
IWorkbenchWindowConfigurer.createPageComposite. .
方法.
这个方法只有一个参数: Shell
createEmptyWindowContents 创建并且返回在窗口没有页面显示的时候要显示的控件.
如果返回的是Null, 则会使用默认的窗口背景. 覆写这个方
法可以实现自定义的窗口背景. 默认的实现是返回 Null .
这个方法只有一个参数: Composite
插件工程向导自动帮我们填充了createActionBarAdvisor 和 preWindowOpen 方法
体, 在 preWindowOpen 方法中我们看到向导隐藏了窗口的工具条和状态栏, 并且设
置了窗口的大小和标题栏上显示的文字:
public void preWindowOpen() {
IWorkbenchWindowConfigurer configurer = getWindowConfigurer();
configurer.setInitialSize(new Point(400, 300));
configurer.setShowCoolBar(false);
configurer.setShowStatusLine(false);
// 设置窗口标题栏文字
configurer.setTitle("Hello RCP");
}
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 7 of 21
在这个类的方法中常常需要使用到 Configuer 接口对窗口进行配置, 在方法体中直
接调用getWindowConfigurer()方法就可以直接获得IWorkbenchWindowConfigurer
对象了, 就像向导在 preWindowOpen() 中所做的一样.
ApplicationActionBarAdvisor
ActionBarAdvisor 类继承了ActionBarAdvisor 类. 这个类负责为Workbench
Window 的Action Bar ( 菜单, 工具条和状态栏等 ) 创建Action. 也可以通过插件清
单 plugin.xml 文件动态地提供action.
这个类中主要有下面几个方法:
方法 说明 参数
makeActions 创建在 fill 方法中使用的 action , 这个方
法用来通过 key binding 服务注册 action
并且添加到关闭窗口时要清除的 action
列表中.
IWorkbenchWindow
fillMenuBar 填充窗口的主菜单
IMenuManager
fillCoolBar 填充窗口的主工具栏
ICoolBarManager
fillStatusLine 填充窗口的主状态栏
IStatusLineManager
isApplicationMenu 这个方法在使用OLE对象做编辑的时候
使用,根据传入的菜单ID返回指定的菜
单是应用的菜单还是OLE对象的菜单.
在菜单合并期间, 应当保留应用的菜单,
至于其他的菜单最好可能从 Window 中
删除掉.
String
现在我们不需要对这个类进行任何修改.
以上列出来的三个 Advisor 类中的方法基本上都是不能够在客户端直接调用的, 而
是由 RCP 框架掉用的. 关于这一点在相应的 API 文档中有更为详细的说明.
插件工程向导自动为我们实现了Advisor 子类必须实现的各个方法, 根据实际需要
我们可以覆写 ( override ) 以上各表中方法来实现我们的意图. 关于这些方法的详
细资料请查询相应父类的API文档.
c) SimplebrowserPlugin 类
Plugin类继承了 AbstractUIPlugin 抽象类并且是一个单例 ( singleton ) 类.
这个类提供了对插件 Preferences , dialog store 和 image registry 的支持, 前面两个对
象提供了保存插件和对话框设置的有效途径, 后者为整个插件提供了可能在插件中
频繁使用的 Image 资源 . 由此可以看出, 这个类主要用来存储插件的全局信息. 由
于是单例类, 也是放置插件中其他类要用到的静态工具方法的好地方.
现在我们不需要对这个类进行任何修改.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 8 of 21
d) Perspective 类
这是RCP应用的默认的透视图. 实现了 IPerspectiveFactory 接口, 并且通过
org.eclipse.ui.perspectives 扩展点的className 属性指定.
透视图是一套可见的视图, 编辑器, 和菜单等. 在RCP应用中, 必须定义至少一个透
视图并且设置为默认的透视图.
所有启动RCP应用后希望用户看到的视图或编辑器都必须在这个类的
createInitialLayout 方法中设置.
e) Plugin.xml 文件
Plugin.xml文件是 Eclipse 的扩展点清单, 这个文件用来定义和使用 Eclipse 扩展点.
扩展点是关联 Eclipse 插件的基本方式. 例如, 这里的 Application 类就是通过
org.eclipse.core.runtime.application 扩展点定义的.
Eclipse 提供了插件清单编辑器, 使用这个编辑器可以方便的修改 plugin.xml 文件
的内容, 使用这个编辑器可以减少手工编辑这个 xml 文件的工作和错误. 在使用
插件向导创建完工程后你看到的就是这个编辑器.
f) build.properties 文件
在导出插件的时候这个文件指定了要build的内容和相关资源的路径. 如果你向应
用新增了一些资源, 如图标文件, 要记得把他们添加到 build.properties 文件的
bin.include 一节中.
在插件清单编辑器的 Build Configuration 页面可以很方便的在导出应用前对这个
文件进行配置.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 9 of 21
二、 添加视图
基本上Hello RCP模板创建的是一个空的RCP应用, 要实现我们自己的应用界面就需
要创建我们自己的视图 (View) 并且添加到当前的透视图中. 在这里我们使用了设计器.
1) 创建视图
在这里我们用设计器来创建一个RCP视图:
在Eclispe中打开RCP插件工程, 执行以下操作:
File à New à Other à Designer à RCP à ViewPart à Next
在这里, Name是指视图类的类名, 视图名称名称是显示在视图标题中的文字, 完成
输入后点击 Finish 按钮. Eclipse将会自动打开BrowserView视图类的源代码视图,
点击Design选项卡进入设计器视图.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 10 of 21
把 SWT Controls 中的 Browser 控件拖到右边的RCP视图中, 添加Browser控件.
在Property Edtor 中选中 container 在下面的 properites 页中选择 Layout 为
GridLayout(AWT), 让浏览器控件自动充满整个视图.
2) 添加视图到当前透视图中
没有添加到透视图中的视图是无法显示的.
打开Perspective类的源代码, 这个类是我们默认的透视图. 在它的createInitialLayout
方法中添加以下代码:
layout.addView( BrowserView.ID,
IPageLayout.TOP,
IPageLayout.RATIO_MAX,
IPageLayout.ID_EDITOR_AREA );
把视图添加到当前透视图中.
3) 添加视图的扩展点.
在刚才添加的代码中, layout 的AddView 方法是通过视图的ID ( BrowserView.ID )
来找到我们的视图的. 这个ID值存储在于插件清单的Extension 中, Eclipse 正是
通过这些扩展点来管理插件的.
在包资源管理器 ( Package Explorer ) 的树形视图中, 双击 plugin.xml 文件打开插件清
单编辑器, 点击 Extensions 选项卡打开扩展点清单管理页面:
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 11 of 21
点击 Add… 按钮打开扩展点选择视图,
在扩展点清单中选中 org.eclipse.ui.views 扩展点, 点击Finish按钮, 回到插件清单编
辑器, org.eclipse.ui.views 扩展点已经添加到清单中.
选中刚才添加的 org.eclipse.ui.views 单击鼠标右键, new à category 新建一个视图分
类, 视图分类是用来分类和组织视图的, 它有三个属性: id ,name 和parentCategory,
前两个属性用来唯一标识视图分类, 后一个属性用来组织分类的树型结构. 建议至少
为你的视图添加一个分类 ( Category ) . 这里采用系统默认值.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 12 of 21
以用样的方式, 选中刚才添加的 org.eclipse.ui.views 单击鼠标右键, new à view 添加
视图:
选中刚才添加的视图, 在右边编辑视图扩展点的属性:
在Id一栏填写视图类中的ID值 : simplebrowser.views.BrowserView .
( 注: 习惯上, 这个ID值和类的完整包路径是相同的. )
在Name一栏填写要显示在视图标题栏上的名称 : Simple Browser
在Class 一栏填写视图类(含包路径的完整类名) : simplebrowser.views.BrowserView
在icon 一栏可以指定显示在视图标题栏上的图标 (16X16象素) .
4) 运行RCP应用
在OverView页面点击 “Lanch an Eclipse application” 链接, 你就会看到我们的视图
已经显示出来了.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 13 of 21
5) 手工添加视图
如果你没有设计器, 也可以通过直接继承 org.eclipse.ui.part.ViewPart 抽象类来创建
视图类, 并且使用和上面相同的方法把视图添加到当前透视图中.
6) 使用添加扩展点向导添加视图
用上面的方式添加视图是因为设计器生成的代码比较简洁. 其实Eclipse提供了很好
的模板和向导来创建和添加视图.
双击Plugin.xml文件打开插件清单编辑器, 点击 Extensions 选项卡, 进入扩展点清单
页面:
点击Add… 按钮添加扩展点:
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 14 of 21
选择 org.eclispe.ui.views 扩展点和Sample View 模板, 点击Next按钮:
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 15 of 21
钩选 ” Add the view to the resource perspective ” 点击Finish按钮, Eclipse将自动创建
视图类并且添加相应的扩展点到插件清单中.
按照前面的方法在 Perspective 类的 createInitialLayout 方法中添加视图到透视图中,
启动RCP就会看到新建的视图了.
7) 一点润饰
在插件OverView页面点击 “Lanch an Eclipse application” 会发现透视图下方有一个
空的视图区域, 这是EditorArea, 在 Perspective 类的 createInitialLayout 方法中添加
layout.setEditorAreaVisible(false); 把它隐藏掉.
现在 Perspective 类的代码变成了这个样子:
public class Perspective implements IPerspectiveFactory {
public void createInitialLayout(IPageLayout layout) {
// 关掉Editor Area ,
// 如果没有用到Editor的话, 请执行这一句
// 否则在透视图中会有一片空白.
layout.setEditorAreaVisible(false);
// 添加Browser视图
layout.addView( BrowserView.ID,
IPageLayout.TOP,
IPageLayout.RATIO_MAX,
IPageLayout.ID_EDITOR_AREA );
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 16 of 21
// 添加SampleView视图
/*
layout.addView( "simplebrowser.views.SampleView",
IPageLayout.TOP,
IPageLayout.RATIO_MAX,
IPageLayout.ID_EDITOR_AREA );
*/
}
}
现在RCP打开的窗口的标题还是 ”Hello RCP” ,
在ApplicationWorkbenchWindowAdvisor 类的preWindowOpen() 方法中修改它,
并且覆写父类的postWindowCreate() 方法在应用启动后让窗口自动最大化:
代码如下:
/**
* 这个方法将在Workbench Window的构造函数中调用,
* 可用来在创建窗口前设置窗口的选项:
* 例如: 是否含有菜单栏, 状态栏等.
*/
public void preWindowOpen() {
IWorkbenchWindowConfigurer configurer = getWindowConfigurer();
configurer.setInitialSize(new Point(400, 300));
configurer.setShowCoolBar(false);
configurer.setShowStatusLine(false);
// 设置窗口标题栏文字
configurer.setTitle("Simple Browser");
}
/**
* 这个方法在窗口恢复到以前保存的状态(或者新建一个窗口)之后,
* 打开窗口之前(调用).
*/
public void postWindowCreate() {
super.postWindowCreate();
//设置打开时最大化窗口
getWindowConfigurer().getWindow().getShell().setMaximized(true);
}
现在运行RCP应用就顺眼多了. J
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 17 of 21
三、 发布应用
刚才建立的RCP应用现在还不能独立运行, 要发布一个独立的RCP应用, 你应当:
1) 新建product 文件,
File à New à Other à Product Configuration à Next à 输入文件名 à Finish
Eclispe 将会创建一个新的product configuration 文件并且自动打开product
configuration 编辑器.
在编辑器中进入OverView 页面:
在ProductID下拉列表中选择我们创建的RCP插件的ID;
在Appliction 下拉列表中选择我们创建的RCP应用的Application主程序
在Product Name一栏中输入Product 的名称.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 18 of 21
在编辑器中进入Configuration 页面:
点击Add… 按钮, 在弹出的列表中选中我们刚才创建的RCP插件: mybrowser, 点击
Ok 把我们的RCP插件添加到Product的插件列表中.
点击 Add Required Plug-ins 按钮把RCP应用所依赖的插件全部添加进来.
在编辑器中进入Branding 页面:
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 19 of 21
在Lancher Name 一栏中输入可执行程序的名称, 在Windows操作系统中这个名称
就是你的可执行的exe文件的名称.
在Window Images 一栏中选择RCP应用的图标. 16x16的图标是显示在应用的标题
栏上面的图标, 32x32的图标是在切换应用程序的时候显示的图标. 如果你没有指定
的话将自动放大16x16的图标来做显示. 建议两个都指定.
2) 导出RCP应用
在编辑器中进入 OverView 页面:
点击 “Eclipse Product export wizard” 链接打开Eclispe Product 导出向导.
在 Root directory 中指定RCP应用的根目录,
在 Export Destination 的 Directory 中指定要导出的位置.
点击 finish 完成导出.
转到你刚才指定的导出位置, 你会发现刚才指定的RCP应用的根目录. 进入这个目
录你就能看到在前面指定的可执行文件. 双击那个可执行的文件就 ”应该” 可以启动
这个RCP应用了…
但是在启动的时候会发现产生了”Class not find” 的异常, 提示找不到PlugIn类.
这是由于在导出的时候生成的Jar包中没有包含相应的class文件. 关于这个问题网
上有不少关于build.properties文件的讨论, 但是我发现下面的方法也许更加简单有
效 :
3) 导出JAR包
回到Eclispe, 进行以下操作:
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 20 of 21
File à Export… à JAR file à Next
打开JAR文件导出向导:
在JAR file 一栏输入要导出Jar文件的位置和文件名, 选中要导出的RCP工程, 打开
Src目录, 只选中plugin.xml 文件, 清除该目录下其他文件前面的选中状态, 因为这些
文件在RCP应用运行时是不需要的. 所以不用导出. 点击Next. 在下一个屏幕中保
留默认设置, 再点击Next, 进入JAR打包向导的最后一个界面.
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn
RCP 中文入门教程 Page 21 of 21
选中"Use existing manifest from workspace" 项, 点击 Browse.. 按钮, 在弹出的对话框
中, 选中RCP工程中 META-INF 目录下的 MANIFEST.MF 文件. 点击 OK 按钮回到
向导界面. 点击 Finish 按钮, Eclipse 将会编译工程并打包到刚才指定的Jar文件中.
转到导出的RCP应用的根目录, 打开 plugins 目录, 你会发现一个包含RCP应用名
称和版本好的JAR包, 如mybrowser_1.0.0.jar . 把刚才导出的JAR文件重名为这个
文件名. 复制到 plugins 目录中并且覆盖这个JAR包.
回到RCP应用的根目录, 双击那个可执行文件, 就会顺利的启动RCP应用了.
四、 参考资料
Rich Client Tutorial Part 1 (http://www.eclipse.org/articles/Article-RCP-1/tutorial1.html )
Rich Client Tutorial Part 2 (http://www.eclipse.org/articles/Article-RCP-2/tutorial2.html )
Rich Client Tutorial Part 3 (http://www.eclipse.org/articles/Article-RCP-3/tutorial3.html )
PDF 文件使用 "pdfFactory" 试用版本创建 www.fineprint.com.cn

本文地址：http://www.45fan.com/dnjc/71373.html