第四章 GEF框架(2)

From:http://www.blog.edu.cn/user1/19180/archives/2005/375050.shtml
4.2 创建一个元素
    下面讨论一下如何创建一个元素，因为如果不能创建新元素，我们就没法测试其他的功能。

    首先讨论系统如何知道何时创建新的元素以及如何创建这个元素。在初始化主界面类的时候，我们设置了一个Palette，我们就利用Palette提供的功能告知系统何时及如何创建元素。设置Palette的时候，我们使用了CreationToolEntry，当用户点击这个ToolEntry的时候，eclipse就知道用户需要创建一个（块状）元素，接着用户在编辑区域按下左键，并脱拽出一个区域，当松开右键的时候，系统就会产生一个REQ_CREATE请求，并将这个请求发送给根模型的EditPart，在之前的例子中，Diagram就是我们的根模型。

    根EditPart翻译这个根据这个请求传进来的参数（你可以从中获得用户单击的位置和区域，以及要创建的模型类型），创建一个Command。系统执行这个Command，在Command中，我们可以新建一个模型，并将它作为根模型（Diagram）的子女插入其中。根模型发现自己的子女发生了变化，它就会通知自己的EditPart进行刷新，EditPart刷新的时候会将模型的子女和自己的EditPart子女进行一个映射，当发现子模型找不到子EditPart的时候，它就会请求视图的EditPartFactory创建新的EditPart，并将它作为自己的子女。

    上述创建的过程大部分都是GEF提供的，只有一个问题，那就是如何让EditPart获得模型的子女，这个时候你需要覆盖EditPart中的一个操作：getModelChildren。之前解释过EditPartFactory的原理，利用它可以根据模型创建EditPart。之后新的EditPart再试图更新自己的Figure，但是这个时候还没有创建Figure，因此它会调用自己的createFigure函数创建自己的Figure，你需要覆盖这个接口。



4.3 消息响应与MVC同步
    当系统向EditPart发送Request的时候，EditPart调用getCommand函数，getCommand函数如果可以处理这个请求，它就会生成对应的Command，否则返回null。getCommand函数首先尝试直接处理，如果不能处理再查看自己的有没有哪个EditPolicy能够处理这个请求（所以我们重载getCommand函数的时候，一定不要忘了调用父类的getCommand函数。如果这个EditPart不能处理这个请求，在有些情况下（比如类型REQ_RESIZE请求，但不知道是不是所有的请求都会这样），系统会调用其父类的发送一个新的请求，令它处理。如果无论如何EditPart都无法处理这个请求，那么系统就会禁止请求所代表的功能。

    举个例子来说，如果你移动了一个Figure，系统就会发送一个类型为REQ_MOVE的ChangeBoundsRequest请求给这个Figure对应的EditPart。你可以在这里处理该请求，否则系统会向这个Figure的父亲发送一个类型为REQ_MOVE_CHILDREN的ChangeBoundsRequest请求。如果你没有编写创建移动对象的Command，那么eclipse就会将光标设置为不许移动的光标。我们再看一下getCommand函数的例子：

public Command getCommand(Request request) {
    if(REQ_RESIZE.equals(request.getType())) {
        ChangeBoundsRequest req=(ChangeBoundsRequest)request;
        Node node=(Node)getModel();
        ResizeNodeCommand cmd=new ResizeNodeCommand(node,this);
        Rectangle rect=new Rectangle(node.getLocation(),node.getSize());
        cmd.setRectangle(req.getTransformedRectangle(rect));
        return cmd;
    }
    return super.getCommand(request);
}

在这个函数中，我们处理了一个REQ_RESIZE请求并生成了一个Command。

    什么是EditPolicy呢？它是为了分担EditPart处理Request的负担而出现的，每一种EditPartPolicy都扮演了一个角色（Role），它负责处理一类请求。EditPolicy不是必需的，它完全可以由getCommand函数代替。但是，使用EditPolicy有助于代码的重用。你必须实现createEditPolicies接口函数，并调用installEditPolicy方法为EditPart安装Policy。我们再看一下createEditPolicies函数的例子：

protected void createEditPolicies() {
    installEditPolicy(EditPolicy.DIRECT_EDIT_ROLE, new NodeDirectEditPolicy());
    installEditPolicy(EditPolicy.COMPONENT_ROLE, new NodeEditPolicy());
    installEditPolicy(EditPolicy.GRAPHICAL_NODE_ROLE, new NodeGraphicalNodeEditPolicy());
}

关于EditPolicy的问题，下一节在继续讨论。

    并不是所有的Request都交给getCommand函数处理，有些Request也分派给performRequest函数处理。performRequest函数用于处理一些特殊的请求，比如在位编辑请求。你可以查看RequestConstance中对于请求类型的定义，里面说明了请求的处理位置。我们再看一下performRequest函数的例子：

public void performRequest(Request req) {
    if (req.getType().equals(RequestConstants.REQ_DIRECT_EDIT)) {
        if (manager == null) {
            NodeFigure figure = (NodeFigure) getFigure();
            manager = new NodeDirectEditManager(this, TextCellEditor.class, new NodeCellEditorLocator(figure));
        }
        manager.show();
    }
}
    由上可见，EditPart并不直接修改模型，当需要修改的时候，它会利用Command。而当模型发生变化的时候，它必须通知EditPart更新视图。模型拥有一个PropertyChangeSupport对象，而EditPart实现一个PropertyChangeListener，并向模型注册自己为监听者，同时实现一个propertyChange函数。当模型变化，它会调用PropertyChangeSupport的firePropertyChange函数通知EditPart，并调用propertyChange函数。