이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 49. JQ


Since Camel 3.18

Camel supports JQ to allow using Expression or Predicate on JSON messages.

49.1. Dependencies

When using jq with Red Hat build of Camel Spring Boot, use the following Maven dependency to have support for auto configuration:

<dependency>
  <groupId>org.apache.camel.springboot</groupId>
  <artifactId>camel-jq-starter</artifactId>
</dependency>
Copy to Clipboard Toggle word wrap

49.2. JQ Options

The JQ language supports 4 options, which are listed below.

Expand
NameDefaultJava TypeDescription

headerName

 

String

Name of header to use as input, instead of the message body It has as higher precedent than the propertyName if both are set.

propertyName

 

String

Name of property to use as input, instead of the message body. It has a lower precedent than the headerName if both are set.

resultType

 

String

Sets the class of the result type (type from output).

trim

true

Boolean

Whether to trim the value to remove leading and trailing whitespaces and line breaks.

49.3. Examples

For example, you can use JQ in a Predicate with the Content Based Router EIP.

from("queue:books.new")
  .choice()
    .when().jq(".store.book.price < 10)")
      .to("jms:queue:book.cheap")
    .when().jq(".store.book.price < 30)")
      .to("jms:queue:book.average")
    .otherwise()
      .to("jms:queue:book.expensive");
Copy to Clipboard Toggle word wrap

49.4. Message body types

Camel JQ leverages camel-jackson for type conversion. To enable camel-jackson POJO type conversion, refer to the Camel Jackson documentation.

49.5. Using header as input

By default, JQ uses the message body as the input source. However, you can also use a header as input by specifying the headerName option.

For example to count the number of books from a JSON document that was stored in a header named books you can do:

from("direct:start")
    .setHeader("numberOfBooks")
        .jq(".store.books | length", int.class, "books")
    .to("mock:result");
Copy to Clipboard Toggle word wrap

49.6. Camel supplied JQ Functions

The camel-jq adds the following functions:

  • header - Allow to access the Message header in a JQ expression.

For example, to set the property foo with the value from the Message header `MyHeader':

from("direct:start")
    .transform()
        .jq(".foo = header(\"MyHeader\")")
    .to("mock:result");
Copy to Clipboard Toggle word wrap

49.7. Spring Boot Auto-Configuration

The component supports 4 options, which are listed below.

Expand
NameDescriptionDefaultType

camel.language.jq.enabled

Whether to enable auto configuration of the jq language. This is enabled by default.

 

Boolean

camel.language.jq.header-name

Name of header to use as input, instead of the message body It has as higher precedent than the propertyName if both are set.

 

String

camel.language.jq.property-name

Name of property to use as input, instead of the message body. It has a lower precedent than the headerName if both are set.

 

String

camel.language.jq.trim

Whether to trim the value to remove leading and trailing whitespaces and line breaks.

true

Boolean

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat