GEF 连线路由（Router）

 

第二部分:Router

Router（连线路由器）是对连线进行布局的重要组件，本文介绍了路由器的基本概念和应用场景，剖析了一个连线路由器的接口并给出了一个简单实例。最后演示了如何把自定义的路由器应用到图形中，使得不同的连线可以有不同的路由器。

ConnectionRouter（连线路由器）

图形之间连线的路线，是由连线路由器来决定的。在Shapes Examples中，使用了最短路径路由器，这个路由器会帮我们绕开图形之间的障碍，选择一条最短路径进行连接，如图1所示：

图1. ShortestPathConnectionRouter效果图

我们看到左右两边图形的连线绕过了中间的图形，在两处发生了转折。这就是使用了最短路径路由器的效果。连线路由器可以安装到Connection Layer(连接层，关于层的概念我们在本系列下一篇中讲述)，也可以针对某一条连接，所以只要你愿意，每条连线都可以有不同的路由器。如果你没有为某条连线指定一个路由器，那么缺省会使用连接层的路由器。Draw2D自带了一些路由器的实现，除了图1的ShortestPathConnectionRouter，还有ManhattanConnectionRouter等路由器实现，如果这些自带的路由器不能满足我们的需要，我们所要做的就是实现ConnectionRouter接口，实现一个自定义路由器。ConnectionRouter接口并不复杂，如下所示：

Object getConstraint(Connection connection);

void setConstraint(Connection connection, Object constraint);

void invalidate(Connection connection);

void route(Connection connection);

void remove(Connection connection);

setConstraint和getConstraint用来设置/得到连接上的Constraint(约束)，所谓Constraint是指加在某个连线上的一些参数。我们可以看到constraint是一个Object类型，因为不同的路由器可能对constraint有不同的要求，对于ShortestPathConnectionRouter来说，constraint需要是一个List对象，里面包含了所有的转折点。

invalidate方法可以将一个连线置为无效，这样在下一次布局操作时，无效的连接将被重新路由。remove方法是将连线从路由器中删除，也就是路由器不会再负责这条连线的布局，一般只有在删除一条连线的时候才会调用到，我们可以在里面做一些清除工作，比如释放和连线相关的cache。route方法是路由操作真正发生的地方，我们一般只需要实现route方法就可以了，如果你还想做一些其他的操作，可以考虑实现其他方法。同样，一般是不推荐直接实现ConnectionRouter接口的，我们可以继承AbstractRouter类，这个类提供了一些简单的或者空的实现，还提供了两个额外的方法getStartPoint()和getEndPoint()方便我们得到连线的两个端点。

SingleBendpointConnectionRouter

我们将实现一个自定义的路由器，叫做SingleBendpointConnectionRouter，它采用一种走直角的方式连接两个图形，如图2所示：

图2. SingleBendpointConnectionRouter效果图

也许这种路由器并没有太多的通用性，但是我们只是作为一个例子演示路由器的实现，了解了基本方法之后，再去实现更复杂更实用的路由器也就大同小异了。

路由器实现的前提

显然我们无法凭空的计算出线路的走向，一条连线的具体路线和很多因素有关，比如锚点、图形的位置和大小，图形之间的相互关系，等等。所以我们需要能够访问到这些必须的信息，在Connection接口中，我们有getTargetAnchor()和getSourceAnchor()可以让我们得到锚点，而在ConnectionAnchor接口中（参见本系列第一部分），我们有getOwner()这样的方法，可以得到图形。这些必要的方法为我们实现路由器提供了可能。

实现route方法

