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

2.18. Core

Camel 核心功能和基本 Camel 语言/常量、交换属性、Header、Ref、Simple 和 Tokenize

2.18.1. 内部是什么
复制链接

有关使用和配置详情，请参阅上述链接。

2.18.2. Maven 协调
复制链接

在 code.quarkus.redhat.com 上使用此扩展创建一个新项目

或者将协调添加到现有项目中： 

<dependency>
    <groupId>org.apache.camel.quarkus</groupId>
    <artifactId>camel-quarkus-core</artifactId>
</dependency>
Copy to Clipboard Toggle word wrap

2.18.3. 其他 Camel Quarkus 配置
复制链接

2.18.3.1. 简单语言
复制链接

2.18.3.1.1. 使用 OGNL 表示法
复制链接

使用简单语言中的 OGNL 表示法时，应使用 camel-quarkus-bean 扩展。

例如，以下简单的表达式是访问类型为 Client 的消息正文的 getAddress （） 方法。 

---
simple("${body.address}")
---
Copy to Clipboard Toggle word wrap

在这种情况下，应该依赖 camel-quarkus-bean 扩展的额外依赖项 ，如下所述。请注意，在原生模式中，可能需要注册一些类来反映。在上例中，Client 类需要 进行注册以进行反映。

2.18.3.1.2. 在原生模式中使用动态类型解析
复制链接

当从简单表达式动态解析类型时，如下所示：

  • simple("${mandatoryBodyAs(TYPE)}")
  • simple("${type:package.Enum.CONSTANT}")
  • from("…​").split(bodyAs(TYPE.class))
  • simple("${body} is TYPE")

可能需要注册一些类来手动反映。

例如，以下简单的表达式在运行时动态解析 java.nio.ByteBuffer 类型： 

---
simple("${body} is 'java.nio.ByteBuffer'")
---
Copy to Clipboard Toggle word wrap

因此，类 java.nio.ByteBuffer 需要注册来反映。

如果您的路由应该从 classpath 加载一个简单脚本，如下例所示 

from("direct:start").transform().simple("resource:classpath:mysimple.txt");
Copy to Clipboard Toggle word wrap

然后，您需要使用 Quarkus quarkus.native.resources.includes 属性将资源包含在原生可执行文件中，如下所示： 

quarkus.native.resources.includes = mysimple.txt
Copy to Clipboard Toggle word wrap
2.18.3.1.4. 通过原生模式的属性配置自定义 bean
复制链接

当通过原生模式中的属性指定自定义 bean 时，如 #class:* or #type:*，可能需要注册一些类来手动反映。

例如，以下自定义 bean 定义涉及对 bean 实例化和 setter 调用进行反映： 

---
camel.beans.customBeanWithSetterInjection = #class:org.example.PropertiesCustomBeanWithSetterInjection
camel.beans.customBeanWithSetterInjection.counter = 123
---
Copy to Clipboard Toggle word wrap

因此，类 PropertiesCustomBeanWithSetterInjection 需要为反映注册，请注意，在这种情况下可以省略字段访问权限。

Expand
配置属性类型默认

lock quarkus.camel.bootstrap.enabled

当设置为 true 时，CamelRuntime 将自动启动。

布尔值

true

lock quarkus.camel.service.discovery.exclude-patterns

以逗号分隔的 Ant-path 风格模式列表，以匹配 classpath 中的 Camel 服务定义文件。匹配文件中定义的服务无法通过 org.apache.camel.spi.FactoryFinder 机制发现。excludes 的优先级高于 includes。此处定义的 excludes 还可以用来传递 Camel Quarkus 扩展中包含的服务可发现性。示例值：META-INF/services/org/apache/camel/foo/*,META-INF/services/org/apache/camel/foo/**/bar

字符串

 

lock quarkus.camel.service.discovery.include-patterns

以逗号分隔的 Ant-path 风格模式列表，以匹配 classpath 中的 Camel 服务定义文件。匹配文件中定义的服务将通过 org.apache.camel.spi.FactoryFinder 机制发现，除非指定的文件通过 exclude-patterns 排除。请注意，Camel Quarkus 扩展默认可能包含一些服务。此处选择的服务添加到这些服务中，在 exclude-patterns 中定义的排除将应用到联合集。示例值：META-INF/services/org/apache/camel/foo/*,META-INF/services/org/apache/camel/foo/**/bar

