技术开发 频道

在定制 SWT 组件中实现 MVC

    【IT168 技术文章】

        什么是 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 方法

1 public class ExampleView extends ViewPart
2 { ... public void createPartControl(Composite parent)
3 { // define a grid layout
4 GridLayout layout = new GridLayout();
5 layout.numColumns = 1;
6 layout.marginHeight = 0;
7 layout.marginWidth = 0; l
8 ayout.horizontalSpacing = 0;
9 layout.verticalSpacing = 1;
10 parent.setLayout(layout);
11 // create widgets createActionBar(parent);
12 createTree(parent);
13 // add context menu and listeners
14 viewer.addDoubleClickListener(this); viewer.addSelectionChangedListener(openAction);
15 // register viewer so actions respond to selection getSite().setSelectionProvider(viewer);
16 hookContextMenu();
17 }
18 private void createTree(Composite parent)
19 {
20 viewer = new TreeViewer(parent, SWT.SINGLE | SWT.H_SCROLL | SWT.V_SCROLL | SWT.BORDER);
21 viewer.setContentProvider(new ExampleViewContentProvider()); viewer.setLabelProvider
22 (new ExampleViewLabelProvider());
23 viewer.setSorter(new ViewerSorter());
24 viewer.setInput(ModelManager.getExampleModel());
25 viewer.getControl().setLayoutData(new GridData(GridData.FILL_BOTH));
26 } ... }
27

  在另一个独立类中实现 ContentProvider,它是一个对象,用适合查看器类型的接口向视图提供数据。例如,您可以实现 IStructuredContentProvider 或 ITreeContentProvider 查看器。

  请在 ContentProvider 代码中实现以下一个方法,把 ContentProvider 与 Viewer 相关联:

  getElements(Object parent)

  getChildren(Object element)

  注意:JFace 框架将调用这些方法。

  清单 2. 创建定制的 ContentProvider

1 public class ExampleViewContentprovide implements ITreeContentProvide {
2

  MVC 架构通常包含多个视图和一个数据源。目前在 Eclipse 平台上,只能把一个视图与一个模型相关联。但是,也可以创建多个视图,用适配器视图访问同一数据。只要把 inputChanged() 方法包含在 ContentProvider 类中即可。只要 Viewer 有新的输入集,就会使用 inputChanged() 方法通知 ContentProvider。inputChanged() 方法接受 Viewer 作为输入参数,所以多个视图可以使用一个 ContentProvider。

  清单 3. 将 inputChanged 方法用于不同的查看器

1 /** * Register content provider with model. */
2 public void inputChanged(Viewer viewer, Object oldInput, Object newInput)
3 {
4 if (newInput != null)
5           {
6 this.viewer = viewer;
7 this.model = (ExampleDelegate)newInput; this.model.addModelListener(this);
8 }
9 }
10

  在多数常见 GUI 应用程序中,创建布局来显示请求的数据,或完成表单(例如用户界面)来添加或修改数据。图 1 的示例应用程序演示了如何在定制表单中,用只读和可编写模式显示来自 XML 存储的数据。它还解释了每个组件相对于 MVC 架构的角色。

  图 1. 示例应用程序

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

  图 2. 示例应用程序的类图

  创建控件

  ExampleView 充当整个应用程序的容器。它将在 createPartControl 方法中初始化应用程序。

  清单 4. CreatePartControl 方法初始化布局

1 public void createPartControl(Composite parent) {
2 ExampleEditLayout _layout = new
3     ExampleEditLayout(parent,SWT.NONE,FieldMode.Read,new ExampleViewContentProvider());
4         }
5

  创建表单和布局

  基本布局类定义了不同的表单应用程序使用的全局方法和声明。有些充当回调机制的容器事件,也注册到了这里。

  清单 5. 布局的 CreateControl 方法

1 public void createControls(int style) {
2 GridData    gridData;
3 Text                textFld, subjectFld;
4 Control            toLabel, ccLabel, bccLabel;
5 Control            fromDateTime;
6 Control            control;
7 Button durationText;
8 Button submit;
9 GridLayout layout = new GridLayout(2, false);
10 layout.marginWidth = 0;
11 layout.marginHeight = 4;
12 setLayout(layout);
13 //Label
14 gridData = new GridData(GridData.HORIZONTAL_ALIGN_FILL
15 | GridData.VERTICAL_ALIGN_CENTER);
16 gridData.horizontalIndent = 10;
17 LabelFactory.create(this,
18   Messages.getString("ExampleEditLayout.Title"), gridData); //$NON-NLS-1$
19 gridData = new GridData(GridData.HORIZONTAL_ALIGN_FILL
20 | GridData.VERTICAL_ALIGN_CENTER);
21 gridData.horizontalIndent = 40;
22 LabelFactory.create(this, "", gridData);
23 //Text
24 gridData = new GridData(GridData.HORIZONTAL_ALIGN_FILL
25 | GridData.VERTICAL_ALIGN_CENTER);
26 gridData.horizontalIndent = 10;
27 control = LabelFactory.create(this,
28   Messages.getString("ExampleEditLayout.Email"), gridData); //$NON-NLS-1$
29 gridData = new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING
30 | GridData.VERTICAL_ALIGN_CENTER);
31 gridData.horizontalIndent = 10;
32 control = TextFactory.create(this,
33   SWT.BORDER | SWT.V_SCROLL | SWT.WRAP, gridData, FieldMode.Edit); //$NON-NLS-1$
34 addField(new TextField(control, ExampleViewContentProvider.FIRST_INDEX));
35 //Combo
36 gridData = new GridData(GridData.HORIZONTAL_ALIGN_FILL
37 | GridData.VERTICAL_ALIGN_CENTER);
38 gridData.horizontalIndent = 10;
39 LabelFactory.create(this,
40   Messages.getString("ExampleEditLayout.Group"), gridData); //$NON-NLS-1$
41 gridData = new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING
42 | GridData.VERTICAL_ALIGN_CENTER);
43 gridData.horizontalIndent = 40;
44 control = ComboFactory.create(this,
45   FieldMode.Edit, false, gridData); //$NON-NLS-1$
46 addField(new ComboField(control,
47 ExampleViewContentProvider.SECOND_INDEX));
48 ...}
49

  创建字段(视图)

  Field 是一个抽象类,它定义了包含各种用户界面控件的方法,还有全局地识别这些控件的相关 ID。每个用户界面控件都是 Field 的子类,并向内容提供者提供了读写能力。清单 6 用工厂模式,在 Layout 类中创建了 Field。

  清单 6. 用 Field 类创建文本对象

1 public class TextField extends Field {
2     /**
3           * @param control
4           * @param id
5           */
6     public TextField(Control control, int id) {
7         super(control, id);
8     }
9     /* Based on the ID of the widget, values retrieved from
10      * the content provider are set.
11      */
12     public  void readFromContent(IExampleContentProvider content) {
13         String newText = (String )content.getElement(getId());
14         if (newText != null)
15             ((Text )_control).setText(newText);
16     }
17     /* Based on the ID of the widget, values retrieved from widget are
18      * sent back to the content provider.
19      */
20     public void writeToContent(IExampleContentProvider content) {
21         String newText = ((Text )_control).getText();
22         content.setElement(getId(), newText);
23     }
24 }

  ExampleViewContentProvider 充当模型侦听器,后者扩展自 IStructuredContentProvider。它是 Eclipse API 的简单实现,提供了用于检索数据的回调。每个请求数据的条目都基于视图创建时在布局中为条目定义的惟一 ID。

  方法调用会返回与每个定义的全局 ID 关联的数据。在 清单 7 所示的内容提供者中,可以使用适配器从 XML 文件或数据库检索数据。

  清单 7. 在定制的 ContentProvider 中实现方法

1 public Object getElement(int iIndex) {
2         switch (iIndex) {
3         case FIRST_INDEX: return "developer@ibm.com";
4         case SECOND_INDEX : return new Integer(1);
5         case FOURTH_INDEX : return new Boolean(true);
6         case THIRD_INDEX: return new Boolean(false);
7         case FIFTH_INDEX: return new Boolean(false);
8         }
9         return null;
10     }
11

  创建了控件并初始化布局之后,表单会用控件 ID 要求内容提供者用数据填充表单控件。

  清单 8. 初始化布局并填充控件的表单

1 public Form (Composite parent, int style, FieldMode mode, ExampleViewContentProvider content) {
2             super(parent, style);
3             _content = content;
4             _style = style;
5             setMode(mode);
6             init(style);
7     }
8     
9     private void init(int style) {
10             createControls(style);
11         controlsCreated();
12     }
13 protected void controlsCreated() {
14             readFromContent();
15     }
16

  结束语

  Web 应用程序是 MVC 架构样式的早期实现者。但是,随着像 Eclipse 这样的简单而强大的开发平台的到来,程序员可以轻易地用更短的时间和最小的复杂程度,开发出更丰富的用户界面。

  代码下载

0
相关文章