拓扑结构在计算机网络设计和通信领域中非常重要，因为它描述了网络中的设备（即“点”）如何相互连接（即通过“线”）。这种结构不仅涉及物理布局，即物理拓扑，还可以涉及逻辑或虚拟的连接方式，即逻辑拓扑。
图扑软件自研 HT for Web 产品曾参与搭建了众多拓扑可视化解决方案。如机房通信拓扑可视化，实现通过图形图像直观展示机房内部网络设备、服务器、存储设备以及之间连接关系的技术。帮助 IT 管理员和网络工程师更加直观地理解机房的网络结构，便于故障排查、网络优化和规划扩展。
系统分析
在 HT 中，ht.Node 可充当拓扑图中的“点”角色，ht.Node 上可显示图片图标，这使得创建拓扑图时能够直观地表示每一个“点”的特征。至于拓扑图中的“线”，即用于体现两个节点之间关系的元素，可由 ht.Edge 类型承担这一任务。ht.Edge用于连接起始和目标两个节点，两个节点间可以有多条ht.Edge存在，也允许起始和目标为同一节点。
在搭建 HT 拓扑图前，我们需要先创建一个 HT 的 2D 视图：
代码语言：javascript复制const dm = new ht.DataModel(); // 创建一个数据模型
const g2d = new ht.graph.GraphView(dm); // 创建一个 2D 视图
g2d.addToDOM(); // 将 2D 视图添加到 body 中
dm.setBackground('rgb(240,237,237)'); // 设置背景2D 视图还可按照需求开启树层次渲染：
代码语言：javascript复制dm.setHierarchicalRendering(true);2D 视图创建完成之后就可以创建“点”和“线”了：
代码语言：javascript复制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 文件中定义的数据格式：
代码语言：javascript复制[
{
"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
}
},
...
]获取到数据并批量创建节点：
代码语言：javascript复制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 文件中定义了连线中最重要的几个因素：起始节点、目标节点、连线颜色。
代码语言：javascript复制[
{
"source": "EQ_ASBB1425", // 起始节点的唯一标识
"target": "EQ_BCGJ2121", // 结束节点的唯一标识
"color": "rgb(0,199,7)" // 连线颜色
},
{
"source": "EQ_ASBB1425",
"target": "EQ_BCGJ2131",
"color": "rgb(0,199,7)"
},
...
]获取数据并且批量创建连线，这一步需要在创建节点之后执行：
代码语言：javascript复制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，并设置上相应的属性：
代码语言：javascript复制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 节点作为背景装饰，突出显示特定的设备区域。
代码语言：javascript复制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 属性前，需要先注册好图标：
代码语言：javascript复制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 上设置流动属性：
代码语言：javascript复制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 属性，该属性支持将流动的元素设置为图片或图标，还支持设置为多个图片/图标流动的效果。
在流动上设置图标，需要先注册图标：
代码语言：javascript复制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
});设置完成后的效果：
拓扑可视化优点
- 直观性：将抽象的关系和数据通过图形呈现，使得人们可以直观地理解和分析系统或网络的结构。
- 互动性：现代拓扑可视化工具通常支持用户与图形的交互操作，如缩放、拖拽节点、探索节点之间的路径等，进一步提升了分析的深度和广度。
- 动态性：能够实时反映系统或网络的变化，及时展现新增元素和调整后的结构关系，对于监控和管理系统状态尤为重要。
- 灵活性：用户可以根据需要选择不同的布局算法，调整图形的展示方式，更好地适应不同的分析场景。
您可以至图扑软件官网查看更多案例及效果：
https://www.hightopo.com/demos/index.html