字符串

 

lock quarkus.camel.service.registry.exclude-patterns

以逗号分隔的 Ant-path 风格模式列表，以匹配 classpath 中的 Camel 服务定义文件。在应用的静态初始化过程中，匹配文件中定义的服务不会添加到 Camel registry 中。excludes 的优先级高于 includes。此处定义的 excludes 还可以用来传递 Camel Quarkus 扩展中包含的服务的注册。示例值：META-INF/services/org/apache/camel/foo/*,META-INF/services/org/apache/camel/foo/**/bar

字符串

 

lock quarkus.camel.service.registry.include-patterns

以逗号分隔的 Ant-path 风格模式列表，以匹配 classpath 中的 Camel 服务定义文件。匹配文件中定义的服务将在应用程序的静态初始化过程中添加到 Camel registry 中，除非给定的文件通过 exclude-patterns 排除。请注意，Camel Quarkus 扩展默认可能包含一些服务。此处选择的服务添加到这些服务中，在 exclude-patterns 中定义的排除将应用到联合集。示例值：META-INF/services/org/apache/camel/foo/*,META-INF/services/org/apache/camel/foo/**/bar

字符串

 

lock quarkus.camel.runtime-catalog.components

如果为 true，则应用程序中嵌入的 Runtime Camel Catalog 将包含应用程序中可用的 Camel 组件的 JSON 模式；否则，在 Runtime Camel Catalog 中不提供组件 JSON 模式，并试图访问它们将导致 RuntimeException。把它设置为 false 有助于缩小原生镜像的大小。在 JVM 模式中，不将此标志设置为 false 的实际优点是，除了使行为与原生模式一致。

布尔值

true

lock quarkus.camel.runtime-catalog.languages

如果为 true，则应用程序中嵌入的 Runtime Camel Catalog 将包含应用程序中可用的 Camel 语言的 JSON 模式；否则，在 Runtime Camel Catalog 中不提供语言 JSON 模式，并试图访问它们将导致 RuntimeException。把它设置为 false 有助于缩小原生镜像的大小。在 JVM 模式中，不将此标志设置为 false 的实际优点是，除了使行为与原生模式一致。

布尔值

true

lock quarkus.camel.runtime-catalog.dataformats

如果为 true，为应用程序嵌入的 Runtime Camel Catalog 会包含应用程序中提供的 Camel 数据格式的 JSON 模式；否则，在 Runtime Camel Catalog 中将无法使用数据格式 JSON 模式，并试图访问它们将导致 RuntimeException。把它设置为 false 有助于缩小原生镜像的大小。在 JVM 模式中，不将此标志设置为 false 的实际优点是，除了使行为与原生模式一致。

布尔值

true

lock quarkus.camel.runtime-catalog-models

如果为 true，则应用程序中嵌入的 Runtime Camel Catalog 将包含应用程序中提供的 Camel EIP 模型的 JSON 模式；否则，在 Runtime Camel Catalog 中不提供 EIP 模型 JSON 模式，并试图访问它们将导致 RuntimeException。把它设置为 false 有助于缩小原生镜像的大小。在 JVM 模式中，不将此标志设置为 false 的实际优点是，除了使行为与原生模式一致。

布尔值

true

lock quarkus.camel.routes-discovery.enabled

在静态初始化过程中启用自动发现路由。

布尔值

true

lock quarkus.camel.routes-discovery.exclude-patterns

