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 < 20
Copy to Clipboard Toggle word wrap

为了支持此功能，可以使用一个 EasyPredicateParser，它用来使用基本风格来定义 predicate。这意味着 predicate 不得以 $ 符号开头，且只能包含一个 Operator。简单语法如下： 

left OP right
Copy to Clipboard Toggle word wrap

您可以在正确的 operator 中使用 Camel 简单语言，例如： 

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

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

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

Expand
类型描述

File

从文件中读取

字符串

普通字符串

Map

essage body as java.util.Map type

list

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

POJO

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

InputStream

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

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

阻止例外
复制链接

如果没有找到由 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 从消息中提取值并将其绑定到方法参数。例如： 

// 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 表达式。Simple language insertions 必须以 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 来关闭对 Simple 表达式的支持，如下所示。

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