基于jdk8。支持:Json Dom 的构建、编码解转换、获取、JsonPath 查询、JsonSchema 验证。
xml
<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 校验支持 |
开源项目仓库地址:
文档资料:
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 |
` | ` |
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可以是负数(从末尾开始计算) | 依赖于数组元素类型 |