GEF回顾——shapes示例分析(Controller篇)

最新推荐文章于 2018-12-24 23:12:16 发布

原创最新推荐文章于 2018-12-24 23:12:16 发布 · 1.5k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#shapes #object #list #图形 #eclipse #null

GEF 专栏收录该内容

9 篇文章

订阅专栏

本文深入探讨了GEF框架中控制器的核心作用，特别是ShapeEditPart如何作为模型与视图间的桥梁，实现模型变化与视图更新的自动同步。

最后轮到GEF中最重要的Controller——控制器了。它们是model和view之间的桥梁。我们先从直观上来分析这种连接作用。
1    Connection <-->ConnectionEditPart <-->PolylineConnection
2    EllipticalShape <-->ShapeEditPart <-->Ellipse
3    RectangularShape <-->ShapeEditPart <-->RectangleFigure
4    ShapeDiagram <-->DiagramEditPart <-->FreeformLayer
     再看一个图：

     先分析一下ShapeEditPart类。
class ShapeEditPart extends AbstractGraphicalEditPart
    implements PropertyChangeListener, NodeEditPart

     它继承自AbstractGrahpicalEditPart，同时实现了PropertyChangeListener和NodeEditPart。
AbstractGrahpicalEditPart 是一个非常重要的类，是GEF中控制器的核心。既然它是模型和视图的桥梁。那么猜想一下它一定知道模型是什么、视图在哪里。看一下它的成员变量：
1    figure：IFigure 视图表现，在createFigure()中初始化；
2    model：Object 模型，由EditPartFactory传递给EditPart；
3    parent：EditPart 父亲EditPart，EditPart的父子关系由model决定；
4    children：List 子EditPart
5    sourceConnections：List 源连接模型对应的EditPart
6    targetConnections：List 目的连接模型对应的EditPart
7    policies：Object[] 策略，稍后再议。

    这里就很明了，在EditPartFactory中，根据模型来产生EditPart，然后在EditPart中的createFigure()创建图形，再通过一系列的方法刷新显示（refreshVisuals()、refreshChildren()等）。
先看看EditPartFactory的实现——ShapesEditPartFactory.java：
/******************************************************************************* * Copyright (c) 2004, 2005 Elias Volanakis and others. ?* All rights reserved. This program and the accompanying materials ?* are made available under the terms of the Eclipse Public License v1.0 ?* which accompanies this distribution, and is available at ?* http://www.eclipse.org/legal/epl-v10.html ?* ?* Contributors: ?*????Elias Volanakis - initial API and implementation ?*******************************************************************************/ package org.eclipse.gef.examples.shapes.parts; import org.eclipse.gef.EditPart; import org.eclipse.gef.EditPartFactory; import org.eclipse.gef.examples.shapes.model.Connection; import org.eclipse.gef.examples.shapes.model.Shape; import org.eclipse.gef.examples.shapes.model.ShapesDiagram; /** * Factory that maps model elements to edit parts. * * @author Elias Volanakis */ public class ShapesEditPartFactory implements EditPartFactory { /* * (non-Javadoc) * * @see * org.eclipse.gef.EditPartFactory#createEditPart(org.eclipse.gef.EditPart, * java.lang.Object) */ public EditPart createEditPart(EditPart context, Object modelElement) { // get EditPart for model element EditPart part = getPartForElement(modelElement); // store model element in EditPart part.setModel(modelElement); return part; } /** * Maps an object to an EditPart. * * @throws RuntimeException * if no match was found (programming error) */ private EditPart getPartForElement(Object modelElement) { if (modelElement instanceof ShapesDiagram) { return new DiagramEditPart(); } if (modelElement instanceof Shape) { return new ShapeEditPart(); } if (modelElement instanceof Connection) { return new ConnectionEditPart(); } throw new RuntimeException("Can't create part for model element: " + ((modelElement != null) ? modelElement.getClass().getName() : "null")); } }

     核心就是getPartForElement()方法了，也就是根据模型创建EditPart（控制器）了。
它实现了PropertyChangeListener，这个接口只有一个方法，propertyChange()。上面我们在讲Connection.java的时候，说
有行代码：
firePropertyChange(LINESTYLE_PROP, null, new Integer(this.lineStyle));
它将线条样式这个属性的变更通知给属性监听器，要求它做一些处理。这里ShapeEditPart就是一个属性监听器，它接收到传递过来的属性变更信息，然后做出一些处理，见：

/* (non-Javadoc) * @see java.beans.PropertyChangeListener#propertyChange(java.beans.PropertyChangeEvent) */ public void propertyChange(PropertyChangeEvent evt) { String prop = evt.getPropertyName(); if (Shape.SIZE_PROP.equals(prop) || Shape.LOCATION_PROP.equals(prop)) { refreshVisuals(); } else if (Shape.SOURCE_CONNECTIONS_PROP.equals(prop)) { refreshSourceConnections(); } else if (Shape.TARGET_CONNECTIONS_PROP.equals(prop)) { refreshTargetConnections(); } }

至此ShapeEditPart将模型与视图关联到了一起，模型的改动将带来视图的改动，这个过程是自动的。
在ShapeEditPart的初始化过程中，有几个方法比较重要：
1 activate()：EditPart被激活的操作，包括激活所有子EditParta以及给对应的模型添加属性监听器；

/** * Upon activation, attach to the model element as a property change listener. */ public void activate() { if (!isActive()) { super.activate(); ((ModelElement) getModel()).addPropertyChangeListener(this); } }
同时请注意在deactivate()中进行的remove操作。
2 createEditPolicies()：安装编辑策略，这与图形编辑器是否提供可视化的操作相关，比如拖拽、创建、删除；
3 createFigure()：创建视图图形元素。

还有一些其他比较重要的方法，如下：

a) getModelSourceConnections() ：与连接有关，返回对应模型的源连接；

b) getModelTargetConnections() ：与连接有关，返回对应模型的目的连接；

