如何在 Java 中使用 JsonPath 正确筛选嵌套数组中的对象字段

云伟小哥_9096

云伟小哥_9096

2026-04-11

896人浏览

原创

如何在 Java 中使用 JsonPath 正确筛选嵌套数组中的对象字段

本文详解使用 JsonPath 在多层嵌套结构(如对象→数组→对象→数组)中精准筛选字段的方法,重点纠正 in 运算符的常见误用,并提供可直接运行的 Java 示例与关键注意事项。

本文详解使用 jsonpath 在多层嵌套结构(如对象→数组→对象→数组)中精准筛选字段的方法,重点纠正 `in` 运算符的常见误用,并提供可直接运行的 java 示例与关键注意事项。

在 Java 开发中,借助 JsonPath 解析复杂 JSON 并提取特定条件的数据是高频需求。但当目标字段位于「对象 → 数组 → 对象 → 字符串数组」这类深层嵌套路径中(例如从 none2b_references__cr 数组中找出 source__c 包含 "nci__c" 的项,并取其 case_identifier__c 值),初学者常因语法理解偏差导致表达式返回空结果。

核心误区在于 in 过滤器的语义:in 要求左侧为单值,右侧为数组。而错误写法 $..[?(@.source__c in ['nci__c'])] 将数组 @.source__c 放在了左侧,违反了 JsonPath 规范,因此匹配失败。

✅ 正确的 JsonPath 表达式应为:

$..case_version__v.case_number__vr.none2b_references__cr[?('nci__c' in @.source__c)].case_identifier__c

该表达式明确将字面量 'nci__c' 作为左操作数,@.source__c(即当前对象的 source__c 字段,其值为 ["nci__c"])作为右操作数,从而正确触发“成员存在性”判断。

JavaScript 测试模式
JavaScript 测试模式

使用 Jest、Vitest 和 Testing Library 实施全面的测试策略,包括单元测试、集成测试和端到端测试,涵盖模拟、测试夹具和测试驱动开发。在编

下载

以下是完整、可运行的 Java 示例(需引入 com.jayway.jsonpath:json-path:2.9.0):

import com.jayway.jsonpath.Configuration;
import com.jayway.jsonpath.DocumentContext;
import com.jayway.jsonpath.JsonPath;
import com.jayway.jsonpath.Option;

import java.util.List;

public class JsonPathFilterExample {
    public static void main(String[] args) {
        String json = """
            {
              "case_version__v": {
                "case_number__vr": {
                  "id": "V2A000000001002",
                  "none2b_references__cr": [
                    {
                      "case_number__c": "V2A000000001002",
                      "case_identifier__c": "THIS-IS-MINE",
                      "id": "V8C000000001001",
                      "source__c": ["nci__c"]
                    }
                  ]
                }
              }
            }
            """;

        // 启用 ALWAYS_RETURN_LIST 避免单结果返回 String 而非 List,便于统一处理
        Configuration config = Configuration.defaultConfiguration()
                .addOptions(Option.ALWAYS_RETURN_LIST);

        DocumentContext ctx = JsonPath.parse(json, config);
        JsonPath path = JsonPath.compile(
            "$..case_version__v.case_number__vr.none2b_references__cr[?('nci__c' in @.source__c)].case_identifier__c"
        );

        List<string> results = ctx.read(path, List.class);
        System.out.println(results); // 输出: [THIS-IS-MINE]
    }
}</string>

⚠️ 注意事项:

  • 若 source__c 可能为 null 或非数组类型,建议添加安全检查,例如改用 @.source__c && 'nci__c' in @.source__c;
  • JsonPath 的 in 不支持通配符或正则,仅用于精确成员匹配;如需模糊匹配(如前缀、包含子串),需配合 filter() 自定义函数或在 Java 层后处理;
  • 使用 ALWAYS_RETURN_LIST 选项可避免单元素时返回 String 导致 ClassCastException,提升健壮性;
  • 多层 ..(Deep Scan)虽方便,但在大型 JSON 中可能影响性能,生产环境建议尽可能使用确定路径(如 $['case_version__v']['case_number__vr']['none2b_references__cr'])。

掌握 in 运算符的方向性语义,结合路径精度与配置优化,即可高效、可靠地从任意深度嵌套 JSON 中提取符合业务逻辑的结构化数据。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12837

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9922

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8412

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1616

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3349

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20591

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1455

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习