route方法的代码如下:

 

 

       public void route(Connection conn) {

              // 清空连线的所有点

              PointList points = conn.getPoints();

              points.removeAllPoints();

             

              // 得到目标和源参考点

              Point sourceRef = conn.getSourceAnchor().getReferencePoint();

              Point targetRef = conn.getTargetAnchor().getReferencePoint();

              A_POINT.setLocation(sourceRef.x, targetRef.y);

             

              // 得到起始点和结束点

              Point startPoint = conn.getSourceAnchor().getLocation(A_POINT);

              Point endPoint = conn.getTargetAnchor().getLocation(A_POINT);

             

              // 添加起始点

              A_POINT.setLocation(startPoint);

              conn.translateToRelative(A_POINT);

              points.addPoint(A_POINT);

             

              // 添加转折点

              A_POINT.setLocation(sourceRef.x, targetRef.y);

              conn.translateToRelative(A_POINT);

              points.addPoint(A_POINT);

             

              // 添加结束点

              A_POINT.setLocation(endPoint);

              conn.translateToRelative(A_POINT);

              points.addPoint(A_POINT);

             

              // 设置连线经过的所有点

              conn.setPoints(points);

       }

      

 

一条连线实际上是通过一系列的点来描述的，而route方法的实际任务也就是计算出这些点的位置。所以我们一开始就得到了这条连线的点序列（PointList对象），然后清空它，重新计算这些点。在我们这个路由器的设计里，一条连线由三个点组成：分别是起始点，转折点和结束点，它们构成了两条垂直的直线。起始点和结束点（也就是锚点）我们都已经了解如何得到了，中间的转折点，也很容易得出，我们就不解释了。要指出的是，我们需要把它们的坐标转换为相对坐标再添加，同时在添加完成之后，我们还需要调用setPoints()方法，这样才会生效。

所以说实现一个路由器的过程是很简单的，复杂之处在于路由算法，但这已经不属于GEF的范畴，所以我们就不讨论它了。

改变连接层的路由器

我们只是实现了路由器，还没有把这个路由器设置为缺省的路由器，所以我们还要做一点小修改，在DiagramEditPart的createFigure()方法里，将ShortestPathConnectionRouter替换为SingleBendpointConnectionRouter即可。

待改进的地方

我们的自定义路由器很简单，但是它也有一点小问题，当两个图形在垂直或水平方向有重叠时，连线看上去有点不正常，如图3所示：
图3. 一点小bug

这只是由于我们的路由器算法不是很完善，没有考虑到所有情况而已。你可以尝试修改一下route的算法，改正这个问题，我们这里就不详细演示了。

为连线指定路由器

我们目前是将路由器安装到了连接层，于是所有的连线都会使用同一个路由器，有些时候为了让布局更加灵活，我们需要为一条或多条连线指定一个不同的路由器。由于Connection接口中提供了setConnectionRouter()方法，因此这是可以实现的。

修改model

为了让连线知道它要使用何种路由器，我们需要修改连线的model，把当前的路由器种类存进去，我们在Connection.java里面加上一个routerId的成员，同时再定义一些表示不同路由器的常量：

 

// router id constant

public static final int SHORTEST_PATH_ROUTER = 0;

public static final int MANHATTAN_ROUTER = 1;

public static final int SINGLE_BENDPOINT_ROUTER = 2;

 

private int routerId;

 

public int getRouterId() {

       return routerId;

}

 

public void setRouterId(int routerId) {

       this.routerId = routerId;

}

 

添加属性

为了能够随时修改连线的路由器，我们为连线添加一个router属性，由于这些内容不在本文讨论范围中，所以不一一描述了。完成之后，我们可以在属性视图中看到连线的路由器属性和可选值：

图4. Router属性

于是我们就可以让多种连线方式共存了，对于复杂的图形来说这样可以尽量避免连线重叠，增加布局的美观程度。

图5. 使用多种路由器
 

结束语

     Shape例子 代码：

父模型 控制器中DiagramEditpart.java 中：

 

       protected IFigure createFigure() {

              // TODO 自动生成方法存根

             

      

              Figure f = new FreeformLayer();

              f.setBorder(new MarginBorder(3));

              f.setLayoutManager(new FreeformLayout());

 

              // Create the static router for the connection layer

              ConnectionLayer connLayer = (ConnectionLayer)getLayer(LayerConstants.CONNECTION_LAYER);

              connLayer.setConnectionRouter(new ShortestPathConnectionRouter(f));

             

              return f;        

       }