测试环境
JMeter 5.4.1
插件介绍
JSON后置处理器(PostProcessor)允许使用 JSON Path 法从JSON格式的响应中提取数据。类似正则表达式提取器,必须位于HTTP采样器、或者其它可以返回JSON数据的采样器下,作为子结点。
插件参数
Name
显示在脚本树结构中的名称
Apply to:
这用于可以生成子采样器的采样器,比如携带嵌套资源的HTTP采样器、邮件读取器或者由事务控制器控制的采样。
- Main sample only
仅适用于主采样 - Sub-samples only
仅适用于子采样 - Main sample and sub-samples
适用于主采样和子采样 - JMeter Variable Name to use
提取适用于命名变量的内容。
Names of created variables
由英文分号 ;分隔的变量名称,这些变量分别用于存储对应JSON-PATH表达提取的结果(必须匹配JSON-PATH表达式数量)。
JSON Path Expressions
由分号分号 ;分割的JSON-PATH表达式 (必须匹配变量的数量)
Default Values
如果对应变量的JSON-PATH表达式不返回任何结果时,对应变量的默认值,由英文分号 ;分隔(必须匹配变量的数量)
Match Numbers
对于每个JSON-PATH表达式,如果表达式查询到多个结果时,你可以选择提取那个值作为变量值。
- 0表示随机(匹配数字的默认值)
- -1提取所有结果,这些结果将存储到名为
<variable name>_N
的变量(N取值从1到提取结果的数量) - X表示提取第X个结果。如果第X个结果不存在,则不会返回任何值,直接使用对应默认值作为变量。
这些匹配数字必须使用英文分号相隔,且匹配JSON-PATH表达式的数量。如果不配置匹配数字,默认使用0作为每个表达式的默认值。
注意:不管对应的JSON-PATH表达式能否查询到结果,程序都会将结果数(如果查询不到结果则设置为 0 )存储到变量 <variable name>_matchNr
中
Compute concatenation var
如果勾选,则表示如果对应表达式查询到多个结果,插件将使用 , 连接这些值并存储为命名为<variable name>_ALL
的变量中。
插件使用示例
其中登录请求返回类似如下信息
通过Debug PostProcessor观察到提取的相关变量值如下
JSON-PATH表达式介绍
JsonPath表达式可以使用点标记
$.store.book[0].title
或者括号标记
$['store']['book'][0]['title']
操作符
操作符 | 描述 |
| 需要查找的根元素。所有JSON PATH表达式都以这个开头 |
| 正被某个过滤谓词处理的当前节点(The current node being processed by a filter predicate) |
| 通配符。可以表示一个名称或者数字 |
| 深度扫描。可以表示一个名称 |
| 获取子节点。 |
| 括号标记的子结点或者子孙结点 |
| 单个或多个数组索引。 |
| 数组切片操作符。注意,不含end |
| 过滤表达式,必须为boolean表达式 |
函数
可以在path表达式末尾调用函数--表达式输出即为函数的输入。常见函数如下
函数 | 描述 | 输出类型 |
min() | 获取数字数组的最小值。 | Double |
max() | 获取数字数组的最大值。 | Double |
avg() | 获取数字数组的平均值。 | Double |
stddev() | 获取数字数组的标准方差。 | Double |
length() | 获取数组长度 | Integer |
sum() | 获取数字数组的总和。 | Double |
append(X) | 添加一个元素到JSON-PATH表达式输出数组中 | 同输入 |
过滤器操作符
过滤器为用于过滤数组的逻辑表达式,一个典型的过滤器 [?(@.age > 18)]
,这里 @
代表正被处理的当前项。可以使用逻辑操作符 &&
和 ||
创建更复杂的过滤器。字符串文字必须用单引号或者双引号引起来,形如 ([?(@.color == 'blue')]
或者 [?(@.color == "blue")]
)
操作符 | 描述 |
| 等于 |
| 不等于 |
| 小于 |
| 小于等于 |
| 大于 |
| 大于等于 |
| 匹配正则表达式,形如 |
| 包含于,形如 |
| 不包含于 |
| 子集,形如 |
| 操作符左侧值必须和右侧有交集(left has an intersection with right),形如 |
| 操作符左侧值和右侧无交集 |
| 操作符左侧数组或者字符串长度必须匹配右侧 |
| 操作符左侧必须为空数组或者字符串 |
JSON PATH示例
给定如下json
{
"store": {
"book": [
{
"category": "reference",
"author": "Nigel Rees",
"title": "Sayings of the Century",
"price": 8.95
},
{
"category": "fiction",
"author": "Evelyn Waugh",
"title": "Sword of Honour",
"price": 12.99
},
{
"category": "fiction",
"author": "Herman Melville",
"title": "Moby Dick",
"isbn": "0-553-21311-3",
"price": 8.99
},
{
"category": "fiction",
"author": "J. R. R. Tolkien",
"title": "The Lord of the Rings",
"isbn": "0-395-19395-8",
"price": 22.99
}
],
"bicycle": {
"color": "red",
"price": 19.95
}
},
"expensive": 10
}
JsonPath | 结果 |
| 表示所有书籍的作者。 |
| 表示所有作者 |
| 所有东西--所有书籍和自行车。 |
| 所有东西的价格 |
| 第三本书 |
| 倒数第二本书 |
| The first two books |
| 索引为0到2(不含2)的所有书籍 |
| 索引为1到2(不含2)的所有书籍 |
| 最后两本书 |
| 索引为2及其往后的所有书籍。 |
| 携带isbn号的所有书籍 an ISBN number |
| 商店中价格低于10的所有书籍。 |
| 所有非 "expensive"的书籍 |
| 所有匹配正则表达式(忽略大小写)的书籍 |
| 返回所有东西 |
| 书籍数量 |