用于独占过滤 RouteBuilder 类的扫描。专用过滤优先于包含的过滤。模式使用 ant-path 风格模式。可以使用逗号分隔多个模式。例如，要排除所有以 Bar 开始的类，使用：**/Bar*；要排除所有组成一个特定数据包的路由，使用：com/mycompany/bar/*；要排除所有组成一个特定数据包和它的子数据包的路由，使用双通配符：com/mycompany/bar/**；要排除所有来自两个特定数据包的路由，使用：com/mycompany/bar/*,com/mycompany/stuff/*

字符串

 

lock quarkus.camel.routes-discovery.include-patterns

用于过滤 RouteBuilder 类的扫描。专用过滤优先于包含的过滤。模式使用 ant-path 风格模式。可以使用逗号分隔多个模式。例如，要包括所有以 Foo 开始的类，使用：**/Foo*；要包括所有组成一个特定数据包的路由，使用：com/mycompany/foo/*；要包括所有组成一个特定数据包和它的子数据包的路由，使用双通配符：com/mycompany/foo/**；要包括所有来自两个特定数据包的路由，使用：com/mycompany/foo/*,com/mycompany/stuff/*

字符串

 

lock quarkus.camel.native.resources.exclude-patterns

由 Camel Quarkus 2.0.0 中的 quarkus.native.resources.excludes 替代。使用此属性会在构建时抛出异常。

字符串

 

lock quarkus.camel.native.resources.include-patterns

由 Camel Quarkus 2.0.0 中的 quarkus.native.resources.includes 替代。使用此属性会在构建时抛出异常。

字符串

 

lock quarkus.camel.native.reflection.exclude-patterns

以逗号分隔的 Ant-path 风格模式列表，以匹配应排除在 Register for reflection 中的类名称。使用 java.lang.Class.getName （） 方法返回的类名称格式：以句点 . 和内部类分隔的软件包片段，按符号 $ 分隔。这个选项缩小了由 include-patterns 选择的集合。默认情况下，不会排除任何类。这个选项不能用于取消由 Quarkus 扩展在内部注册的类。

字符串

 

lock quarkus.camel.native.reflection.include-patterns

以逗号分隔的 Ant-path 风格模式列表，以匹配应该注册以进行反映的类名称。使用 java.lang.Class.getName （） 方法返回的类名称格式：以句点 . 和内部类分隔的软件包片段，按符号 $ 分隔。默认情况下，不包含类。这个选项选择的集合可以通过 exclude-patterns 缩小。请注意，Quarkus 扩展通常自行注册所需的类来反映。当功能中的内置不够时，此选项很有用。请注意，这个选项启用对构造器、字段和方法的完整反映访问。如果您需要精细的控制，请考虑在 Java 代码中使用 io.quarkus.runtime.annotations.RegisterForReflection 注解。要使此选项正常工作，必须至少满足以下条件之一：在特征中没有通配符 (* 或 /) - 包括所选类的工件中包括一个 Jandex 索引 (META-INF/jandex.idx) - 包括所选类的工件进行了注册用于索引，使用 application.properties 中的 quarkus.index-dependency.* 系列选项 - 例如 quarkus.index-dependency.my-dep.group-id = org.my-group quarkus.index-dependency.my-dep.artifact-id = my-artifact，其中 my-dep 您选择告诉 Quarkus org.my-group 和 my-artifact 属于一起的标签。

字符串

 

lock quarkus.camel.native.reflection.serialization-enabled

如果为 true，则为序列化注册基本类；否则，基本类不会自动注册以原生模式进行序列化。CamelSerializationProcessor.BASE_SERIALIZATION_CLASSES 中可找到自动注册的类列表。把它设置为 false 有助于缩小原生镜像的大小。在 JVM 模式中，不会将此标志设置为 true 的实际优点是，除了使行为与原生模式一致。

布尔值

false

lock quarkus.camel.csimple.on-build-time-analysis-failure

如果构建时无法从路由定义中提取 CSimple 表达式，则做什么。

org.apache.camel.quarkus.core.CamelConfig.FailureRemedy

warn

lock quarkus.camel.event-bridge.enabled

是否启用 Camel 事件到 CDI 事件。这允许为 Camel 事件配置 CDI 观察器。例如，那些属于 org.apache.camel.quarkus.core.events、org.apache.camel.quarkus.main.events 和 org.apache.camel.impl.event 软件包的用户。请注意，此配置项仅在为 Camel 事件配置观察器时才生效。

布尔值

true

lock quarkus.camel.source-location-enabled

启用/禁用 camel 源位置的构建时间配置选项

布尔值

false

lock quarkus.camel.main.shutdown.timeout

等待 CamelMainöstop （） 完成超时（带有毫秒精度）

java.time.Duration

PT3S

lock quarkus.camel.main.arguments.on-unknown

CamelMain 遇到未知参数时要执行的操作。fail - 打印 CamelMain usage 语句并抛出 RuntimeException ignore - Suppresses any 警告，应用程序启动会以正常警告的形式进行 - 打印 CamelMain usage 语句，但允许应用程序启动正常操作

org.apache.camel.quarkus.core.CamelConfig.FailureRemedy

warn

lock 构建时修复的配置属性。所有其他配置属性可在运行时覆盖。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat