SpreadJS 的 JSON 结构

公开模式描述了SpreadJS JSON 数据格式，使 SpreadJS JSON 数据清晰易读，对人类和机器可读的文档有用，并提供完整的结构验证，这对于使用代码生成 SpreadJS JSON 数据非常有用，自动测试和 JSON 数据验证。

参考以下 JSON Schema

有关JSON模式的更多信息，请参见json-schema.org网站。

JSON模式文档可用于检查JSON数据是否有效。您还可以根据JSON模式创建有效的JSON数据。

这是JSON模式的基本示例：

{
  "title": "LineBorder",
  "description": "Indicates the color of the border line. Use a known color name or HEX style color value. The default value is black.",
  "type": "object",
  "properties": {
    "color": {
      "type": "string",
      "default": "black"
    },
    "style": {
      "$ref": "#/definitions/LineStyle",
      "default": 0
    }
  }
}

有关使用主题验证器的信息，请访问此网站，http://json-schema.org/implementations.html。在网站中,https://json-schema-validator.herokuapp.com, 具有在线验证器，可用于根据JSON模式文档检查JSON数据。

您可以使用SpreadJS JSON Schema文档来验证SpreadJS JSON数据。

以下步骤使用json-schema-validator验证SpreadJS JSON数据。

验证部分JSON数据。
例如，您有2个“ NameInfo” JSON数据，并且您想知道它们是否均为有效JSON数据。

{
"name":"name1",
"row":4,
"column":3,
"formula":"=SUM(A1,A3)"
}

{
"name":"name1",
"row":"4",
"column":3,
"formula":"=SUM(A1,A3)"
}

您可以按照以下方式获取“ NameInfo”的JSON模式文档：

{
  "title": "NameInfo",
  "description": "Represents a custom named expression that can be used by formulas.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "row": {
      "type": "integer",
      "minimum": 0
    },
    "col": {
      "type": "integer",
      "minimum": 0
    },
    "formula": {
      "type": "string"
    },
    "comment": {
      "type": "string"
    }
  }
}

使用JSON模式验证JSON数据。 “ jsonData2”无效。其属性“行”的类型应为“整数”。

JSON模式引用另一个JSON模式。例如，以下JSON架构引用了另一个JSON架构“ LineStyle”。

{
"title" : "LineBorder",
"description" : "Indicates the color of the border line. Use a known color name or HEX style color value. The default value is black.",
"type" : "object",
"properties" : {
    "color" : {
        "type" : "string",
        "default" : "black"
    },
    "style" : {
        "$ref" : "#/definitions/LineStyle",
        "default" : "LineStyle.empty"
    }
}
}

如果要验证“ LineBorder”的JSON数据，请使用完整的“ LineBorder” JSON架构。

{
"title" : "LineBorder",
"description" : "Indicates the color of the border line. Use a known color name or HEX style color value. The default value is black.",
"type" : "object",
"properties" : {
    "color" : {
        "type" : "string",
        "default" : "black"
    },
    "style" : {
        "$ref" : "#/definitions/LineStyle",
        "default" : "LineStyle.empty"
    }
},
"definitions":{
    "LineStyle":{
       "title":"LineStyle",
       "description":"Specifies the line drawing style for the border. empty:0,thin:1,medium:2,dashed:3,dotted:4,thick:5,double:6,hair:7,mediumDashed:8,dashDot:9,mediumDashDot:10,dashDotDot:11,mediumDashDotDot:12,slantedDashDot:13.",
       "enum":[0,1,2,3,4,5,6,7,8,9,10,11,12,13]
    }
}
}

验证完整的JSON数据。您可以使用完整版JSON Schema来验证SpreadJS完整版JSON数据。