JSON.CN让代码更轻
JSON 结构对比可运行案例

异步任务:解释 tasks 首部插入导致的多处差异

数组按下标逐项比较。在 tasks 开头插入记录后,后续元素位置移动,会产生多处修改和一个尾部新增;这不等于多条业务记录都发生了真实字段变更。需要按 ID 配对时应先在自己的业务逻辑中处理。

浏览器本地处理合成数据同场景 32 个案例 ↗

示例工作台

在完整工具中打开 ↗
JSON 结构对比修改下方数据后重新运行
运行结果
[
  {
    "op": "replace",
    "path": "/data/tasks/0/taskId",
    "oldValue": "demo-jobs-1",
    "value": "demo-inserted"
  },
  {
    "op": "replace",
    "path": "/data/tasks/0/taskName",
    "oldValue": "演示导出任务",
    "value": "新增演示记录"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/taskId",
    "oldValue": "demo-jobs-2",
    "value": "demo-jobs-1"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/taskName",
    "oldValue": "演示清理任务",
    "value": "演示导出任务"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/progress",
    "oldValue": 65,
    "value": 0
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/retryable",
    "oldValue": false,
    "value": true
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/state",
    "oldValue": "running",
    "value": "queued"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/execution/worker",
    "oldValue": "worker-b",
    "value": "worker-a"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/execution/steps/0",
    "oldValue": "scan",
    "value": "prepare"
  },
  {
    "op": "add",
    "path": "/data/tasks/1/execution/steps/1",
    "value": "export"
  },
  {
    "op": "add",
    "path": "/data/tasks/2",
    "value": {
      "taskId": "demo-jobs-2",
      "taskName": "演示清理任务",
      "progress": 65,
      "retryable": false,
      "state": "running",
      "execution": {
        "worker": "worker-b",
        "steps": [
          "scan"
        ]
      }
    }
  }
]

原例已核验,可修改输入后重新运行。

⌘ / Ctrl + Enter 运行
01

场景与操作说明

异步任务接收成功与执行完成是两个状态。本例用于查看和校验任务返回,不进行真实轮询、重试或任务调度。

progress 使用本例 0 到 100 的进度约定;下面通用非负约束不等于完整进度合同。

  1. 核对 异步任务 的字段层级,保留 taskId 的字符串类型。
  2. 修改一项输入并运行,观察结果中的值或路径如何变化。
  3. 载入对照样本,复现下面的变化;恢复原例会替换当前输入。
02

对照样本

对照样本交换 A 与 B。观察新增与删除的方向、修改前后值如何反转;没有差异时交换仍无差异。

查看对照输入
{
  "ok": true,
  "data": {
    "tasks": [
      {
        "taskId": "demo-inserted",
        "taskName": "新增演示记录",
        "progress": 0,
        "retryable": true,
        "state": "queued",
        "execution": {
          "worker": "worker-a",
          "steps": [
            "prepare",
            "export"
          ]
        }
      },
      {
        "taskId": "demo-jobs-1",
        "taskName": "演示导出任务",
        "progress": 0,
        "retryable": true,
        "state": "queued",
        "execution": {
          "worker": "worker-a",
          "steps": [
            "prepare",
            "export"
          ]
        }
      },
      {
        "taskId": "demo-jobs-2",
        "taskName": "演示清理任务",
        "progress": 65,
        "retryable": false,
        "state": "running",
        "execution": {
          "worker": "worker-b",
          "steps": [
            "scan"
          ]
        }
      }
    ],
    "summary": {
      "total": 2,
      "note": null
    }
  }
}
{
  "ok": true,
  "data": {
    "tasks": [
      {
        "taskId": "demo-jobs-1",
        "taskName": "演示导出任务",
        "progress": 0,
        "retryable": true,
        "state": "queued",
        "execution": {
          "worker": "worker-a",
          "steps": [
            "prepare",
            "export"
          ]
        }
      },
      {
        "taskId": "demo-jobs-2",
        "taskName": "演示清理任务",
        "progress": 65,
        "retryable": false,
        "state": "running",
        "execution": {
          "worker": "worker-b",
          "steps": [
            "scan"
          ]
        }
      }
    ],
    "summary": {
      "total": 2,
      "note": null
    }
  }
}

对照样本的实际结果

[
  {
    "op": "replace",
    "path": "/data/tasks/0/taskId",
    "oldValue": "demo-inserted",
    "value": "demo-jobs-1"
  },
  {
    "op": "replace",
    "path": "/data/tasks/0/taskName",
    "oldValue": "新增演示记录",
    "value": "演示导出任务"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/taskId",
    "oldValue": "demo-jobs-1",
    "value": "demo-jobs-2"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/taskName",
    "oldValue": "演示导出任务",
    "value": "演示清理任务"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/progress",
    "oldValue": 0,
    "value": 65
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/retryable",
    "oldValue": true,
    "value": false
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/state",
    "oldValue": "queued",
    "value": "running"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/execution/worker",
    "oldValue": "worker-a",
    "value": "worker-b"
  },
  {
    "op": "replace",
    "path": "/data/tasks/1/execution/steps/0",
    "oldValue": "prepare",
    "value": "scan"
  },
  {
    "op": "remove",
    "path": "/data/tasks/1/execution/steps/1",
    "oldValue": "export"
  },
  {
    "op": "remove",
    "path": "/data/tasks/2",
    "oldValue": {
      "taskId": "demo-jobs-2",
      "taskName": "演示清理任务",
      "progress": 65,
      "retryable": false,
      "state": "running",
      "execution": {
        "worker": "worker-b",
        "steps": [
          "scan"
        ]
      }
    }
  }
]