分享
 
 
 

Eclipse插件开发之定制向导

王朝other·作者佚名  2006-11-24
窄屏简体版  字體: |||超大  

以前我有一个微型的便携式电子地址薄。我一直认为它很不错,直到有一天它停止运行了。销售该产品的人员无法找回我的联系地址名册,却提议更换一台。这时候我才知道数据的重要性。这个闪亮的小发明与存储在它里面的数据相比根本就不值一提。

在这个序列文章的第一部分中,我介绍了Eclipse插件的开发环境,并开发了一个简单的插件(见天极网《Eclipse插件开发快速入门》)。在第二部分,我添加了工具条按钮、菜单项和对话框(见天极网《Eclipse插件开发之添加简单的GUI元素》)。它实际上没有实现任何具体功能。它简单地用某种字体显示了示例文本内容。现在我们要让它能够治理实际的数据。我们将修改这个插件,让它实现我们所需要的功能。本文讨论的是编辑器文档,并演示了如何定制一个向导。

Invokatron的历史

首先,我们具体说明一下Invokatron本身。在前面的文章中我们讨论过,Invokatron是一个生成java代码的的图形工具。你可以简单地通过拖放操作建立类的方法。拖入的方法被编辑的方法(也就是插件)"调用"。我们将让数据来驱动应用程序的设计。在后面一篇文章中,我们将开发这个GUI。现在我们需要做的是,找到插件将输入和存储的重要数据。它通常被称为应用程序的模型(model)。在设计这个系统的时候,我们需要考虑下面一些内容:

· 哪些细节数据需要保存?

· 这些数据在内存中用什么来表现?POJO、JavaBean还是EJB?

· 这些数据的存储格式是怎样的?数据库表、xml文件、属性文件还是串行二进制文件?

· 输入数据的方式有哪几种?用"新建文件"向导还是在文档属性页面上使用弹出对话框、用编辑器绘制、在文本编辑器中输入的其它向导?

在我们继续工作之前必须回答这些问题。不可能有适合所有项目的答案;它完全依靠于你的需求。在我们的例子中,我做出了一些随意的、可能有问题的决定,如下所示:

· 一个Java类,它包含类名、程序包、超类(superclass)和实现接口。我们以它为基础,在后面的文章中添加更多数据。

· 我将把数据表现为扩展PRoperties类的类。它建立了编辑器的"文档类"。

· 我将使用的格式是属性文件,很轻易使用Properties类来分析它。

· 在"新建文件"向导中,我将先寻找数据,接着让用户改变属性窗口或文本编辑器中的数据。这个步骤将在下一篇文章中完成。

Document(文档)类

下一步是编写文档类。建立一个新程序包(invokatron.model)和一个新类(InvokatronDocument)。下面是我们的文档类的开头:

public class InvokatronDocument

extends Properties

{

public static final String PACKAGE = "package";

public static final String SUPERCLASS = "superclass";

public static final String INTERFACES = "interfaces";

}

使用Properties类可以更简单地分析和保存我们的数据。Getter和 setter不是必须的,但是假如你想要,也可以加上它们。这个类还没有完成;我们将添加一个接口,在后面的部分中Eclipse需要使用它。

有了这个类之后,我们要获取一个属性就非常简单了:

String package =document.getProperty(InvokatronDocument.PACKAGE);

定制向导

请看一看前面的文章中所出现的向导。你应该记得,我们可以通过点击(我们自己添加的)工具条按钮或者菜单项来访问它。图1是它的界面:

图1:旧的向导

它只有一个页面,右上角没有图片。我们想输入更多的信息,并提供一个很好的图片。换句话说,我们希望定制这个向导。

我们来分析一下这个向导。请打开InvokatronWizard.java文件。请注重这个类是如何扩展Wizard并实现INewWizard接口的。你应该理解它里面的很多方法。为了定制向导,我们简单地调用或重载其中的某些方法。下面是一些重要的方法:

生命周期方法

我们应该重载这些方法,把初始化和析构(destrUCtion)代码插入向导中:

· Constructor(构造函数):向导实例化的时候、在Eclipse给它传递信息之前调用。向导的一般初始化实现。通常你希望调用"美化方法"(后面有描述)并设置对话框的默认值。

· init(IWorkbench workbench, IStructuredSelection editorSelection): Eclipse调用它为向导提供工作台的信息。请重载它,保存IWorkbench和对象的句柄供以后使用。假如它是一个编辑器向导而不是新向导,我们最好把当前的编辑器选项作为第二个参数。

· dispose():Eclipse调用它执行清理工作。重载它来清除向导使用的资源。

· finalize():清除代码,可能使用dispose()代替。

美化方法

这些方法都是用于装饰向导窗体的。

· setWindowTitle(String title):设置窗体的标题行字符串。

· setDefaultPageImageDescriptor(ImageDescriptor image):用于提供显示在向导的所有页面右上方的图片。

· setTitleBarColor(RGB color):指定标题栏用什么颜色。

按钮方法

这些方法控制着向导按钮的实用性和行为。

· boolean canFinish():重载它用于指定Finish(完成)按钮是否激活(根据向导的状态)。

· boolean performFinish():重载它来实现向导的根本的业务逻辑。假如向导没有完成(错误的条件),就返回false。

· boolean performCancel():重载它,在用户点击Cancel(取消)按钮的时候进行清除操作。假如向导不能终止,则返回false。

· boolean isHelpAvailable():重载它用于指定Help(帮助)按钮是否可视。

· boolean needsPreviousAndNextButtons():重载它来指定Previous(前一步)和Next(后一步)按钮是否可视。

· boolean needsProgressMonitor():重载它来指定进度条部件是否可视。当点击Finish按钮调用performFinish()方法的时候,它就会出现。

页面方法

这些方法控制着页面的外观。

· addPages():向导显示的时候调用。重载它给向导插入新页面。

· createPageControls(Composite pageContainer):Eclipse调用它来实例化所有的向导页面(用前面的addPages()方法已经添加的页面)。重载它给向导添加持续可视的窗体小部件(除页面之外的部件)。

· IWizardPage getStartingPage():重载它来检测哪个页面是向导的第一个页面。

· IWizardPage getNextPage(IWizardPage nextPage):在默认情况下,点击Next按钮将进入addPages()所提供的数组中的下一个页面。你可能希望根据用户选择进入不同的页面。重载它来计算后一个页面。

· IWizardPage getPreviousPage(IWizardPage previousPage):与getNextPage()类似,用于计算前一个页面。

· int getPageCount():检索addPages()添加的页面的数量。在典型情况下,你不必重载它,除非你希望显示页面的数量和形式。

其它有用的方法

这些都是有用的辅助方法:

· setDialogSettings(IDialogSettings settings):你可以载入对话框的状态,并通过在init()中调用这个方法来设置这些值。在典型情况下,这些设置可以作为向导字段的默认值。请查看DialogSettings类了解更具体的信息。

· IDialogSettings getDialogSettings():当我们需要数据的时候,就调用这个方法来检索它。在performFinish()的对话框的末尾,你再次可以把数据保存到文件中。

· IWizardContainer getContainer():对于检索Shell、运行的后台线程、刷新窗口等非常有用。 向导页面方法

你已经看到了,向导是由一个或多个页面组成的。这些页面扩展了WizardPage类,并实现了IWizardPage接口。为了定制单独的页面,你必须了解很多方法。下面是一些重要的方法:

· Constructor:用于实例化页面。

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有