相关工具与范例

『工具 ＞ 编码 ＞ JSON / table 互转』 『范例 ＞ Web 应用 ＞ JSON 』 『范例 ＞ Web 应用 ＞ REST ＞ jsonClient』

aardio / JSON 类型转换要点

一、区分空对象与空数组

在 aardio 中对象与数组的数据类型都是 "table"。 所以在 aardio 中空对象与空数组都是 {} 。

对于 web.json，{} 总是被处理为空对象。 使用 table.array() 则可以创建 JSON 兼容的空数组。 web.json 也会将 JSON 中的 "[]" 解析为 table.array() 创建的空数组。

aardio 通常会在表的 _type 元属性中指定一个表是否数组。 例 table.array() 创建的空数组是这样 { @{_type="array"}}。 或者长度非 0 的数组也会被视为数组，例如 { 1,2,3 } 。

但还有很多其他来源的数组（例如 COM 数组，封装外部对象的数组）并不一定符合上面的规则。 web.json 使用 table.type() 函数来检测一个表是否应当被处理为数组。 详细规则请查看 table.type() 函数的说明。

也可以使用 web.json.stringifyArray("{}") 得到 "[]"。 web.json.stringifyArray 总是将参数视为数组处理。

二、保存对象的 null 值。

在 aardio 中 null 是一个不存在的值。 例如 { name = null } 等价于空表 {} 。

而在 JSON 中我们有时候需要保存 null 值。 这在 aardio 中很困难，但我们可以解决这个问题。

例如以下 aardio 代码：

//定义 JSON
var json = "{name:null,age:22}";

//解析为对象
var object = web.json.parse(json);

//生成 JSON 
var json = web.json.stringify(object);

可以正确的保存 name 的 null 值。

aardio 通过在元表的 _defined 字段中指定必须保存 null 值的字段名。 可以调用 table.define() 定义需要保留 null 值的键名（可以重复调用以添加键名）。 web.json 或 table.eachName 支持 _defined 元属性。

三、时间 与 buffer 对象

buffer,time 对象与 JS 一样只负责字符串化，不负责在解析 JSON 时自动还原。

时间对象与 JS 语言相同转换为 ISO8601 格式字符串， 可使用 time.iso8601 函数解析并还原 iso8601 格式的时间对象。

buffer 类与 node.js 中的 Buffer 类相同,转换结果示例： {"data":[230,181,139],"type":"Buffer"} 其中 type 指明类型,data 为 buffer 字节数组的值。 这种表可以作为 raw.buffer 的唯一参数快速还原为 buffer 类型。

aardio-json 扩展标准

发布日期：2020-12-27

JSON 字符串化时完全符合 JSON 官方标准( https://json.org/json-zh.html )。 JSON 解析时完全支持 JSON，JSONP，并使用宽松的原则兼容JSON5，兼容部分类 YAML 语法。

aardio-json 以“宽进严出、简洁高效”为基本原则。 解析时规则尽可能宽松容错，生成 JSON 字符串则严格遵守标准JSON规则。 为了让解析器尽可能做到简洁高效，所以 aardio-json 不支持变量， 真正简洁高效的配置文件不应当出现重复的内容，JSON 的目标也不是成为编程语言。

一、可省略和替换的格式标记 1、允许省略根节点对象外部的 {} 2、允许使用分号、空格、换行替代元素分隔符"," 3、允许使用等号、空格、换行替代对象键值分隔符":" 4、允许省略字符串外部的引号。

二：根节点 1、JSON根节点可以是任意数据类型，单个字符串、数值都可以解析并返回值。 2、根节点是对象时，可以省略外层的花括号。 3、根节点是字符串时不可省略引号。 4、根节点解析成功的 JSON 后面如果还有多余的文本时忽略。 5、根节点兼容 JSONP 格式

三、字符串 字符串置于双引号中时支持JSON转义符。 字符串置于单引号中时不支持JSON转义符，单引号中可使用2个单引号表示原始单引号。 字符串可以在引号内部时可以换行。

要特别注意原生的 aardio 字符串解析语法正好跟上面相反： 单引号中是转义字符串，而双引号内是非转义字符串。

JSON 字符串可省略首尾引号，此时不支持JSON转义符，遇到回车或换行、逗号、中括号、大括号时字符串结束解析。 字符串作为对象键名如果省略引号时不能包含空白字符、换行或键值分隔符。

四、注释 1、支持 // 或 # 引导的单行注释 2、支持包含于 /*......*/ 内的块注释（注意这里按js规则不匹配首尾星号数目）。

五、数值 数值支持16进制

六、null值 可以使用null,undefined,~ 表示null值。

七、日期时间

可使用 ISO 8601 格式表示日期时间，合法的格式如下： 2021-01-1 2021-02-1T15:02:31+08:00 2021-02-1T15:02:31+08:00Z

数字前可不用补0，但日期分隔符必须使用短横线，时间分隔符必须使用冒号， 尾部时区不可以包含空白字符，但可以包含 +-: 等字符以及数字、字母。