# Java JSONPath 还在硬写遍历？jquick-path 下标、切片、过滤表达式、当前节点实战详解

> 如果你经常在 Java 项目里处理 JSON 数组、条件筛选和局部节点查询，这篇文章会更有价值。本文只讲最常用也最容易写乱的几类语法：下标操作符、数组切片、过滤表达式、当前节点，以及 `@` 在过滤表达式中的实际用法。

## Git 地址

```text
https://github.com/paohaijiao/jquick-path
```

## Maven 坐标

```xml
<dependency>
  <groupId>io.github.paohaijiao</groupId>
  <artifactId>jquick-path</artifactId>
  <version>2.0.0</version>
</dependency>
```

## 一、为什么这几个语法最值得先掌握？

很多人学 JSONPath，先看的是点号访问和根节点。

但真正到了业务代码里，最容易让代码变复杂的，往往不是“怎么进对象”，而是下面这些问题：

- 数组里怎么拿第几个元素；
- 怎么一次取一段数据；
- 怎么从一批数据中筛选符合条件的元素；
- 怎么在过滤时引用当前元素；
- 怎么从当前上下文继续向下取值。

这些问题正好对应本文要讲的五类语法：

1. 下标操作符；
2. 数组切片操作；
3. 过滤表达式；
4. 当前节点；
5. `@` 用于过滤表达式。

从程序员视角看，掌握这五类语法的意义很直接：

- 少写循环；
- 少写 if 判断；
- 少把查询逻辑散落到业务代码；
- 让 JSON 处理更像规则，而不是临时拼装。

## 二、先准备一份统一示例数据

为了让路径写法和 Java 便捷方式能一一对应，本文统一使用下面这份 JSON：

```json
{
  "books": [
    {
      "title": "Book 1",
      "author": "Author 1",
      "price": 10,
      "isbn": false
    },
    {
      "title": "Book 2",
      "author": "Author 2",
      "price": 15,
      "isbn": true
    },
    {
      "title": "Book 3",
      "author": "Author 3",
      "price": 20,
      "isbn": true
    }
  ],
  "extract": {
    "title": "Book 3",
    "author": "Author 3",
    "price": 20
  }
}
```

这份数据足够覆盖：

- 数组取值；
- 数组切片；
- 条件过滤；
- 当前节点引用；
- 对象属性访问。

## 三、五类语法速查表

| 语法场景 | path 写法 | 作用 |
|------|------|------|
| 数组下标 | `$.books[0]` | 获取数组指定位置元素 |
| 下标取属性 | `$.books[2].price` | 获取指定元素的某个字段 |
| 数组切片 | `$.books[0:1:2]` | 获取数组某一段元素 |
| 过滤表达式 | `$.books[?(@.title == 'Book 1')]` | 按条件筛选数组元素 |
| 当前节点 | `@.store.books` | 从当前上下文继续查询 |
| `@` 过滤引用 | `$.books[?(@.price > 15)]` | 在过滤中表示当前元素 |

这张表建议先收藏。后面每一节，都会把 path 写法和 Java 便捷写法对应起来。

## 四、下标操作符：数组里第几个元素，应该怎么拿？

### 4.1 下标操作符解决什么问题？

数组是 JSON 里最常见也最容易让代码变复杂的部分。

如果没有路径语法，程序员通常会这样做：

- 先取出 `books` 数组；
- 再判断索引是否存在；
- 再取第 N 个元素；
- 如果还要拿字段，就继续手动访问属性。

而下标操作符做的事情很明确：**直接定位数组中的某个元素。**

### 4.2 根据 path 路径访问指定下标

如果你想拿到第一本书，可以直接写：

```text
$.books[0]
```

对应 Java 调用：

```java
JSONPathQueryBuilder.from(jsonData)
    .path("$.books[0]")
    .limit(10)
    .execute();
```

如果你想进一步拿到第三本书的价格：

```text
$.books[2].price
```

对应 Java 调用：

```java
JSONPathQueryBuilder.from(jsonData)
    .path("$.books[2].price")
    .limit(10)
    .execute();
```

