RCP中文入门教程.docVIP

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按钮。 修改Plug-in ID 及其他插件属性值。 这里采用默认值, 在 “Rich Client Application” 一栏中, “Would you like to create a rich client application ?” 一项选择 “Yes” 设置创建的插件为RCP应用。 点击Next。 在模板中选择最基本的Hello RCP 模板, 点击 “Finish” 按钮, Eclispe将会创建一个简单的RCP应用并且自动打开插件清单编辑器的主页面。 在这里你可以方便的配置你的RCP应用, 免去手工编写和修改配置文件的麻烦。 在插件清单编辑器的OverView 页, 点击 “Launch an Eclipse application” 链接就会看到你的RCP应用运行时的样子。 2) 工程创建完成后, Eclipse将自动生成以下内容: ((Application类 ((ApplicationActionBarAdvisor 类 ((ApplicationWorkbenchAdvisor 类 ((ApplicationWorkbenchWindowAdvisor类 ((SimplebrowserPlugin 类 ((Perspective 类 ((plugin.xml 文件 ((perties 文件 ? a) Application类 Application类是RCP应用的主程序, 相当于整个RCP应用的控制器。 Application类的职责是创建一个工作台(Workbench)然后添加一个工作台顾问类(WorkbenchAdvisior)。 它是启动RCP应用运行的第一个程序。 这个类实现了 Eclipse 的 IPlatformRunnable 接口。 对于绝大多数的RCP应用, 这个类的代码都是不用修改的。 工作台(Workbench)是RCP框架的一部分, 一个RCP应用只能有一个工作台, 但是可以有多个工作台窗口(WorkbenchAdvisior)。 工作台的结构如下: 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 在初始化完成之后, 打开第一