基于图扑 HT for Web 实现拓扑关系图

拓扑结构在计算机网络设计和通信领域中非常重要，因为它描述了网络中的设备（即“点”）如何相互连接（即通过“线”）。这种结构不仅涉及物理布局，即物理拓扑，还可以涉及逻辑或虚拟的连接方式，即逻辑拓扑。

图扑软件自研 HT for Web 产品曾参与搭建了众多拓扑可视化解决方案。如机房通信拓扑可视化，实现通过图形图像直观展示机房内部网络设备、服务器、存储设备以及之间连接关系的技术。帮助 IT 管理员和网络工程师更加直观地理解机房的网络结构，便于故障排查、网络优化和规划扩展。

在 HT 中，ht.Node 可充当拓扑图中的“点”角色，ht.Node 上可显示图片图标，这使得创建拓扑图时能够直观地表示每一个“点”的特征。至于拓扑图中的“线”，即用于体现两个节点之间关系的元素，可由 ht.Edge 类型承担这一任务。ht.Edge用于连接起始和目标两个节点，两个节点间可以有多条ht.Edge存在，也允许起始和目标为同一节点。

在搭建 HT 拓扑图前，我们需要先创建一个 HT 的 2D 视图：

const dm = new ht.DataModel(); // 创建一个数据模型const g2d = new ht.graph.GraphView(dm); // 创建一个 2D 视图g2d.addToDOM(); // 将 2D 视图添加到 body 中dm.setBackground('rgb(240,237,237)'); // 设置背景

2D 视图还可按照需求开启树层次渲染：

dm.setHierarchicalRendering(true);

2D 视图创建完成之后就可以创建“点”和“线”了：