### 4.3 使用 Java 便捷方式写下标访问

Java 便捷方式里，下标通常通过 `JSubscripts.index()` 配合 `JSubscriptSegment.of()` 表达：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.index(0))))
    .limit(10)
    .execute();
```

如果要继续获取某个字段，例如价格：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSegments.subscript(JIndexSubscript.of(2)))
        .property("price"))
    .limit(10)
    .execute();
```

### 4.4 下标操作符适合哪些场景？

最典型的场景包括：

- 获取第一条或最后一条记录；
- 读取固定顺序数组中的指定元素；
- 从接口返回中快速拿到特定位置对象；
- 结合属性访问拿到目标字段值。

从工程角度看，下标操作符的价值是：**把数组定位动作直接收敛到路径表达式里。**

## 五、数组切片操作：不是取一个，而是取一段

### 5.1 为什么切片很实用？

很多业务场景里，你不是只要一个元素，而是需要一段数组数据。

例如：

- 只想拿前几条；
- 想按照步长取样；
- 想对数组做局部数据处理；
- 想先裁剪一部分结果再继续处理。

这时候，切片会比手动循环更自然。

### 5.2 根据 path 使用数组切片

```text
$.books[0:1:2]
```

这个表达式表示：

- 从索引 `0` 开始；
- 到索引 `1` 结束；
- 步长为 `2`。

对应 Java 调用：

```java
JSONPathQueryBuilder.from(jsonData)
    .path("$.books[0:1:2]")
    .limit(10)
    .execute();
```

### 5.3 使用 Java 便捷方式进行切片

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.slice(0,1,2))))
    .limit(10)
    .execute();
```

这段写法和 path 表达式是一一对应的：

- `JSubscripts.slice(0,1,2)` 对应 `[0:1:2]`

### 5.4 切片适合什么场景？

切片特别适合：

- 列表预处理；
- 部分样本提取；
- 批量数据分段读取；
- 不想在代码里手动截取集合。

从程序员视角看，切片的意义在于：**让数组范围查询从业务代码退回到路径层。**

## 六、过滤表达式：JSONPath 真正好用的地方

### 6.1 过滤表达式解决什么问题？

下标解决的是“第几个”，过滤解决的是“哪些符合条件”。

这是 JSONPath 最接近业务语义的能力之一。

因为在真实项目里，你往往更关心：

- 价格大于 15 的图书；
- 标题等于某个值的对象；
- 某个字段存在或不存在的数据；
- 满足组合条件的一批记录。

如果没有过滤表达式，通常就只能：

- 先取整个数组；
- 再在 Java 代码里遍历；
- 再写一堆 if 判断。

这样写当然能跑，但查询逻辑会越来越分散。

### 6.2 根据 path 使用过滤表达式

例如，筛选标题等于 `Book 1` 的图书：

```text
$.books[?(@.title == 'Book 1')]
```

对应 Java 调用：

```java
JSONPathQueryBuilder.from(jsonData)
    .path("$.books[?(@.title == 'Book 1')]")
    .limit(10)
    .execute();
```

再比如，筛选价格大于 `15` 的图书：

```text
$.books[?(@.price>15)]
```

对应 Java 调用：

```java
JSONPathQueryBuilder.from(jsonData)
    .path("$.books[?(@.price>15)]")
    .limit(10)
    .execute();
```

### 6.3 使用 Java 便捷方式写过滤表达式

如果是简单等值过滤，可以直接使用 `JPredicate.eq()`：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.filter(JPredicate.eq("title", "Book 1")))))
    .limit(10)
    .execute();
```

如果是更复杂的条件，可以使用 `JPredicate.custom()`：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.filter(JPredicate.custom("@.price>15")))))
    .limit(10)
    .execute();
```

如果你要过滤 `isbn` 为假值的元素，也可以直接这样写：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.filter(JPredicate.custom("!@.isbn")))))
    .limit(10)
    .execute();
```

如果你要用 `in` 做集合过滤，也可以这样表达：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.filter(JPredicate.custom("@.title in ('Book 3','Book 2')")))))
    .limit(10)
    .execute();