c) getSourceConnectionAnchor(ConnectionEditPart connection) ：获取源连接的锚点，也就是连接与图形的焦点位置，详细见后面 ConnectionEditPart 的讲解；

d) getSourceConnectionAnchor(Request request) ：获取源连接的锚点，这个锚点与 Request 相关，详细见后面 Policy 的讲解部分；

e) getTargetConnectionAnchor(ConnectionEditPart connection) ：获取目的连接的锚点，也就是连接与图形的焦点位置，详细见后面 ConnectionEditPart 的讲解；

f) getTargetConnectionAnchor(Request request) ：获取目的连接的锚点，这个锚点与 Request 相关，详细见后面 Policy 的讲解部分；

在org.eclipse.gef.examples.shapes.parts下还有一部分是AbstractTreeEditPart的继承类，这些类用于在Outline 视图中显示大纲的。它们同样由EditPartFactory控制：

/******************************************************************************* * Copyright (c) 2004, 2005 Elias Volanakis and others. ?* All rights reserved. This program and the accompanying materials ?* are made available under the terms of the Eclipse Public License v1.0 ?* which accompanies this distribution, and is available at ?* http://www.eclipse.org/legal/epl-v10.html ?* ?* Contributors: ?*????Elias Volanakis - initial API and implementation ?*******************************************************************************/ package org.eclipse.gef.examples.shapes.parts; import org.eclipse.gef.EditPart; import org.eclipse.gef.EditPartFactory; import org.eclipse.gef.examples.shapes.model.Shape; import org.eclipse.gef.examples.shapes.model.ShapesDiagram; /** * Factory that maps model elements to TreeEditParts. TreeEditParts are used in * the outline view of the ShapesEditor. * * @author Elias Volanakis */ public class ShapesTreeEditPartFactory implements EditPartFactory { /* * (non-Javadoc) * * @see * org.eclipse.gef.EditPartFactory#createEditPart(org.eclipse.gef.EditPart, * java.lang.Object) */ public EditPart createEditPart(EditPart context, Object model) { if (model instanceof Shape) { return new ShapeTreeEditPart((Shape) model); } if (model instanceof ShapesDiagram) { return new DiagramTreeEditPart((ShapesDiagram) model); } return null; // will not show an entry for the corresponding model // instance } }