介绍

JsonPath是一种能够提取部分JSON文档属性、对象、数组的语法，支持条件过滤、数学运算、字符串处理等功能。JsonPath与JSON文档就像 XPath 表达式与 XML 文档结合使用一样。

由于 JSON 结构通常是匿名的，并不一定和XML一样具有"根成员对象"，因此 JsonPath假定分配$给外层对象的抽象名称。JsonPath由用点分隔的表达式段(操作符)组成。操作符可以是一个简单的词，如 JSON 值名称、*，也可以是括在方括号 [ ] 中的更复杂的构造。括号段前的分隔点是可选的，也可以省略。下面是几种JsonPath的提取JSON文档内容语法：

JsonPath	描述
$.object.name	返回object.name的内容。
$.object['name']	返回object.name的内容。
$.object.['name']	返回object.name的内容。
$.object.history.length()	返回object.history数组元素的个数。
$[?(@.name == 'Object')].price.first()	返回第一个名为'Object'的对象的价格字段。
$[?(@.price > 10)].length()	返回price大于10的对象个数。

Jayway JsonPath是Stefan Goessner JsonPath的Java实现，是用于读取JSON文档的Java DSL。本文主要通过Jayway JsonPath来简单介绍JsonPath的使用语法，通过真实报文案例来进行操作。

支持的操作符

操作符	描述
`	操作符
---	---
查询的根节点对象，表示一个json的数据，可以是对象或数组
`@`	当前节点对象
`*`	通配符，获取所有节点
`..`	递归查找，查找所有层次的属性值
`<name>`	按名称匹配对象属性。
`.<name>`	按照名称查找子节点
`['<name>','<name>',...]`	可用查找多个节点
`[<number>,<number>,...]`	按索引匹配数组元素，可同时查找多个数组元素
`[start:end]`	按定义的范围匹配数组元素:

<start>- 要匹配的第一个索引（包括）。如果未指定，则匹配从头开始的所有数组元素。如果为负数，则指定从数组末尾开始的偏移量。
<end>- 要匹配的最后一个索引（不包括）。如果未指定，则匹配所有数组元素到最后。如果为负数，则指定从数组末尾开始的偏移量。 | | [?(<expression>)] | 过滤表达式可匹配对象/数组元素,表达式的结果必须为布尔值 |

可以通过在 JSONPath 中添加 ~ 后缀来提取匹配的元素名称。它返回匹配对象的名称或匹配数组项的字符串格式的索引。

过滤操作符

操作符	描述
==	等于
!=	不等于
<	小于
<=	小于或等于
>	大于
>=	大于或等于
=~	匹配正则表达式 [?(@.name =~ /foo.*?/i)]
in	包含 [?(@.size in ['S', 'M'])]
nin	不包含
subsetof	子集 [?(@.sizes subsetof ['S', 'M', 'L'])]
anyof	交集 [?(@.sizes anyof ['M', 'L'])]
noneof	不是交集 [?(@.sizes noneof ['M', 'L'])]
size	左侧（数组或字符串）的大小应与右侧匹配
empty	左侧（数组或字符串）应该为空

支持的函数

可以在JsonPath表达式执行后进行调用，其输入值为表达式的结果。函数的输出看具体某个函数的含义。

函数	描述	返回值类型
min()	数值类型数组最小值	Double
max()	数值类型数组最大值	Double
avg()	数值类型数组平均值	Double
stddev()	数值类型数组标准差	Double
length()	数组长度	Integer
sum()	数值类型数组求和	Double
keys()	提取匹配的元素名称与`~`操作符功能一致	`Set<E>`
concat(X)	拼接	与入参相同
append(X)	把元素添加到JsonPath输出的数组中	与入参相同
first()	数组中的第一个元素	数组中元素类型
last()	数组中的最后一个元素	数组中元素类型
index(X)	提供索引为X的数组的元素，如果X为负数，则从后往前取	数组中元素类型

用一个复杂的接单报文来演示

https://jsonpath.com，这个在线网站可以用来验证JsonPath表达式，但是不支持函数，函数可以通过java代码来验证。

复制代码

String json ="{.....}";
Object read = JsonPath.read(json, "$..price.min()");
System.out.println(read);

示例报文