eclipse swt(标准部件工具包)提供了丰富的 api 集来实现定制部件(widget)。在这篇文章中,作者简要介绍了 mvc(模型-视图-控制器)架构,以结构化查看器的形式解释了 mvc 的当前实现,并介绍了一种使用定制 swt 部件的实现。
什么是 mvc?
mvc 架构(或设计模式)是图形用户界面(gui)的设计样式,由三部分构成:模型、视图和控制器。mvc 把表示层从数据解耦出来,也把表示从数据的操作解耦出来。
实现 mvc 架构与其他类型的应用程序有所不同。主要的区别来自如何放置和实现业务逻辑或查看呈现逻辑。与典型的 web 应用程序不同,在这类程序中,程序员必须设计和实现所有 mvc 组件,而 eclipse 提供的 api 可以替您做大部分控制或呈现工作。所以,不能严格地把 eclipse 的 mvc 实现与 web 或其他应用程序类型的 mvc 进行比较。
eclipse jface
eclipse jface 用内容提供者和标签提供者实现 mvc 架构。jface api 包装了标准(并非不重要的)部件,例如表和树,并实现了结构化内容提供者和标签提供者。可以根据部件类型实现不同的内容提供者。面向列表的查看器会实现结构化查看器,而内容则以结构化(列表的)方式映射到部件条目上。
基类叫做 viewer,它是结构化查看器的一个扩展。查看器充当部件容器。内容提供者以结构化的方式得到数据;类似地,标签提供者获得对应的标签。jface 查看器实现检索该数据,设置对应的关联,并用数据集更新用户界面(ui)组件。它还执行选择、过滤和排序。
如何实现 jface
eclipse view 和 viewer 负责执行大部分 jface 控制功能。viewer 或者说 mvc 的视图部分,也充当部件容器;这是表示组件。
eclipse view 实例化 viewer、内容提供者和标签提供者,并充当模型,容纳值对象,并在 viewer 中把它们设置为 inputelement。
要创建 view,请用 createpartcontrol() 方法实例化 viewer。清单 1 实例化一个默认的树查看器;您也可以定制树,并用树对象作为参数,用构造函数实例化树查看器。
清单 1. exampleview 的 createpartcontrol 方法
public class exampleview extends viewpart { ... public void createpartcontrol(composite parent) { // define a grid layout gridlayout layout = new gridlayout(); layout.numcolumns = 1; layout.marginheight = 0; layout.marginwidth = 0; l ayout.horizontalspacing = 0; layout.verticalspacing = 1; parent.setlayout(layout); // create widgets createactionbar(parent); createtree(parent); // add context menu and listeners viewer.adddoubleclicklistener(this); viewer.addselectionchangedlistener(openaction); // register viewer so actions respond to selection getsite().setselectionprovider(viewer); hookcontextmenu(); } private void createtree(composite parent) { viewer = new treeviewer(parent, swt.single | swt.h_scroll | swt.v_scroll | swt.border); viewer.setcontentprovider(new exampleviewcontentprovider()); viewer.setlabelprovider (new exampleviewlabelprovider()); viewer.setsorter(new viewersorter()); viewer.setinput(modelmanager.getexamplemodel()); viewer.getcontrol().setlayoutdata(new griddata(griddata.fill_both)); } ... } |
在另一个独立类中实现 contentprovider,它是一个对象,用适合查看器类型的接口向视图提供数据。例如,您可以实现 istructuredcontentprovider 或 itreecontentprovider 查看器。
请在 contentprovider 代码中实现以下一个方法,把 contentprovider 与 viewer 相关联:
- getelements(object parent)
- getchildren(object element)
注意:jface 框架将调用这些方法。
清单 2. 创建定制的 contentprovider
public class exampleviewcontentprovide implements itreecontentprovide { |
mvc 架构通常包含多个视图和一个数据源。目前在 eclipse 平台上,只能把一个视图与一个模型相关联。但是,也可以创建多个视图,用适配器视图访问同一数据。只要把 inputchanged() 方法包含在 contentprovider 类中即可。只要 viewer 有新的输入集,就会使用 inputchanged() 方法通知 contentprovider。inputchanged() 方法接受 viewer 作为输入参数,所以多个视图可以使用一个 contentprovider。
清单 3. 将 inputchanged 方法用于不同的查看器
/** * register content provider with model. */ public void inputchanged(viewer viewer, object oldinput, object newinput) { if (newinput != null) { this.viewer = viewer; this.model = (exampledelegate)newinput; this.model.addmodellistener(this); } } |
在多数常见 gui 应用程序中,创建布局来显示请求的数据,或完成表单(例如用户界面)来添加或修改数据。图 1 的示例应用程序演示了如何在定制表单中,用只读和可编写模式显示来自 xml 存储的数据。它还解释了每个组件相对于 mvc 架构的角色。
图 1. 示例应用程序

图 2 显示了应用程序的类图,有助于更好地理解整体架构。
图 2. 示例应用程序的类图

创建控件
exampleview 充当整个应用程序的容器。它将在 createpartcontrol 方法中初始化应用程序。
清单 4. createpartcontrol 方法初始化布局
public void createpartcontrol(composite parent) { exampleeditlayout _layout = new exampleeditlayout(parent,swt.none,fieldmode.read,new exampleviewcontentprovider()); } |
创建表单和布局
基本布局类定义了不同的表单应用程序使用的全局方法和声明。有些充当回调机制的容器事件,也注册到了这里。
清单 5. 布局的 createcontrol 方法
public void createcontrols(int style) { griddata griddata; text textfld, subjectfld; control tolabel, cclabel, bcclabel; control fromdatetime; control control; button durationtext; button submit; gridlayout layout = new gridlayout(2, false); layout.marginwidth = 0; layout.marginheight = 4; setlayout(layout); //label griddata = new griddata(griddata.horizontal_align_fill | griddata.vertical_align_center); griddata.horizontalindent = 10; labelfactory.create(this, messages.getstring("exampleeditlayout.title"), griddata); //$non-nls-1$ griddata = new griddata(griddata.horizontal_align_fill | griddata.vertical_align_center); griddata.horizontalindent = 40; labelfactory.create(this, "", griddata); //text griddata = new griddata(griddata.horizontal_align_fill | griddata.vertical_align_center); griddata.horizontalindent = 10; control = labelfactory.create(this, messages.getstring("exampleeditlayout.email"), griddata); //$non-nls-1$ griddata = new griddata(griddata.horizontal_align_beginning | griddata.vertical_align_center); griddata.horizontalindent = 10; control = textfactory.create(this, swt.border | swt.v_scroll | swt.wrap, griddata, fieldmode.edit); //$non-nls-1$ addfield(new textfield(control, exampleviewcontentprovider.first_index)); //combo griddata = new griddata(griddata.horizontal_align_fill | griddata.vertical_align_center); griddata.horizontalindent = 10; labelfactory.create(this, messages.getstring("exampleeditlayout.group"), griddata); //$non-nls-1$ griddata = new griddata(griddata.horizontal_align_beginning | griddata.vertical_align_center); griddata.horizontalindent = 40; control = combofactory.create(this, fieldmode.edit, false, griddata); //$non-nls-1$ addfield(new combofield(control, exampleviewcontentprovider.second_index)); ...} |
field 是一个抽象类,它定义了包含各种用户界面控件的方法,还有全局地识别这些控件的相关 id。每个用户界面控件都是 field 的子类,并向内容提供者提供了读写能力。清单 6 用工厂模式,在 layout 类中创建了 field。
清单 6. 用 field 类创建文本对象
public class textfield extends field { /** * @param control * @param id */ public textfield(control control, int id) { super(control, id); } /* based on the id of the widget, values retrieved from * the content provider are set. */ public void readfromcontent(iexamplecontentprovider content) { string newtext = (string )content.getelement(getid()); if (newtext != null) ((text )_control).settext(newtext); } /* based on the id of the widget, values retrieved from widget are * sent back to the content provider. */ public void writetocontent(iexamplecontentprovider content) { string newtext = ((text )_control).gettext(); content.setelement(getid(), newtext); } } |
简化内容提供者(模型)
exampleviewcontentprovider 充当模型侦听器,后者扩展自 istructuredcontentprovider。它是 eclipse api 的简单实现,提供了用于检索数据的回调。每个请求数据的条目都基于视图创建时在布局中为条目定义的惟一 id。
方法调用会返回与每个定义的全局 id 关联的数据。在 清单 7 所示的内容提供者中,可以使用适配器从 xml 文件或数据库检索数据。
清单 7. 在定制的 contentprovider 中实现方法
public object getelement(int iindex) { switch (iindex) { case first_index: return "developer@ibm.com"; case second_index : return new integer(1); case fourth_index : return new boolean(true); case third_index: return new boolean(false); case fifth_index: return new boolean(false); } return null; } |
创建了控件并初始化布局之后,表单会用控件 id 要求内容提供者用数据填充表单控件。
清单 8. 初始化布局并填充控件的表单
public form (composite parent, int style, fieldmode mode, exampleviewcontentprovider content) { super(parent, style); _content = content; _style = style; setmode(mode); init(style); } private void init(int style) { createcontrols(style); controlscreated(); } protected void controlscreated() { readfromcontent(); } |
结束语
web 应用程序是 mvc 架构样式的早期实现者。但是,随着像 eclipse 这样的简单而强大的开发平台的到来,程序员可以轻易地用更短的时间和最小的复杂程度,开发出更丰富的用户界面。
闽公网安备 35060202000074号