Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 21 章 JsonPath

概述
复制链接

JsonPath 语言提供了便捷的语法，用于提取 JSON 消息的部分。JSON 的语法与 XPath 类似，但用于从 JSON 消息中提取 JSON 对象，而不是对 XML 执行操作。jsonpath DSL 命令可用作表达式或 predicate （空结果被解释为布尔值 false）。

添加 JsonPath 软件包
复制链接

要在 Camel 路由中使用 JsonPath，您需要为项目添加依赖项 camel-jsonpath，如下所示： 

<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-jsonpath</artifactId>
  <version>${camel-version}</version>
</dependency>
Copy to Clipboard Toggle word wrap

Java 示例
复制链接

以下 Java 示例演示了如何使用 jsonpath （） DSL 命令来选择特定价格范围内的项目： 

from("queue:books.new")
  .choice()
    .when().jsonpath("$.store.book[?(@.price < 10)]")
      .to("jms:queue:book.cheap")
    .when().jsonpath("$.store.book[?(@.price < 30)]")
      .to("jms:queue:book.average")
    .otherwise()
      .to("jms:queue:book.expensive")
Copy to Clipboard Toggle word wrap

如果 JsonPath 查询返回空集合，则结果将解释为 false。这样，您可以将 JsonPath 查询用作 predicate。

XML 示例
复制链接

以下 XML 示例演示了如何使用 jsonpath DSL 元素在路由中定义 predicates： 

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
  <route>
    <from uri="direct:start"/>
    <choice>
      <when>
        <jsonpath>$.store.book[?(@.price < 10)]</jsonpath>
        <to uri="mock:cheap"/>
      </when>
      <when>
        <jsonpath>$.store.book[?(@.price < 30)]</jsonpath>
        <to uri="mock:average"/>
      </when>
      <otherwise>
        <to uri="mock:expensive"/>
      </otherwise>
    </choice>
  </route>
</camelContext>
Copy to Clipboard Toggle word wrap

简单语法
复制链接

当您想使用 jsonpath 语法定义基本 predicate 时，很难记住语法。例如，要找到所有 cheap book，您必须按如下方式编写语法： 

$.store.book[?(@.price < 20)]
Copy to Clipboard Toggle word wrap

但是，如果您只将其写为： 

store.book.price < 20
Copy to Clipboard Toggle word wrap

如果您只想使用 price 键查看节点，您也可以省略该路径： 

price < 20
Copy to Clipboard Toggle word wrap

要支持此功能，有一个 EasyPredicateParser，用于定义使用基本风格的 predicate。这意味着 predicate 不得以 $ 符号开头，且必须仅包含一个操作器。简单语法如下： 

left OP right
Copy to Clipboard Toggle word wrap

您可以在右侧运算符中使用 Camel 简单语言，例如： 

store.book.price < ${header.limit}
Copy to Clipboard Toggle word wrap

支持的消息正文类型
复制链接

Camel JSonPath 支持使用以下类型的消息正文：

Expand
类型描述

File

从文件读取

字符串

普通字符串

Map

essage 正文作为 java.util.Map 类型

list

消息正文为 java.util.List 类型

POJO

可选，如果 Jackson 位于 classpath 上，则 camel-jsonpath 可以使用 Jackson 将消息正文读取为 POJO，并转换为 JSonPath 支持的 java.util.Map。例如，您可以添加 camel-jackson 作为依赖项，使其包含 Jackson。

InputStream

如果上述类型都不匹配，则 Camel 将尝试以 java.io.InputStream 形式读取消息正文。

如果消息正文是不支持的类型，则默认抛出异常，但您可以将 JSonPath 配置为阻止异常。

suppress Exceptions
复制链接

如果没有找到 jsonpath 表达式配置的路径，则 jsonpath 将抛出异常。通过将 SuppressExceptions 选项设置为 true 可忽略异常。例如，在以下代码中，将 true 选项添加为 jsonpath 参数的一部分： 

from("direct:start")
    .choice()
        // use true to suppress exceptions
        .when().jsonpath("person.middlename", true)
            .to("mock:middle")
        .otherwise()
            .to("mock:other");
Copy to Clipboard Toggle word wrap

在 XML DSL 中，使用以下语法： 

<route>
  <from uri="direct:start"/>
  <choice>
    <when>
      <jsonpath suppressExceptions="true">person.middlename</jsonpath>
      <to uri="mock:middle"/>
    </when>
    <otherwise>
      <to uri="mock:other"/>
    </otherwise>
  </choice>
</route>
Copy to Clipboard Toggle word wrap

jsonpath 注入
复制链接

在使用 bean 集成来调用 bean 方法时，您可以使用 JsonPath 从消息中提取值，并将它绑定到 method 参数。例如： 

// Java
public class Foo {

    @Consume(uri = "activemq:queue:books.new")
    public void doSomething(@JsonPath("$.store.book[*].author") String author, @Body String json) {
      // process the inbound message here
    }
}
Copy to Clipboard Toggle word wrap

内联简单表达式
复制链接

Camel 2.18 中的新功能.

Camel 支持 JsonPath 表达式中的内联 简单 表达式。Simple 语言插入必须使用 简单 语法表示，如下所示： 

from("direct:start")
  .choice()
    .when().jsonpath("$.store.book[?(@.price < `${header.cheap}`)]")
      .to("mock:cheap")
    .when().jsonpath("$.store.book[?(@.price < `${header.average}`)]")
      .to("mock:average")
    .otherwise()
      .to("mock:expensive");
Copy to Clipboard Toggle word wrap

通过设置选项 allow Simple =false 来关闭对简单表达式的支持，如下所示。

Java: 

// Java DSL
.when().jsonpath("$.store.book[?(@.price < 10)]", `false, false`)
Copy to Clipboard Toggle word wrap

XML DSL: 

// XML DSL
<jsonpath allowSimple="false">$.store.book[?(@.price &lt; 10)]</jsonpath>
Copy to Clipboard Toggle word wrap

参考
复制链接

有关 JsonPath 的更多详细信息，请参见 JSonPath 项目页面。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat