xdingding  
日历
<2009年10月>
27282930123
45678910
11121314151617
18192021222324
25262728293031
1234567
统计
  • 随笔 - 26
  • 文章 - 0
  • 评论 - 35
  • 引用 - 0

导航

常用链接

留言簿(11)

我参与的团队

随笔分类

随笔档案

最新随笔

搜索

  •  

积分与排名

  • 积分 - 28214
  • 排名 - 1305

最新评论

阅读排行榜

评论排行榜

 

郁闷!同志们没有留言,不知是写的太差,何处需要改进,还是大家觉得对自己没有用处.... 

GEF源码分析(四) GEF 消息转义 ___ Tool的作用


接着上一节:

我们先解决如下问题:

在界面操作过程中,我们希望面对的是边框调整事件,图形移动事件,或者是编辑文本事件,而不是原始的鼠标和键盘事件?

 

 

术语定义:

系统UI事件:        一般由某些计算机人机交互硬件发出信号,并且经操作系统理解后产生的事件,例如:原始的鼠标的移动、点击和键盘的敲击事件等。

UI业务语义事件: 由系统UI事件和其它UI业务语义事件触发,由UI业务代码理解后产生的事件(操作系统不可理解,同时无任何领域的业务语义),如2D图形的尺寸调整,2D图形的点击,2D图形的移动。

(其实不仅限于事件的转义,包括UI的改变,也需要由系统UI语义转换到UI业务语义来使用)

 

UI业务语义事件在Controller控制中的优点是易于理解、维护和扩充,具体的主要有以下方面:

a.减少系统UI事件判断逻辑部分代码的重复。比如在Controller部分代码无需分步着大量逻辑重复的代码,当鼠标移动时去判断究竟是一个2D图形的尺寸改变,还是一个2D图形的移动,还是一组2D图形的移动,还是2D图形DragAndDrop的动作。

b.Controller部分的代码语义明确。在Controller内部处理代码和接口中直接面对的是UI业务语义,如图形的移动,图形的尺寸改变,这样、代码易于理解、调试等。

b.Controller部分代码无需为系统UI事件保存状态。如2D图形的移动中,如果这些事件直接在Controller中处理,从开始MouseDown,MouseMove,到MouseUp过程中,在Controller中要集中保留这样众多状态,极易造成Controller代码具体多头职责的症状,从而患上严重的精神分裂:)

 

于是乎GEFFrameWork有给出以下的解决方案:

 

A


 



如上图
A

GEF通过Tools(interfaceTool),当然在视图上的MenuToolbar是通过Action发出,这个是eclipseWorkbench机制,在此就不讨论了。以下是Tool的类继承树:

 

B



从上图
B可以看出

Tool继承的这些类均处理一个或者一类UI业务语义事件,其中需要保留中间状态的子类均以XXXTracker形式出现。

首先这些Tool的实现类通过Tool的接口(上图右边),接收界面来的事件,然后调用内部handleXXX,这样通过内部函数getTargetRequest()[createTargetRequest()]和getSourceRequest()[createSourceRequest()],把系统UI事件转换为UI业务语义事件叫Request(如图C)。至此Tool会通过调用相关联的EditPart的接口将UI业务语义事件通知到EditPart中。于是在Controller(EditPart)中仅仅需要理解处理Request对象。

 


 

C

 

下面以ResizeTracker代码为例:

class ResizeTracker

protected Request createSourceRequest() {

ChangeBoundsRequest request;

request = new ChangeBoundsRequest(REQ_RESIZE);

request.setResizeDirection(getResizeDirection());

return request;

}

protected Command getCommand() {

List editparts = getOperationSet();

EditPart part;

CompoundCommand command = new CompoundCommand();

command.setDebugLabel("Resize Handle Tracker");//$NON-NLS-1$

for (int i = 0; i < editparts.size(); i++) {

part = (EditPart)editparts.get(i);

command.add(part.getCommand(getSourceRequest()));

}

return command.unwrap();

}

protected void eraseTargetFeedback() {

if (!getFlag(FLAG_TARGET_FEEDBACK))

return;

if (getTargetEditPart() != null)

getTargetEditPart().eraseTargetFeedback(getSourceRequest());

setFlag(FLAG_TARGET_FEEDBACK, false);

}

protected boolean handleButtonUp(int button) {

if (stateTransition(STATE_DRAG_IN_PROGRESS, STATE_TERMINAL)) {

eraseSourceFeedback();

eraseTargetFeedback();

performDrag();

}

return true;

}

 

 

最后还有个问题是


Tool
这些事件接口,如何从Viewer传递过来的呢?

 

 

我画了一个简要的类图


D


参照上图,下面罗列重要代码:

大家主要以下两方面

一、创建这些关键事件处理链的过程(注意图上的粗体文字);

