`
LuChar
  • 浏览: 74808 次
  • 性别: Icon_minigender_1
  • 来自: 成都
社区版块
存档分类
最新评论

GEF原理及实现系列(四、控制器)

    博客分类:
  • GEF
阅读更多
控制器是GEF框架的核心,它负责模型和视图之间的通信。
1.控制器的功能
在GEF的MVC结构里,控制器是模型与视图之间的桥梁,也是整个GEF的核心,它不仅要监听模型的变化,当用户编辑视图时,还要把编辑结果反应到模型上。
在GEF中,控制器是由一组EditPart对象共同组成的,每一个模型对象都对应一个EditPart对象。应用程序中需要有一个EditPartFactory对象负责根据给定模型对象创建对应的EditPart对象,这个工厂类将在创建模型时被调用。
控制器是GEF中最复杂的一部分,GEF把控制器完成的工作又分成了几个部分,包括请求和编辑策略及引申出来的命令模式,如下图:

用户的编辑操作被转换为一系列请求(Request),Eclipse中有很多种类的请求,这些种类在GEF里被成为角色(Role)。在GEF里有图形 化和非图形化这两大类角色,前者如“LayoutRole”对应和布局有关的操作,后者如“ConnectionRole”对应和连接有关的操作等。角色 这个概念是通过编辑策略(EditPolicy)来实现的,EditPolicy的主要功能是根据请求创建相应的命令(Command),而后者会直接操 作模型对象。
对每一个EditPart,用户都可以“安装”一些EditPolicy。用户对这个EditPart的特定操作会被交给已安装的对应EditPolicy处理。这样做的直接好处是可以在不同EditPart之间共享一些重复操作。
2.控制器的实现
        每一个模型都会对应一个控制器,控制器主要负责模型和视图的同步。控制器要监听模型的属性改变的事件,并通知视图更新。另外,控制器还要设置相应的编辑策略,用来处理由视图接收的请求。
实现一个EditPart一般来说需要重载performRequest、getCommand、 activate、deactivate和refreshVisuals函数,并实现createEditPolicies、createFigure接 口函数,为了让EditPart能够成为PropertyChangeListener,你还必须实现PropertyChangeListener接 口。performRequest和getCommand将在第3节介绍,activate和deactivate用于处理当EditPart处于激活或 者非激活状态时的操作,一般来说,可以在这两个函数中注册和移除自己监听者的角色。refreshVisuals函数用于更新自己的视图。
java 代码
  1. package com.example.parts;
  2. import java.beans.PropertyChangeEvent;
  3. import java.beans.PropertyChangeListener;
  4. import java.util.List;
  5. import org.eclipse.draw2d.ChopboxAnchor;
  6. import org.eclipse.draw2d.ConnectionAnchor;
  7. import org.eclipse.draw2d.IFigure;
  8. import org.eclipse.draw2d.geometry.Dimension;
  9. import org.eclipse.draw2d.geometry.Point;
  10. import org.eclipse.draw2d.geometry.Rectangle;
  11. import org.eclipse.gef.ConnectionEditPart;
  12. import org.eclipse.gef.EditPolicy;
  13. import org.eclipse.gef.GraphicalEditPart;
  14. import org.eclipse.gef.NodeEditPart;
  15. import org.eclipse.gef.Request;
  16. import org.eclipse.gef.RequestConstants;
  17. import org.eclipse.gef.editparts.AbstractGraphicalEditPart;
  18. import org.eclipse.gef.tools.DirectEditManager;
  19. import org.eclipse.jface.viewers.TextCellEditor;
  20. import com.example.figures.NodeFigure;
  21. import com.example.model.Node;
  22. import com.example.policies.NodeDirectEditPolicy;
  23. import com.example.policies.NodeEditPolicy;
  24. import com.example.policies.NodeGraphicalNodeEditPolicy;
  25. public class NodePart extends AbstractGraphicalEditPart implements PropertyChangeListener, NodeEditPart {
  26. protected DirectEditManager manager;
  27. //处理请求
  28. public void performRequest(Request req) {
  29. if (req.getType().equals(RequestConstants.REQ_DIRECT_EDIT)) {
  30. if (manager == null) {
  31. NodeFigure figure = (NodeFigure) getFigure();
  32. manager = new NodeDirectEditManager(this, TextCellEditor.class, new NodeCellEditorLocator(figure));
  33. }
  34. manager.show();
  35. }
  36. }
  37. //监听模型属性改变
  38. public void propertyChange(PropertyChangeEvent evt) {
  39. if (evt.getPropertyName().equals(Node.PROP_LOCATION))
  40. //更新视图
  41. refreshVisuals();
  42. else if (evt.getPropertyName().equals(Node.PROP_NAME))
  43. refreshVisuals();
  44. else if (evt.getPropertyName().equals(Node.PROP_INPUTS))
  45. //更新连接
  46. refreshTargetConnections();
  47. else if (evt.getPropertyName().equals(Node.PROP_OUTPUTS))
  48. refreshSourceConnections();
  49. }
  50. //创建模型对应的视图
  51. protected IFigure createFigure() {
  52. return new NodeFigure();
  53. }
  54. //设置编辑策略
  55. protected void createEditPolicies() {
  56. installEditPolicy(EditPolicy.DIRECT_EDIT_ROLE, new NodeDirectEditPolicy());
  57. installEditPolicy(EditPolicy.COMPONENT_ROLE, new NodeEditPolicy());
  58. installEditPolicy(EditPolicy.GRAPHICAL_NODE_ROLE, new NodeGraphicalNodeEditPolicy());
  59. }
  60. //注册自己成为模型的监听器
  61. public void activate() {
  62. if (isActive()) {
  63. return;
  64. }
  65. super.activate();
  66. ((Node) getModel()).addPropertyChangeListener(this);
  67. }
  68. //把自己从模型的监听器中删除
  69. public void deactivate() {
  70. if (!isActive()) {
  71. return;
  72. }
  73. super.deactivate();
  74. ((Node) getModel()).removePropertyChangeListener(this);
  75. }
  76. //更新视图的显示
  77. protected void refreshVisuals() {
  78. Node node = (Node) getModel();
  79. Point loc = node.getLocation();
  80. Dimension size = new Dimension(150, 40);
  81. Rectangle rectangle = new Rectangle(loc, size);
  82. ((NodeFigure) this.getFigure()).setName(((Node) this.getModel()).getName());
  83. ((GraphicalEditPart) getParent()).setLayoutConstraint(this, getFigure(), rectangle);
  84. }
  85. //------------------------------------------------------------------------
  86. // Abstract methods from NodeEditPart
  87. //得到源连接的连接点
  88. public ConnectionAnchor getSourceConnectionAnchor(ConnectionEditPart connection) {
  89. return new ChopboxAnchor(getFigure());
  90. }
  91. public ConnectionAnchor getSourceConnectionAnchor(Request request) {
  92. return new ChopboxAnchor(getFigure());
  93. }
  94. //得到目标连接的连接点
  95. public ConnectionAnchor getTargetConnectionAnchor(ConnectionEditPart connection) {
  96. return new ChopboxAnchor(getFigure());
  97. }
  98. public ConnectionAnchor getTargetConnectionAnchor(Request request) {
  99. return new ChopboxAnchor(getFigure());
  100. }
  101. //得到以模型作为源的连接列表
  102. protected List getModelSourceConnections() {
  103. return ((Node) this.getModel()).getOutgoingConnections();
  104. }
  105. //得到以模型作为目标的连接列表
  106. protected List getModelTargetConnections() {
  107. return ((Node) this.getModel()).getIncomingConnections();
  108. }
  109. }
EditPart(确切的说是AbstractGraphicalEditpart)另外一个需要实现的重要方法是createFigure(), 这个方法应该返回模型在视图中的图形表示,是一个IFigure类型对象。一般都把这些图形放在figures包里,例子里只有NodeFigure一个 自定义图形,Diagram对象对应的是GEF自带的名为FreeformLayer的图形,它是一个可以在东南西北四个方向任意扩展的层图形;而 Connection对应的也是GEF自带的图形,名为PolylineConnection,这个图形缺省是一条用来连接另外两个图形的直线,在例子里 我们通过setTargetDecoration()方法让连接的目标端显示一个箭头。

最后,要为EditPart增加适当的EditPolicy,这是通过覆盖EditPart的createEditPolicies()方法来实现 的,每一个被"安装"到EditPart中的EditPolicy都对应一个用来表示角色(Role)的字符串。对于在模型中有子元素的 EditPart,一般都会安装一个EditPolicy.LAYOUT_ROLE角色的EditPolicy(见下面的代码),后者多为 LayoutEditPolicy的子类;对于连接类型的EditPart,一般要安装 EditPolicy.CONNECTION_ENDPOINTS_ROLE角色的EditPolicy,后者则多为 ConnectionEndpointEditPolicy或其子类,等等。

installEditPolicy(EditPolicy.LAYOUT_ROLE, new DiagramLayoutEditPolicy());

用户的操作会被当前工具(缺省为选择工具SelectionTool)转换为请求(Request),请求根据类型被分发到目标EditPart所安装的EditPolicy,后者根据请求对应的角色来判断是否应该创建命令并执行。

    在GEF里,这个弹出的编辑器由DirectEditManager类负责管理,在我们的NodePart类里,通过覆盖 performRequest()方法响应用户的DirectEdit请求,在这个方法里一般要构造一个DirectEditManager类的实例(例 子中的NodeDirectEditManager),并传入必要的参数,包括接受请求的EditPart(就是自己,this)、编辑器类型(使用 TextCellEditor)以及用来定位编辑器的CellEditorLocator(NodeCellEditorLocator),然后用 show()方法使编辑器显示出来,而编辑器中显示的内容已经在构造方法里得到。简单看一下NodeCellEditorLocator类,它的关键方法 在relocate()里,当编辑器里的内容改变时,这个方法被调用从而让编辑器始终处于正确的坐标位置。DirectEditManager有一个重要 的initCellEditor()方法,它的主要作用是设置编辑器的初始值。在我们的例子里,初始值设置为被编辑NodePart对应模型 (Node)的name属性值;这里还另外完成了设置编辑器字体和选中全部文字(selectAll)的功能,因为这样更符合一般使用习惯。

        在NodePart里还要增加一个角色为DIRECT_EDIT_ROLE的EditPolicy,它应该继承自 DirectEditPolicy,有两个方法需要实现:getDirectEditCommand()和showCurrentEditValue (),虽然还未遇到过,但前者的作用你不应该感到陌生--在编辑结束时生成一个Command对象将修改结果作用到模型;后者的目的是更新Figure中 的显示,虽然我们的编辑器覆盖了Figure中的文本,似乎并不需要管Figure的显示,但在编辑中时刻保持这两个文本的一致才不会出现"盖不住"的情 况,例如当编辑器里的文本较短时。

        上例通过继承AbstractGraphicalEditPart类实现了一个EditPart,另外,当GEF框架创建一个模型时,都会为此模型创建一 个对应的控制器。创建控制器的操作是在控制器工厂中完成的,用户可以在编辑器初始化时指定控制器工厂,例如:“getGraphicalViewer ().setEditPartFactory(new PartFactory())”,其中PartFactory为控制器工厂,代码如下:
java 代码
  1. /*
  2. * Created on 2005-1-24
  3. *
  4. * TODO To change the template for this generated file go to
  5. * Window - Preferences - Java - Code Style - Code Templates
  6. */
  7. package com.example.parts;
  8. import org.eclipse.gef.EditPart;
  9. import org.eclipse.gef.EditPartFactory;
  10. import com.example.model.Connection;
  11. import com.example.model.Diagram;
  12. public class PartFactory implements EditPartFactory {
  13. public EditPart createEditPart(EditPart context, Object model) {
  14. EditPart part = null;
  15. //根据模型创建相应的EditPart
  16. if (model instanceof Diagram)
  17. part = new DiagramPart();
  18. else if (model instanceof Connection)
  19. part = new ConnectionPart();
  20. else
  21. part = new NodePart();
  22. //设置EditPart对应的模型
  23. part.setModel(model);
  24. //返回根据模型创建的EditPart
  25. return part;
  26. }
  27. }

通过创建控制器和控制器工厂,GEF编辑器将会知道在模型创建后,自动调用控制器工厂创建对应的空气,从而实现模型和控制器的一一对应关系。
分享到:
评论

相关推荐

    GEF入门系列 pdf 格式资料

    - **模型-视图-控制器(MVC)**:GEF基于MVC设计模式,将图形元素的逻辑(模型)、显示(视图)和交互(控制器)分离,实现了高度可定制化和可扩展性。 - **Part和EditPart**:Part代表工作台上的一个独立组件,...

    GEF Description

    GEF 通过引入“模型-视图-控制器”(Model-View-Controller,MVC)架构模式,将数据模型、视图和控制器分开处理,便于维护和扩展。在这个架构中,数据模型表示应用程序的数据结构,视图负责显示这些数据,而控制器则...

    GEF-ALL-3.7+GEF-ALL-3.8+GEF_Draw2d学习资料

    GEF提供了模型-视图-控制器(MVC)架构,使得开发者能够轻松地创建和操作图形元素。它的核心功能包括图形对象的创建、拖放操作、连接线的管理、以及各种图形编辑行为的实现。GEF-3.7和GEF-3.8是其不同版本,可能包含...

    GEF及GMF入门学习

    - `gef.tutorial.step.parts`: 存放控制器相关的类(如EditParts)。 - `gef.tutorial.step.ui`: 存放视图相关的类, 如Editor中的图形显示。 5. **Editor实现**: - `gef.tutorial.step.ui`包中的Editor继承自`org....

    界面设计GEF应用实例

    1. **模型-视图-控制器(MVC)**:GEF基于MVC设计模式,模型存储图形数据,视图负责显示,控制器处理用户交互。 2. **编辑领域(EditPart)**:编辑领域是GEF中的核心组件,它将模型与视图关联起来,处理用户交互和...

    GEF.rarGEF.rar

    2. **MVC模式**:在GEF中,模型负责存储数据,视图负责显示模型的内容,控制器处理用户的输入并更新模型。这种分离使代码更易于维护和扩展。 3. **图元(Figure)和图元工厂(FigureFactory)**:GEF中的图元是图形...

    基于gef框架Demo

    在Gef框架中,核心概念包括Model(模型)、View(视图)和Controller(控制器)。Model是应用程序的数据结构,存储了需要在图形界面中表示的信息。View是数据的可视化表示,根据Model的变化实时更新。Controller则是...

    GEF初学者开发样例

    GEF是基于Java语言开发的,它遵循MVC(模型-视图-控制器)设计模式,为图形编辑器的开发提供了强大的支持。通过GEF,开发者可以快速实现图形的绘制、编辑操作、拖放功能以及自定义的图形布局。GEF不仅适用于开发...

    GEF基础知识

    - **Control(控制器)**:这部分主要是由一系列`EditPart`组成,它们是GEF的核心组件。每个`EditPart`都对应于模型中的某个元素,并负责处理用户交互。 #### 四、Draw2D的核心组件——LightweightSystem **...

    gef-step2.rar_GEF eclipse_gef

    它提供了模型-视图-控制器(MVC)架构,使得数据模型、视图展示和用户交互操作可以清晰地分离,便于维护和扩展。 **gef-step2.rar**中的内容可能是这个系列教程的第二部分,通常在学习过程中,随着教程的深入,...

    GEF/Draw2D入门例子

    GEF的核心组件包括模型(Model)、场景图(Scene Graph)、视图(View)和控制器(Controller),通过这些组件,开发者可以轻松地构建出具有拖放、连接、撤销/重做等功能的图形编辑器。 ### Draw2D简介 Draw2D是...

    GEF-SDK-3.1.zip

    GEF 为开发者提供了模型-视图-控制器(MVC)的设计模式,使得开发者可以专注于图形编辑功能的实现,而不需要关心底层渲染和交互细节。它包括了基础的图形绘制、事件处理、工具条和菜单集成等核心功能,同时也支持...

    GEF开发实践

    - **建议**: 按照MVC(Model-View-Controller)模式组织代码,将模型、视图和控制器分离开来。 - `Kylingef.module`: 存放模型相关的类和接口。 - `Kylingef.parts`: 存放控制器相关的类和接口。 - `Kylingef.ui`: ...

    Eclipse3.2可视化开发组件(1)

    - **模型-视图-控制器(MVC)** 设计模式:分离了数据模型、用户界面和控制逻辑,使得设计更加灵活和可维护。 - **绘图工具**:包括画布、图元、连接线等基本元素,用于构建图形编辑界面。 - **手势和事件处理**:...

Global site tag (gtag.js) - Google Analytics