热门搜索:
您现在的位置是：首页 > 文章详情

🔥 snack4-jsonpath v4.0.2 发布

日期：2025-10-24点击：47

提供 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 部分特性（无键字段，注释，等...）
  • 优先使用 无参构造函数 + 字段 编解码（可减少注入而触发动作的风险）
  • 支持 java8 到 java25

依赖包清单：

依赖包 描述
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💯5 数组切片选择器：数组的 start🔚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可以是负数（从末尾开始计算） 依赖于数组元素类型

 

原文链接：https://www.oschina.net/news/379213/snack4-jsonpath-4-0-2-released
关注公众号

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。

持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

转载内容版权归作者及来源网站所有，本站原创内容转载请注明来源。

相关文章

    文章评论

    共有0条评论来说两句吧...

    文章二维码

    扫描即可查看该文章

    点击排行

    推荐阅读

    最新文章