snack4-jsonpath v4.0.2 发布

基于jdk8。支持：Json Dom 的构建、编码解转换、获取、JsonPath 查询、JsonSchema 验证。

<dependency>
  <groupId>org.noear</groupId>
  <artifactId>snack4-jsonpath</artifactId>
  <version>4.0.2</version>
</dependency>

Snack-Jsonpath 借鉴了 Javascript 所有变量由 var 申明，及 Xml dom 一切都是 Node 的设计。其下一切数据都以ONode表示，ONode也即 One node 之意，代表任何类型，也可以转换为任何类型。

• 强调文档树的构建和操控能力
• 高性能Json path查询（比 jayway.jsonpath 快很多倍）。同时兼容 jayway.jsonpath 和 IETF JSONPath (RFC 9535) 标准 (用 options 切换)。为下一个十年提供强劲的 JsonPath 体验。
• 支持 Json schema 架构校验
• 支持 json5 部分特性（无键字段，注释，等…）
• 优先使用 无参构造函数 + 字段 编解码（可减少注入而触发动作的风险）

依赖包清单：

依赖包	描述
org.noear:snack4	提供 json dom 构建和编解码支持
org.noear:snack4-jsonpath	提供 json path 查询支持
org.noear:snack4-jsonschema	提供 json schema 校验支持

开源项目仓库地址：

• https://gitee.com/noear/snack-jsonpath
• https://github.com/noear/snack-jsonpath

文档资料：

• https://solon.noear.org/article/snack

1、版本更新说明

• 添加 ONodeCreator 静态方法的支持（普通类）
• 添加 ONodeAttr:ignore 注解属性支持
• 添加 Write_BooleanAsNumber 新特性
• 添加 Read_UseBigDecimalMode 新特性
• 添加 Read_UseBigIntegerMode 新特性
• 添加 Write_BigDecimalAsPlain 特性
• 添加 DecodeContext:hasFeature, EncodeContext:hasFeature 新特性
• 调整 ONode:nodeType,getType 合并为 type() 与 options() 保持相同风格
• 调整 QueryContext:isInFilter 更名为 isFiltered()
• 调整 Write_BigNumbersAsString 更名为 Write_DoubleAsString
• 优化 Write_Nulls 完善对 Map 输出的控制
• 优化 Write_BrowserCompatible 写入性能
• 优化 与 snack3 的效果兼容性

2、JSONPath 语法参考

语法元素	描述
$	根节点标识符
@	当前节点标识符（仅在过滤选择器中有效）
[<selectors>]	子段：选择节点的零个或多个子节点
.name	简写 ['name']
.*	简写 [*]
..[<selectors>]	后代段：选择节点的零个或多个后代
..name	简写 ..['name']
..*	简写 ..[*]
'name'	名称选择器：选择对象的命名子对象
*	通配符选择器：选择节点的所有子节点
3	索引选择器：选择数组的索引子项（从 0 开始）
0:100:5	数组切片选择器：数组的 start:end:step
?<logical-expr>	过滤选择器：使用逻辑表达式选择特定的子项
fun(@.foo)	过滤函数：在过滤表达式中调用函数（IETF 标准）
.fun()	聚合函数：作为片段使用（jayway 风格）

过滤选择器语法参考：

语法	描述	优先级
(...)	分组	5
name(...)	函数扩展	5
!	逻辑 非	4
==,!=,<,<=,>,>=	关系比较符	3
&&	逻辑 与	2
||	逻辑 或	1

IETF JSONPath (RFC 9535) 标准定义操作符（支持）

操作符	描述	示例
==	左等于右（注意1不等于’1’）	$[?(@.a == 1)]
!=	左不等于右	$[?(@.a != 1)]
<	左比右小	$[?(@.a < 1)]
<=	左小于或等于右	$[?(@.a <= 1)]
>	左大于右	$[?(@.a > 1)]
>=	左大于等于右	$[?(@.a >= 1)]

jayway.jsonpath 增量操作符（支持）

操作符	描述	示例
=~	左匹配正则表达式	[?(@.s =~ /foo.*?/i)]
in	左存在于右	[?(@.s in ['S', 'M'])]
nin	左不存在于右
subsetof	左是右的子集	[?(@.s subsetof ['S', 'M', 'L'])]
anyof	左与右有一个交点	[?(@.s anyof ['M', 'L'])]
noneof	左与右没有交集	[?(@.s noneof ['M', 'L'])]
size	左（数组或字符串）的大小应该与右匹配	$[?(@.s size @.expected_size)]
empty	Left（数组或字符串）应该为空	$[?(@.s empty false)]

IETF JSONPath (RFC 9535) 标准定义函数（支持）

函数	描述	参数类型	结果类型
length(x)	字符串、数组或对象的长度	值	数值
count(x)	节点列表的大小	节点列表	数值
match(x,y)	正则表达式完全匹配	值，值	逻辑值
search(x,y)	正则表达式子字符串匹配	值，值	逻辑值
value(x)	节点列表中单个节点的值	节点列表	值

jayway.jsonpath 函数（支持）

函数	描述	输出类型
length()	字符串、数组或对象的长度	Integer
min()	查找当前数值数组中的最小值	Double
max()	查找当前数值数组中的最大值	Double
avg()	计算当前数值数组中的平均值	Double
stddev()	计算当前数值数组中的标准差	Double
sum()	计算当前数值数组中的总和	Double
keys()	计算当前对象的属性键集合	Set<E>
concat(X)	将一个项或集合和当前数组连接成一个新数组	like input
append(X)	将一个项或集合 追加到当前路径的输出数组中	like input
first()	返回当前数组的第一个元素	依赖于数组元素类型
last()	返回当前数组的最后一个元素	依赖于数组元素类型
index(X)	返回当前数组中索引为X的元素。X可以是负数（从末尾开始计算）	依赖于数组元素类型