JSON是一种容易理解的结构化数据格式，它经常以一个大字符串的形式在各种计算机语言中传递信息，SPL语言提供了json()函数加载/生成JSON，加载成序表、序列对象后，就方便做计算了。

加载JSON数据

JSON中有数组、对象、数值、字符串、布尔值(true、false)以及表示空值的null，SPL和JSON的对象及数据类型能比较好的对应起来。

基本数据类型

JSON里其它基本数据类型在SPL中都能直接对应上，A1中的定义了一个JSON字符串(SPL单元格中，用单引号开头定义字符串)，各种类型的数据组成一个JSON数组：

	A
1	'["v1",66,true,false,null]
2	=json(A1)

JSON中没有专门的日期时间类型，传递日期时间数据时，可能是任意格式的格式化字符串，或数值类型的毫秒数：

	A
1	'["string","2021-01-02","2021/01/03   12:15",1632627573336,66]
2	=json(A1)

SPL中需要日期时间类型时，可以把加载进来的格式化字符串、数值用date()、datetime()等函数进行转换：

	A
3	=[date(A2(2)),   datetime(A2(3),"yyyy/MM/dd HH:mm"), date(A2(4))]

 

数组

上例中各种类型数据是放在一个JSON数组中，如下A1再定一个等差数列的JSON数组

	A
1	'[11,13,15,17]
2	=json(A1)

对象

如下A1是一个JSON对象：

	A
1	'{"n1":"v1","n2":"v2","n3":"v3"}
2	=json(A1)

它加载成了一个单行的序表对象：

对象数组

很自然的，多个JSON对象组成一个数组后，就会加载成一个多行的序表对象：

	A
1	'[{"n1":"v1","n2":"v2","n3":"v3"},   {n1:"v4",n2:"v5",n3:"v6"}, {"n1":"v7","n2":"v8","n3":"v9"}]
2	=json(A1)

另外，注意第二行的属性名没有双引号，这不符合JSON规范，但没按错误处理，也能正常解析出属性名：

 

不同结构对象数组

JSON数组中的多个对象，可能是异构的，第一个对象里没有n3属性，第二个对象里没有n1属性，第三个对象里没有n2属性：

	A
1	'[{n1:"v1",n2:"v2"},{n2:"v5",n3:"v6"},{n1:"v7",n3:"v9"}]
2	=json@t(A1)

这种情况转换成序表时，会以所有JSON对象属性的合集为结构。JSON对象中缺失的值补为null，这样规范处理后，有利于后续计算。

嵌套数组及对象

JSON数组中的元素不限制数据类型，甚至可以是嵌套的数组、对象：

	A
1	'[[1,2,3],{"n1":"v1","n2":"v2","n3":"v3"},"v1",66,true,null]
2	=json(A1)

序列同样也支持混合类型，第一个元素同样是序列，第二个元素是序表：

 

同理，JSON对象中的属性值，同样也可以嵌套数组、对象：

	A
1	'{"n1":"v1","n2":[1,2,3],"n3":{"n31":"v31","n32":"v32","n33":"v33"}}
2	=json(A1)

数组、对象灵活嵌套后，形成多级结构化数据，JSON和SPL都容易表达它们。

生成JSON字符串

加载的反向操作是生成JSON字符串，SPL中仍然用json()函数实现它，A2中把A1的JSON字符串加载成SPL对象；A3中把A2的SPL对象再转换回JSON字符串，json()函数判断传入参数的类型，会自动的选择正确的转换动作(传入JSON字符串时，转换成SPL对象；传入SPL对象时，转换成JSON字符串)。

	A
1	'[[1,2,3],{"n1":"v1","n2":"v2","n3":"v3"},"v1",66,true,null]
2	=json(A1)
3	=json(A2)

执行后，观察A3的值，能看到是和A1一样的JSON字符串：

[[1,2,3],{"n1":"v1","n2":"v2","n3":"v3"},"v1",66,true,null]

 

下面看生成JSON字符串时，SPL对象与JSON对象的对应关系。

基本数据类型

	A
1	=["str",22,true,false,null,date(2021,9,18)]
2	=json(A1)

A1生成的SPL序列中，除了JSON支持的基本数据类型外，最后还有一个日期类型，转成JSON字符串时，它会被格式化成字符串类型：

 

数组

A1生成一个SPL序列，A2用json()函数把它生成JSON字符串

	A
1	=["a","b","c"]
2	=json(A1)

对象

A1创建了以n1，n2，n3为结构的空序表，A2向A1中插入两条数据

	A
1	=create(n1,n2,n3)
2	>A1.insert(0,"v1","v2","v3"),A1.insert(0,"v4","v5","v6")
3	=json(A1(2))

A1中的每一条记录对应一个JSON对象，A3中把第二条记录转换成JSON字符串

 

对象数组

把SPL序列、序表写出时，会转成JSON数组，以上一节的序表为例，A3中把整个序表写出，最终结果是JSON对象数组

	A
1	=create(n1,n2,n3)
2	>A1.insert(0,"v1","v2","v3"),A1.insert(0,"v4","v5","v6")
3	=json(A1)

 

嵌套数组及对象

	A
1	=create(n1,n2,n3)
2	>A1.insert(0,"v1","v2","v3")
3	=create(f1,f2)
4	>A3.insert(0,22,A1)
5	=json(A3)

A3中生成如下嵌套的序表：

A5中生成如下JSON字符串：

格式化一下就看的更清楚，即便内外两层序表中都只有一行数据，都生成了数组：

[{

         "f1": 22,

         "f2": [{

                  "n1": "v1",

                  "n2": "v2",

                  "n3": "v3"

         }]

}]

有时期望这种单行的直接生成如下的对象，而非对象数组，把序表换成记录就可以了(A1、A3是序表，A1(1)、A3(1)是它们的第一条记录)：

{

         "f1": 22,

         "f2": {

                  "n1": "v1",

                  "n2": "v2",

                  "n3": "v3"

         }

}

 

	A
1	=create(n1,n2,n3)
2	>A1.insert(0,"v1","v2","v3")
3	=create(f1,f2)
4	>A3.insert(0,22,A1(1))
5	=json(A3(1))