一份 JSON 怎么在浏览器里活过来:大屏图纸的反序列化

5 阅读7分钟

一份 JSON 怎么在浏览器里活过来 保存一块大屏,落盘的是一份几百 KB 的 JSON:每个对象的坐标、尺寸、旋转角、样式、绑定的组件类型。加载这块大屏时,浏览器拿到的就是这份字符串。

但 JSON 自己不会画图。它不响应 mousedown,没有选中框,不会跟着画布缩放。从「一份纯数据」到「一堆活对象」,中间是引擎的反序列化链路。我们的大屏内核(datavisCore,一个框架无关的 canvas 引擎)这条链路走过三次重构,这篇把它拆开讲。

一、图纸的两种形态:存储态与运行态

先看这份 JSON 长什么样。以下是内核序列化输出的真实结构(简化自图纸 schema):

{
  "viewportTransform": { "a": 1, "b": 0, "c": 0, "d": 1, "e": 0, "f": 0 },
  "objects": [
    {
      "id": "abc12345",
      "name": "矩形_1",
      "type": "rect",
      "x": 100, "y": 200, "w": 300, "h": 150, "angle": 0,
      "locked": false, "visible": true,
      "component": { "name": "visWidgetRect", "title": "矩形" },
      "states": [],
      "objects": []
    }
  ]
}

注意里面没有任何类信息——没有 class、没有构造函数引用、没有原型链。只有 type: "rect" 这样的字符串标记。

这是刻意的。对象的"类身份"不参与持久化,只存数据,加载时由 Factory 根据 type 字段重新实例化。这样图纸格式与代码版本解耦:今天给 Rect 类加方法、改继承关系,昨天存盘的 JSON 依然能打开。反过来,如果序列化时把原型链一起存了(比如直接 JSON.stringify 一个类实例再 eval 回来),图纸格式就被代码实现绑架了。

从 JSON 到画布对象的四步

二、第一道工序:解压与拆层

大屏图纸不是直接以明文 JSON 存储的。保存链路里有一道压缩:editorUtil.compress(封装了 lz-string)把 JSON 压成 base64 字符串,一份复杂大屏的图纸能从 1MB 级压到三分之一左右(这一步的动机在下一篇《用压缩换带宽》里专门展开)。

所以加载的第一步是识别 compress 标记、调 decompressFromBase64 还原明文。渲染内核(datavisRender)的启动流程里,这一步之后紧跟着一个关键拆分:

  • backend:背景层,整块大屏共用一张;
  • screen:子屏列表,一个子屏就是一页画布,可多个并轮播;
  • frontend:前景层,覆盖在所有子屏之上(比如全局告警弹条)。

三层是三个独立的对象数组,各自走一遍实例化。拆层的目的很实际:切换子屏时只重建 screen 层对象,背景和前景不跟着重建——首屏加载和翻页的性能都省在这里。

三、第二道工序:Factory 按 type 重新实例化

拆层之后拿到的是纯 JSON 数组,接下来是核心一步。上层调用 editor.importData({ objects, viewportTransform }),内核内部用 dataEnlivenObjects 把数组变成对象实例,整条链路是这样的:

JSON 数组
  → 遍历每个节点,取 type 字段
  → Factory.getInstance(editor, {type, ...})   # type → 类的映射中枢
  → new Rect(...) / new Text(...) / new Group(...)
  → 构造函数里挂回行为:emitter 事件、controls 控制点、绘制方法
  → 递归处理子对象(Group 的 objects 数组)
  → setObjects(objects[])                      # 替换内核对象列表
  → 还原 viewportTransform                     # 画布矩阵最后恢复
  → initTypeCount()                            # 重置类型计数
  → emit('canvas:loaded')                      # 通知上层渲染首帧

这套流程跑通之后,编辑器与渲染器共用同一条反序列化路径:datavisRender 拿到图纸走 exposeSetDesign(data) 传给内核,编辑器 studio 页拿同一份图纸也走 importData——前者不初始化编辑 Handler,后者全量初始化,差异只在 Handler 层,实例化层完全复用。这也是为什么同一份图纸在编辑页和投放页渲染结果逐像素一致:不是两套代码对齐出来的,是同一段代码。

