Skip to content

15_1_13_new_feature.md

Latest commit

 

History

History
85 lines (52 loc) · 3.42 KB

15_1_13_new_feature.md

File metadata and controls

85 lines (52 loc) · 3.42 KB
Raw

1.3.x 新特性

上一页 | 总目录 | 下一页

不再默认转义 % 字符

在 v1.2.x 及以前版本中，jsonvalue 当遇到 % 字符时会进行转义，但这并不是标准 JSON 的做法。从 v1.3.0 开始，jsonvalue 不再默认转义 % 字符。

如有需要继续转义 %，可以给作者提 issue。

支持与原生 json 的导入/导出

参见 与原生 json 的导入/导出 小节。这个功能在 v1.2 中是 beta 功能，在本版本中正式提供。

支持类泛型操作

在 v1.2 及之前版本中，往 *V 类型中添加子成员时，需要明确指定类型如：

v.SetString("Hello, JSON!").At("msg")
v.SetInt64(time.Now().Unix()).At("time")

从 v1.3.0 开始，不再需要这么繁琐了，Set 函数支持传入任意可以序列化为 JSON 的值:

v.Set("Hello, JSON!").At("msg")
v.Set(time.Now().Unix()).At("time")

这个特性也可以扩展到其他相关函数中，包括:

  • Append
  • Insert
  • Add

此外，基于该特性，在 v1.3.0 中也新增了 New 函数，实际上相当于 Import 的一个封装。参见 与原生 json 的导入/导出 小节。

支持 JSON 比较

主要是新增了 Equal 函数，用于判断两个 JSON 是否相等。此外在 beta 包中新增了 Contains 函数，也可以用于判断子集。

支持 JSON 序列化缩进

请参见 额外选项配置 的 "可视化缩进" 小节

支持获取 object 类型的键（key）的顺序

请参见 遍历和迭代 的 "获取 object 类型值的原始顺序" 小节

按照 key 被设置的顺序进行 object 的序列化

请参见 额外选项配置 的 "按照原字节流顺序或 key 被设置的顺序序列化" 小节

转义非可视化 ASCII 字符

从 v1.3.1 开始，ASCII 的非可视化字符如果出现在 string 字段（包括 key 和 string 类型的 value）的话，均会进行 \u00XX 转义，防止不合适的展示效果。

支持 MustXxx 方法

从 v1.3.4 开始, jsonvalue 开始支持 MustAdd, MustAppend, MustInsert, MustSet, MustDelete 等方法, 这些方法不返回子值和 error 信息

支持原生库的几个 marshaler 和 unmarshaler 接口

从 v1.3.4 开始, *jsonvalue.V 类型支持以下原生接口:

  • json.Marshaler、json.Unmarshaler
  • encoding.BinaryMarshaler、encoding.BinaryUnmarshaler

请参见 序列化和反序列化 小节