const node1 = createNode('symbols/电信/icon_交换机.json', { x: 0, y: 0 }, "交换机");const node2 = createNode('symbols/电信/icon_路由.json', { x: 300, y: 0 }, "路由");createEdge(node1, node2);function createNode(icon, position, name) {     const node = new ht.Node(); // 创建一个 ht.Node 节点     node.s({         'label': name,         'label.color': "#fff"     });     node.setImage(icon);     node.p(position);     node.setSize({ width: 100, height: 100 });     dm.add(node); // 将节点加到数据模型中     return node;}function createEdge(source, target, color, reverse) {     const edge = new ht.Edge(source, target); // 创建一个 ht.Edge     dm.add(edge); // 将连线节点加到数据模型中     return edge;}

运行代码后的效果：

复杂连线

以上展示了一个简洁的示例，直观地展现了如何在图扑自研 HT for Web 中创建节点并将它们通过连线相连。实际应用中的情形往往更为复杂，需要根据实际数据构建拓扑结构。在这个过程中，核心步骤依旧是首先创建 ht.Node 实例以表示各个节点，再利用 ht.Edge 实例来实现节点之间的连接。接下来，让我们通过复杂一些的示例来演示。

创建节点

为了批量创建节点并方便管理节点数据，示例中定义了结构化的数据格式，并将数据存储在一个 JSON 文件中，再通过 ht.Default.xhrLoad() 去获取到 JSON 文件中的数据。获取到数据后就可批量创建节点。

在实际的运用场景中，也可以通过任何 web 端通讯方式 HTTP/AJAX、WebSocket 去获取数据。

equipment.json 文件中定义的数据格式：

[    {        "name": "核心交换机1", // 设备名称        "code": "EQ_ASBB1425", // 设备编码（唯一标识）        "icon": "symbols/user/900-word/电信拓扑图标/icon_核心交换机.json", // 设备 icon// 设备在图纸中的位置"size": 60, // 节点大小        "position": {            "x": 0,            "y": 100        }    },    {        "name": "核心交换机2",        "code": "EQ_ASBB1478",        "icon": "symbols/user/900-word/电信拓扑图标/icon_核心交换机.json",        "position": {            "x": 200,            "y": 0        }    },    {        "name": "服务器1",        "code": "EQ_BCGJ2121",        "icon": "symbols/user/900-word/电信拓扑图标/空白服务器.json",        "position": {            "x": 200,            "y": 250        }    },   ...]

获取到数据并批量创建节点：

ht.Default.xhrLoad('./equipment.json', function (json) {       const data = ht.Default.parse(json);       data.forEach((item) => {             createNode(item);        })})function createNode(data) {        const node = new ht.Node();        node.setTag(data.code); // 设置节点唯一标识        node.setImage(data.icon);        node.p(data.position);        node.s('2d.movable', false); // 禁止移动        node.setSize({ width: data.size || 150, height: data.size || 150 });        dm.add(node);         return node;}

创建连线

与节点数据相同，示例中定义了连线对应格式，并且也是存储在一个 JSON 文件中，再通过 ht.Default.xhrLoad() 获取数据。JSON 文件中定义了连线中最重要的几个因素：起始节点、目标节点、连线颜色。

[    {        "source": "EQ_ASBB1425", // 起始节点的唯一标识        "target": "EQ_BCGJ2121", // 结束节点的唯一标识        "color": "rgb(0,199,7)" // 连线颜色    },    {        "source": "EQ_ASBB1425",        "target": "EQ_BCGJ2131",        "color": "rgb(0,199,7)"},...]

获取数据并且批量创建连线，这一步需要在创建节点之后执行：

ht.Default.xhrLoad('./connectData.json', function (json) {      const connectData = ht.Default.parse(json);      connectData.forEach((item) => {            createEdge(item);      })})function createEdge(data) {    const source = dm.getDataByTag(data.source);    const target = dm.getDataByTag(data.target);    const edge = new ht.Edge(source, target);    edge.s({        "edge.color": data.color || "rgb(0,199,7)",        "edge.width": 4,        "shadow2.offset.x": -4,        "shadow2.offset.y": 7,        "shadow2": true,        "shadow2.color": "rgba(0,0,0,0.18)",})dm.add(edge);    dm.moveToTop(edge); // 将节点移动至顶部    return edge;}

到这里，基本上整个拓扑的效果都已经展示出来了，但是可能还存在一些问题。如终端路由之间的连线被服务器挡住了，可能会被认为是路由 1—服务器 1—服务器 2—路由 2 这样的连接。

这种情况下，就可以采用其他的连线方式。ht.Edge 提供了多种的连线方式，可以通过 edge.s(‘edge.type’, 连接方式) 进行设置。下面展示几种不同的连接方式：

1.弯曲：edge.s(‘edge.type’, ‘flex2’)

2.正交：edge.s(‘edge.type’, ‘ortho2’)

3.先水平后垂直：edge.s(‘edge.type’, ‘h.v2’)

4.先水平后垂直：edge.s(‘edge.type’, ‘v.h2’)

......

ht.Edge 还有很多种的连线方式，这里就先介绍以上几种方式。

在这个示例内，两个路由之间的连线需要跨域多个其他的连线，为了使得连线更加美观易懂，于是我就这条连线采用了 points 的连线方式，这种方式有极高的灵活性，可在连线路径上自由地添加控制点，从而实现非常多样化的效果。

points 类型的连线，有两个非常重要的属性：

edge.points：控制点信息；
edge.segments：用来标识在绘制时如何使用 points 数组中的顶点信息。

将示例中这条连线的连线类型改为 points，并设置上相应的属性：

edge.s({    'edge.type': 'points',    'edge.center': true,    'edge.points': [        { "x": 680, "y": 105 },        { "x": 490, "y": 200 },        { "x": 470, "y": 200 },        { "x": 410, "y": 230 },        { "x": 400, "y": 250 },        { "x": 360, "y": 270 },        { "x": 340, "y": 270 },        { "x": 260, "y": 310 },        { "x": 250, "y": 330 },        { "x": 80, "y": 415 }    ],    'edge.segments': [1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2]});

使用以上 points 连线类型实现的效果：

增加背景和装饰

可创建一些 ht.Shape 节点作为背景装饰，突出显示特定的设备区域。

createShape([    { x: -100, y: 130 },    { x: 230, y: -50 },    { x: 340, y: 15 },    { x: 10, y: 195 },    { x: -100, y: 130 }], [1, 2, 2, 2, 5])createShape([    { x: -155, y: 354 },    { x: 575, y: -30 },    { x: 805, y: 110 },    { x: 60, y: 510 },    { x: -155, y: 355 },], [1, 2, 2, 2, 5]);createShape([    { x: 300, y: 470 },    { x: 660, y: 275 },    { x: 805, y: 350 },    { x: 435, y: 550 },    { x: 300, y: 470 },], [1, 2, 2, 2, 5])function createShape(points, segments) {    const shape = new ht.Shape();    shape.setPoints(points);    shape.setSegments(segments);    shape.s({        'shape.background': "#fff",        "shape.border.color": "rgba(13,46,79,0.67)",        "shape.border.width": 0.5,    })    dm.add(shape);    dm.moveToTop(shape);    return shape;}

添加背景后的效果如下：

增加一些装饰的节点，这些节点本质上也都是 ht.Node，只是显示了不同的图标/图片，效果如下：

添加箭头

在复杂的网络拓扑中，连线上常常需要表示数据流动方向。在使用图扑 HT 绘制连线时，ht.Edge 提供了 icons 属性，通过 icons 属性，可在 ht.Edge 上定义一系列图标并设置它们在连线上的位置。

在设置 icons 属性前，需要先注册好图标：

ht.Default.setImage('toArrow', {    width: 40,    height: 20,    comps: [        {            type: 'shape',points: [5, 2, 10, 10, 5, 18, 20, 10],            closePath: true,            background: 'rgb(0,199,7)',            borderWidth: 1,            borderColor: 'rgb(0,199,7)',            gradient: 'spread.vertical'        }    ]});ht.Default.setImage('fromArrow', {    width: 12,    height: 12,    comps: [        {            type: 'circle',            rect: [1, 1, 10, 10],            background: 'rgb(0,199,7)'        }    ]});

在 ht.Edge 上设置 icons：

edge.addStyleIcon("fromArrow", {     position: 15, // 图标位置     keepOrien: true, // 图标是否默认自动调整方向以保持最好的阅读效果     names: ['fromArrow']});edge.addStyleIcon("toArrow", {     position: 19,     keepOrien: true,     names: ['toArrow']});

设置 icons 之后的效果：

流动动画

在图扑自研产品 HT for Web 中，使用 ht-flow.js 插件，能够为 ht.Edge 连线添加流动动画效果。这种效果可用于表示数据传输、能源流动或任何类型的动态连接。使用 ht-flow.js 插件实现的流动效果配置起来也十分简单，正确引入 ht-flow.js 插件后，使用 g2d.enableFlow(60); 开启流动，再在 ht.Edge 上设置相应的流动属性即可。

ht.Edge 配置流动效果的一些属性说明：

flow：布尔值，设置为 true 以启用流动效果。
flow.count：控制流动组的个数，默认为 1。
flow.step：控制流动的步进，默认为 3。
flow.element.count: 每个流动组中的元素的个数，默认为 10。
flow.element.space: 流动组中元素的间隔，默认为 3.5。
flow.element.image: 字符串类型，指定流动组中元素的图片，图片需要提前通过 ht.Default.setImage 注册。目前支持设置。
flow.element.background: 流动组中元素的背景颜色，默认为 rgba(255, 255, 114, 0.4)。
flow.element.shadow.begincolor: 字符串类型，表示流动组中的元素的渐变阴影的中心颜色，默认为 rgba(255, 255, 0, 0.3)。
flow.element.shadow.endcolor: 字符串类型，表示流动组中的元素的渐变阴影的边缘颜色，默认为 rgba(255, 255, 0, 0)。
flow.element.shadow.visible：流动阴影是否可见。
flow.begin.percent：开始的位置，值为 0 - 1，默认是 0。
flow.element.autorotate：是否自动朝向，根据连线的角度自动朝向。

在示例的 ht.Edge 上设置流动属性：

edge.s({        "flow": true,        "flow.element.background": "rgba(240, 225, 19, 0.5)",        "flow.element.shadow.begincolor": "rgba(240, 225, 19, 0.5)",        "flow.element.shadow.endcolor": "rgba(240, 225, 19, 0)",        "flow.element.count": 1 });

设置完成后的效果：

在更为复杂的场景中，仅仅依赖简单的样式配置难以满足设计需求，为此 ht-flow.js 提供了 flow.element.image 属性，该属性支持将流动的元素设置为图片或图标，还支持设置为多个图片/图标流动的效果。

在流动上设置图标，需要先注册图标：

ht.Default.setImage('dataIcon1', {    "width": 50,    "height": 50,    "comps": [        {            "type": "shape",            "background": "rgb(125,195,125)",            "borderColor": "#979797",            "points": [                2.94441,                16.1039,                26.41008,                16.1039,                26.41008,                4.28571,                47.05559,                25.58442,                27.23783,                45.71429,                27.23783,                33.84863,                2.94441,                33.84863,                2.94441,                16.1039            ]        }    ]})ht.Default.setImage('dataIcon2', {    "width": 50,    "height": 50,    "comps": [        {            "type": "shape",            "background": "#32D3EB",            "borderColor": "#979797",            "points": [                2.94441,                16.1039,                26.41008,                16.1039,                26.41008,                4.28571,                47.05559,                25.58442,                27.23783,                45.71429,                27.23783,                33.84863,                2.94441,                33.84863,                2.94441,                16.1039            ]        }    ]});在 ht.Edge 上设置属性：edge.s({    "flow": true,    "flow.element.count": 2,    "flow.element.image": ["dataIcon1", "dataIcon2"],    "flow.element.max": 20,    "flow.element.min": 20,    "flow.element.shadow.visible": false,    "flow.element.space": 50,    "flow.element.autorotate": true});