Factory 是一个 type → 类 的映射表:rect 映到 Rect,group 映到 Group,cube 映到 Cube。所有对象的创建统一走这个入口——无论是绘制结果、JSON 反序列化还是组合操作,都通过 Factory.getInstance 创建。统一入口的好处是行为挂载只写一遍:每个对象实例在构造时挂上 emitter(事件)、controls(控制点)、对 editor 的反向引用,这些字段在 BaseObject.toJSON 里被 ignoreKeys 过滤掉,不会污染存储。

递归是 Group 的关键点。一个组合对象(比如「页头」= 装饰图 + 大标题文本)序列化后 objects 数组里嵌着子对象的 JSON。反序列化时 Group 构造完成后再对其子数组递归走同一套 Factory 流程,子对象挂回父容器。树的形状由此原样恢复。

四、两处容易做错的细节

viewportTransform 单独还原。 画布矩阵(缩放、平移)不属于任何对象,它是整个视口的状态。如果先恢复矩阵再实例化对象,中途触发一次重绘就会用「对象还没就位」的状态渲染一帧空白。所以顺序是:对象全部就位(setObjects)之后,最后恢复画布矩阵。

initTypeCount 重置类型计数。 内核的自动命名逻辑是「矩形、矩形_1、矩形_2」——计数器按画布上已有的同名类型递增。加载图纸后如果不重置计数,用户新建第一个矩形会被命名成「矩形_37」。importData 的最后一步 initTypeCount 就是扫一遍现有对象把计数器对齐。这种 bug 单看反序列化代码永远发现不了,要等用户新建对象才暴露。

五、为什么不用「存实例、eval 回来」的捷径

工程上确实存在更省事的路:序列化时连原型一起存(serialize-js 之类),加载时 eval 还原,一行代码完成。我们不这么做的原因有三个:

  1. 安全。eval 一份来自后端的 JSON 等于执行任意代码,大屏图纸会在协同场景里流转,来源不可全信;
  2. 体积。原型信息、方法引用序列化后体积暴涨,跟压缩换带宽的方向背道而驰;
  3. 版本耦合。类的实现一改,历史图纸可能直接加载失败;靠 type 字符串 + Factory 映射,最多是新方法对旧图纸不生效,加载本身永远成功。

反序列化的本质是把行为变回对象,而不是把数据变回对象。数据在 JSON 里一个字段都不少,行为全部由内核按 type 重新挂载。想明白这一点,Factory 的存在价值、ignoreKeys 的过滤清单、initTypeCount 的重置时机,全都顺理成章。

最后给一个排查建议。这类「加载后行为异常」的 bug 大多发在实例化之后、行为挂载之前:对象画出来了,但事件不响应,或者选中框位置不对。定位方法是把链路拆开看——先确认 decompressFromBase64 之后的 JSON 完整(对象数与保存时一致),再确认 Factory 每个节点都命中了映射(没命中的节点会静默跳过,画布上就少一块),最后才看 viewportTransform 的矩阵值。三段切开,问题必然落在其中一段。


企业数据资产大屏:反序列化完成后的真实运行态 AI 生成引擎产出的屏幕同样走这条链路落进编辑器:/api/generations/:jobId 轮询拿回完整 screen 文档后,studio 页调 importData 把它变成可编辑的画布对象。下图是同一链路的真实产物——一份由 AI 生成、经反序列化点亮的大屏:

AI 生成大屏:同一份 importData 链路的真实产物 一块真实运行中的数据资产大屏——它此刻正是几十个由 Factory 实例化出来的画布对象在响应你的鼠标。下一篇讲这份 JSON 在存储侧的样子:为什么要 base64 + 压缩,compress 标记怎么双向兼容。

注:文中面板数值为演示数据,非客户数据。


体验地址:www.qiantech.com.cn/