```

如果你要写组合条件，例如标题命中且 `isbn` 为真：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.filter(JPredicate.custom("@.title in ('Book 3','Book 2') &&@.isbn")))))
    .limit(10)
    .execute();
```

### 6.4 过滤表达式的工程价值

过滤表达式最大的价值不是“语法炫”，而是：

- 查询规则更贴近业务表达；
- Java 业务代码更简洁；
- 配置化规则更容易沉淀；
- 复杂数组筛选更容易复用。

在规则引擎、接口聚合、数据转换这些场景里，过滤表达式非常实用。

## 七、当前节点：为什么它不是只有一个 `@` 那么简单？

### 7.1 当前节点是什么？

很多人第一次看到 `@`，会以为它只是过滤表达式里的一个符号。

其实在 jquick-path 里，“当前节点”本身也是一类语法概念。

它表示：**查询不是从整个 JSON 根对象开始，而是从当前上下文继续往下查。**

这在局部数据处理、嵌套查询和上下文传递场景里很常见。

### 7.2 根据 path 使用当前节点

例如：

```text
@.store.books
```

如果当前上下文本身就是某个对象，也可以直接继续取它下面的字段，例如：

```text
@.books
```

对应 Java path 调用方式可以直接写成：

```java
JSONPathQueryBuilder.from(jsonObject)
    .path("@.store.books")
    .limit(10)
    .execute();
```

这个表达式表示：

- 从当前节点开始；
- 进入 `store`；
- 再进入 `books`。

### 7.3 使用 Java 便捷方式表示当前节点

Java 便捷方式中，对应的是 `JRoot.CURRENT`：

```java
JSONPathQueryBuilder.from(jsonObject)
    .document(JPath.fromRoot(JRoot.CURRENT)
        .property("store")
        .property("books"))
    .limit(10)
    .execute();
```

### 7.4 当前节点适合什么场景？

当前节点更适合：

- 局部对象的继续查询；
- 多层嵌套处理；
- 规则在上下文中递进执行；
- 不是每次都从完整 JSON 根部开始的场景。

从程序员角度看，当前节点的价值在于：**你可以在已有上下文上继续构建路径，而不是每次都回到最外层重新写。**

## 八、`@` 在过滤表达式里到底表示什么？

### 8.1 `@` 在过滤里表示当前元素

如果说上一节的“当前节点”更偏查询起点，那么在过滤表达式里，`@` 的语义更具体：

**它表示当前正在被判断的那个元素。**

例如：

```text
$.books[?(@.title == 'Book 1')]
```

这里的 `@` 不是整个 JSON，也不是根对象，而是 `books` 数组里当前被遍历到的那一本书。

也就是说，这个表达式的逻辑其实是：

- 遍历 `books` 数组中的每个元素；
- 把当前元素记作 `@`；
- 判断 `@.title` 是否等于 `Book 1`；
- 如果成立，就保留该元素。

### 8.2 再看几个 `@` 的典型过滤例子

按价格过滤：

```text
$.books[?(@.price>15)]
```

按布尔值过滤：

```text
$.books[?(!@.isbn)]
```

按集合过滤：

```text
$.books[?(@.title in ('Book 3','Book 2'))]
```

按组合条件过滤：

```text
$.books[?(@.title in ('Book 3','Book 2') &&@.isbn)]
```

这些表达式都离不开 `@`，因为它是过滤语义里的“当前被筛选对象”。

### 8.3 Java 便捷方式如何对应 `@`

本质上，`@` 在 Java 写法里通常通过 `JPredicate.custom()` 的字符串表达出来：

```java
JSONPathQueryBuilder.from(jsonData)
    .document(JPath.fromRoot(JRoot.ROOT)
        .property("books")
        .segment(JSubscriptSegment.of(JSubscripts.filter(JPredicate.custom("@.price>15")))))
    .limit(10)
    .execute();
```

也就是说，Java 便捷方式并没有消灭 `@`，而是把它保留在过滤表达式语义里。