二、消息从SWTCanvas实例传递到Tool过程(图D中注释标签的顺序);

 

class GraphicalEditor

public void createPartControl(Composite parent) {

createGraphicalViewer(parent);

}

protected void createGraphicalViewer(Composite parent) {

GraphicalViewer viewer = new ScrollingGraphicalViewer();

viewer.createControl(parent);

setGraphicalViewer(viewer);

configureGraphicalViewer();

hookGraphicalViewer();

initializeGraphicalViewer();

}

protected void setGraphicalViewer(GraphicalViewer viewer) {

getEditDomain().addViewer(viewer);

this.graphicalViewer = viewer;

}

class EditDomain

public void addViewer(EditPartViewer viewer) {

viewer.setEditDomain(this);

if (!viewers.contains(viewer))

viewers.add(viewer);

}

class GraphicalViewerImpl

public void setEditDomain(EditDomain domain) {

super.setEditDomain(domain);

// Set the new event dispatcher, even if the new domain is null.  This will dispose

// the old event dispatcher.

getLightweightSystem()

.setEventDispatcher(eventDispatcher = new DomainEventDispatcher(domain, this));

}

 

private final LightweightSystem lws = createLightweightSystem();

 

class ScrollingGraphicalViewer

public void setEditDomain(EditDomain domain) {

super.setEditDomain(domain);

// Set the new event dispatcher, even if the new domain is null.  This will dispose

// the old event dispatcher.

getLightweightSystem()

.setEventDispatcher(eventDispatcher = new DomainEventDispatcher(domain, this));

}

class LightweightSystem

public void setEventDispatcher(EventDispatcher dispatcher) {

this.dispatcher = dispatcher;  //在此Shapes例子中是DomainEventDispatcher

dispatcher.setRoot(root);

dispatcher.setControl(canvas);

}

protected void addListeners() {

EventHandler handler = createEventHandler();

canvas.getAccessible().addAccessibleListener(handler);

canvas.getAccessible().addAccessibleControlListener(handler);

canvas.addMouseListener(handler);

canvas.addMouseMoveListener(handler);

canvas.addMouseTrackListener(handler);

canvas.addKeyListener(handler);

canvas.addTraverseListener(handler);

canvas.addFocusListener(handler);

canvas.addListener(SWT.MouseWheel, handler);

……

setEventDispatcher(getEventDispatcher());

}

 

class EventHandler

implements MouseMoveListener, MouseListener, AccessibleControlListener, KeyListener,

TraverseListener, FocusListener, AccessibleListener, MouseTrackListener,

Listener

{

public void keyPressed(KeyEvent e) {

 //在此Shapes例子中是DomainEventDispatcher

getEventDispatcher().dispatchKeyPressed(e);

}

public void mouseDoubleClick(MouseEvent e) {

getEventDispatcher().dispatchMouseDoubleClicked(e);

}

public void mouseMove(MouseEvent e) {

getEventDispatcher().dispatchMouseMoved(e);

}

public void mouseUp(MouseEvent e) {

getEventDispatcher().dispatchMouseReleased(e);

}

}

 

这样、在图ARequest发送到EditPart机制做了简要的探讨。

学习了Tool产生Request的机制,可以帮助我们调试GEF,同时如果在大家自己的程序中需要有新的UI交互类型,也可以试着建立自己的Tool类产生新的Request,这样在自己的EditPart产生对应的Command,这样就可以处理实现新的UI交互类型。

 

在下一篇我们探讨一下有关图A中的EditPart如何产生Command,以及执行Command问题。

posted on 2005-12-05 13:58 般若菩提 阅读(1879) 评论(4)  编辑  收藏 所属分类: GEF源码分析
评论:
  • # re: GEF源码分析(四) GEF 消息转义 ___ Tool的作用  胡子鱼 Posted @ 2005-12-06 17:05
    呵,图文并茂,写得很清楚,兄弟辛苦了!

    留言之所以少,可能很多人只是拿来就用,认为在eclipse下配置好就OK,用不着去研究了;另外这里大牛比较多,都在Web framework或者software design……
      回复  更多评论   

  • # re: GEF源码分析(四) GEF 消息转义 ___ Tool的作用  鬼谷子 Posted @ 2006-08-15 14:21
    不错不错,终于找到一个好地方可以深入学习GEF了~~
    谢谢了哈~~  回复  更多评论   

  • # re: GEF源码分析(四) GEF 消息转义 ___ Tool的作用[未登录]  house Posted @ 2008-01-03 15:54
    好  回复  更多评论   

  • # re: GEF源码分析(四) GEF 消息转义 ___ Tool的作用[未登录]  dragon Posted @ 2009-10-20 15:08
    是不错,就是你的blog风格有点乱!谢谢!  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 
 
Copyright © 般若菩提 Powered by: 博客园 模板提供:沪江博客