这点很合理，因为过滤表达式本来就是“针对当前元素判断”的逻辑。

## 九、这五类语法怎么组合使用？

实际开发里，它们通常不是单独出现，而是组合使用。

例如：

```text
$.books[?(@.price>15)]
```

这里同时用到了：

- `$` 根对象；
- `books` 属性访问；
- `[?()]` 过滤表达式；
- `@` 当前元素引用。

再比如：

```text
$.books[0:1:2]
```

这里组合了：

- `books` 数组访问；
- 切片语法 `[start:end:step]`。

从使用感受上看，jquick-path 这类工具真正的价值，就是让你能把复杂 JSON 查询拆成可组合的语法单元，而不是每次都从头写一段遍历代码。

## 十、五类语法速查表

| 语法场景 | path 写法 | Java 便捷方式核心写法 |
|------|------|------|
| 数字下标 | `$.books[0]` | `.segment(JSubscriptSegment.of(JSubscripts.index(0)))` |
| 下标取字段 | `$.books[2].price` | `.segment(JSegments.subscript(JIndexSubscript.of(2))).property("price")` |
| 数组切片 | `$.books[0:1:2]` | `.segment(JSubscriptSegment.of(JSubscripts.slice(0,1,2)))` |
| 等值过滤 | `$.books[?(@.title == 'Book 1')]` | `JSubscripts.filter(JPredicate.eq("title", "Book 1"))` |
| 条件过滤 | `$.books[?(@.price>15)]` | `JSubscripts.filter(JPredicate.custom("@.price>15"))` |
| 当前节点 | `@.store.books` | `JPath.fromRoot(JRoot.CURRENT).property("store").property("books")` |
| `@` 当前元素 | `@.price` | `JPredicate.custom("@.price>15")` |

## 十一、总结

如果你只想先掌握最实用的一批 JSONPath 语法，那么本文这五类就已经很够用了：

- **下标操作符**：解决数组里“第几个”的问题；
- **数组切片**：解决数组里“取哪一段”的问题；
- **过滤表达式**：解决“哪些元素符合条件”的问题；
- **当前节点**：解决“从哪个上下文继续查”的问题；
- **`@` 用于过滤表达式**：解决“当前元素怎么引用”的问题。

这几类语法看似基础，实际上正是 Java 项目中最容易高频出现、也最容易被手写代码替代到混乱的一部分。

而 jquick-path 的价值就在于，它同时提供了：

- path 路径表达式方式；
- Java 便捷访问方式；
- 更适合工程沉淀的查询表达能力。

如果你在做 Java 后端、规则引擎、接口聚合、配置系统、数据转换，这篇里的几类语法，基本就是最值得优先掌握的一组能力。

更多完整用法，可直接参考项目 [README.md]。

## 关键词

Java JSONPath、jquick-path、下标操作符、数组切片、过滤表达式、当前节点、@ 过滤表达式、Java JSON 查询、JSONPath 教程、CSDN 技术文章、Java 开源项目

如果你经常在 Java 项目里处理 JSON 数组、条件筛选和局部节点查询，这篇文章会更有价值。本文只讲最常用也最容易写乱的几类语法：下标操作符、数组切片、过滤表达式、当前节点，以及 @ 在过滤表达式中的实际用法。

Java JSONPath 还在硬写遍历？jquick-path 下标、切片、过滤表达式、当前节点实战详解

编程语言

开发工具

JavaJSONPath处理效率低？jquick-path实战详解下标操作符、数组切片、过滤表达式及当前节点@用法，附Maven坐标与Java代码示例，助你告别手写遍历，高效处理JSON数组筛选与局部查询。

数据转换

数据处理

代码解释

GitHub

JSON

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Java JSONPath 还在硬写遍历？jquick-path 下标、切片、过滤表达式、当前节点实战详解-腾讯云开发者社区-腾讯云

Java JSONPath 还在硬写遍历？jquick-path 下标、切片、过滤表达式、当前节点实战详解

Java JSONPath 还在硬写遍历？jquick-path 下标、切片、过滤表达式、当前节点实战详解

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