迁移到 Red Hat build of Apache Camel for Spring Boot

轮询的端点 URI 现在作为属性存储在 Exchange 上（带有键 CamelToEndpoint），与其他 EIPs 一样。在 URI 作为消息标头存储之前。

camel-resilience4j 中的以下选项被错误地定义为属性：

这些选项没有在 YAML DSL 中公开，在您需要迁移的 XML DSL 中：

<circuitBreaker>
    <resilience4jConfiguration>
        <timeoutEnabled>true</timeoutEnabled>
        <timeoutDuration>2000</timeoutDuration>
    </resilience4jConfiguration>
...
</circuitBreaker>

<circuitBreaker>
    <resilience4jConfiguration>
        <timeoutEnabled>true</timeoutEnabled>
        <timeoutDuration>2000</timeoutDuration>
    </resilience4jConfiguration>
...
</circuitBreaker>

使用以下属性：

<circuitBreaker>
    <resilience4jConfiguration timeoutEnabled="true" timeoutDuration="2000"/>
...
</circuitBreaker>

<circuitBreaker>
    <resilience4jConfiguration timeoutEnabled="true" timeoutDuration="2000"/>
...
</circuitBreaker>

camel.health.components-enabled 选项已重命名为 camel.health.producers-enabled。

有些组件（特别是 AWS）也为生成者提供健康检查；在 Camel 3.x 中，这些健康检查无法正常工作，并在源中禁用。要在 Camel 4 中继续此行为，基于生成者的健康检查被禁用。

请注意，camel-kafka 附带基于制作者的健康检查，在 Camel 3 中工作，因此 Camel 4 中的这个更改意味着这个健康检查被禁用。

您必须在全局范围内启用制作者健康检查，例如在 application.properties 中：

camel.health.producers-enabled = true

camel.health.producers-enabled = true

org.apache.camel.Category 的枚举数量已从 83 减少到 37，这意味着使用删除的值的自定义组件需要选择一个剩余的值。我们这样做是为了整合 Camel 社区中所有组件的类别。

此 dsl-generator 已将底层模型类(apicurio-data-models)从 1.1.27 更新至 2.0.3。

camel-atom 组件已将 Apache Abdera 的第三方从 Apache Abdera 改为 RSSReader。这意味着源对象已从 org.apache.abdera.model.Feed 改为 com.apptasticsoftware.rssreader.Item。

itemPartitionKey 已更新。现在，一个字符串 a not a PartitionKey。CAMEL-19222 中的更多详细信息。

当使用 method 选项引用特定方法时，并使用参数类型和值，例如 ："bean:myBean?method=foo (com.foo.MyOrder, true) "， 任何类类型现在都必须使用 .class 语法，即 com. foo.MyOrder.MyOrder。

"bean:myBean?method=foo(com.foo.MyOrder.class, true)"

"bean:myBean?method=foo(com.foo.MyOrder.class, true)"

这也适用于 Java 类型，如 String、int。

"bean:myBean?method=bar(String.class, int.class)"

"bean:myBean?method=bar(String.class, int.class)"

从 Box Java SDK v2 升级到 v4，其有一些方法签名更改。获取文件缩略图的方法不再可用。

keyType 参数已被删除。缓存的密钥现在仅是 String 类型。CAMEL-18877 中的更多信息。

底层 hapi-fhir 库已从 4.2.0 升级到 6.2.4。只有 Delete API 方法已更改，现在返回 ca.uhn.fhir.rest.api.MethodOutcome 而不是 org.hl7.fhir.instance.model.api.IBaseOperationOutcome。有关底层更改的详细列表（只在 Camel 中使用 hapi-fhir 客户端，请参阅 hapi-fhir 客户端）。

基于 API 的组件 camel-google-drive,camel-google-calendar,camel-google-sheets 和 camel-google-mail 已从 Google Java SDK v1 升级到 v2，以及最新的 API 修订。camel-google-drive 和 camel-google-sheets 有一些 API 方法更改，但其他方法与之前相同。

组件已升级至使用 Apache HttpComponents v5，这会影响底层客户端的配置方式。有 4 个不同的超时(connectionRequestTimeout , connect Timeout,so Timeout, soTimeout )而不是最初 3 (connectionRequestTimeout,connectTimeout, socketTimeout)，以及其中一些的默认值已更改，因此请参阅文档了解更多详情。

请注意，socketTimeout 已从 HttpClient 的可能配置参数中删除，改为使用 responseTimeout。

最后，选项 soTimeout 以及 SocketConfig 中包含的任何参数，需要以 httpConnection. 前缀。（包括定义到 HttpClientBuilder 和 RequestConfig 的参数等）需要加上 httpClient 前缀。

org.apache.camel.http.common.HttpBinding 中的 API 稍微更改为可重复利用。parseBody 方法现在使用 HttpServletRequest 作为输入参数。所有 HttpMessage 已更改为通用 消息类型。

io.fabric8:kubernetes-client 库已被升级，一些已弃用的 API 用量已被删除。之前带有 replace 前缀的操作现在带有 update 前缀。

例如，replaceConfigMap 现在是 updateConfigMap，replacePod 现在为 updatePod 等。类 KubernetesOperations 中的对应常量也被重命名。REPLACE_CONFIGMAP_OPERATION 现在是 UPDATE_CONFIGMAP_OPERATION，REPLACE_POD_OPERATION 现在为 UPDATE_POD_OPERATION 等。

以下常数已从 BaseMainSupport / Main to Main Constants 移动：

指标已被重命名为遵循 Micrometer 命名约定。

camel 依赖项 命令已被重命名为 camel 依赖项。

在 Camel JBang 中，init 和 run 目标的 -dir 参数已被重命名为需要 2 dashes --dir，与所有其他选项一样。

camel stop 命令现在默认停止所有正在运行的集成（删除了 --all 选项）。

Placeholders 替换 被修改为使用 #name 而不是 $name 语法。

camel-openapi-java 组件已更改为使用 io.swagger.v3 库，而不是 io.apicurio.datamodels。因此，公共方法 org.apache.camel.openapi.RestOpenApiReader.read （）的返回类型是 io.swagger.v3.oas.models.OpenAPI，而不是 io.apicurio.datamodels.openapi.models.OasDocument。当解析 OpenAPI 2.0 (swagger)规格时，它由 swagger parser 自动升级到 OpenAPI 3.0.x。此版本还支持 OpenAPI 3.1.x 规格。相关的 spring-boot 入门组件已被修改为使用新的返回类型。

生成的 DTOs 上的 blob 字段的属性名称不再有 'Url' affixed。例如，ContentVersionUrl 属性现在是 ContentVersion。

默认延迟（在 slack 消费者上）从 0.5s 改为 10s，以避免被 Slack 的速率限制。

camel-spring-rabbitmq 中的选项 replyTimeout 已被修复，默认值从 5 到 30 秒（这是 Spring 使用的默认值）。

Camel 现在会在 Spring Boot 关闭过程中关闭一些时间。这允许 Spring Boot graceful shutdown 首先完成（正常停止 Spring Boot HTTP 服务器），然后在 Camel 执行自己的 Graceful Shutdown 后。

从技术上 camel-spring 已将 getPhase （） 从 Integer.MAX_VALUE 返回到 Integer.MAX_VALUE - 2049。这为 Spring Boot 服务提供了先关机的空间。

uri 标签现在是静态的，而不是动态标签（默认情况下，因为 URI 使用动态值生成的标签太多）。这可以通过设置 camel.metrics.uriTagDynamic=true 来再次启用。

platform-http-starter 已从使用 camel-servlet 改为直接使用 Spring HTTP 服务器。因此，所有 HTTP 端点不再以 servlet context-path 前缀（默认为 camel）。

例如：

from("platform-http:myservice")
  .to("...")

from("platform-http:myservice")
  .to("...")

然后，在需要包括 context-path 之前调用 myservice 才能包括 context-path，如 http://localhost:8080/camel/myservice。现在，context-path 没有被使用，端点可以使用 http://localhost:8080/myservice 调用。

如果路由或消费者被暂停，则 http status 503 现在会返回，而不是 404。

组件已更新为使用 Twitter4j 版本 4.1.2，它已移动了几个类使用 的软件包。如果访问某些与二者相关的数据，如 Twit 状态，您需要将从 twitter4j.Status 中使用的软件包更新为 twitter4j.v1.Status。

Camel 2.x 中的所有已弃用的组件都在 Camel 3.x 中删除，包括旧的 camel-http, camel-hdfs, camel-mina, camel-mongodb, camel-netty, camel-netty-http, camel-quartz, camel-restlet 和 camel-rx 组件。

在 Camel 3.x 中重命名以下组件。

mock 组件已从 camel-core 移出。由于其 assertion 子句构建器 上的许多方法已被删除。

如果您使用 activemq-camel 组件，则应迁移到使用 camel-activemq 组件，其中组件名称已从 org.apache.activemq.camel.component.ActiveMQComponent 改为 org.apache.camel.component.activemq.ActiveMQComponent。

组件 camel-aws 被分成多个组件：

camel-cxf JAR 已分为 SOAP 与 REST 和 Spring JAR。当从 came-cxf 进行迁移时，建议从以下列表中选择特定的 JAR。

例如，如果您使用 CXF 用于 SOAP 并使用 Spring XML，那么在从 camel-cxf 进行迁移时，请选择 camel-cxf-spring-soap 和 camel-cxf-spring-transport。

使用 Spring Boot 时，当您从 camel-cxf-starter 迁移到 SOAP 或 REST 时，从以下入门中选择：

camel-fhir 组件已将其 hapi-fhir 依赖项升级到 4.1.0。默认 FHIR 版本已改为 R4。因此，如果需要 DSTU3，则必须明确设置它。

camel-kafka 组件删除了选项 bridgeEndpoint 和 circularTopicDetection，因为组件不再需要，因为组件在 Camel 2.x 上可以正常工作。换句话说，camel-kafka 将从 endpoint uri 发送消息到主题。要覆盖它，请使用带有新主题的 KafkaConstants.OVERRIDE_TOPIC 标头。请参阅 camel-kafka 组件文档以了解更多信息。

camel-telegram 组件已将授权令牌从 uri-path 移到查询参数，如 migrate

telegram:bots/myTokenHere

telegram:bots/myTokenHere

to

telegram:bots?authorizationToken=myTokenHere

telegram:bots?authorizationToken=myTokenHere

如果您只使用 camel-core 作为依赖项运行 Camel 独立，并且希望开箱即用启用 JMX，则需要将 camel-management 添加为依赖项。

对于使用 ManagedCamelContext，您需要从 CamelContext 获取此扩展，如下所示：

ManagedCamelContext managed = camelContext.getExtension(ManagedCamelContext.class);

ManagedCamelContext managed = camelContext.getExtension(ManagedCamelContext.class);

XSLT 组件已从 camel-core 移到 camel-xslt 和 camel-xslt-saxon。组件被分开，因此 camel-xslt 用于使用 JDK XSTL 引擎(Xalan)，camel-xslt-saxon 是使用 Saxon 时的。这意味着，您应该在 Camel 端点 URI 中使用 xslt 和 xslt-saxon 作为组件名称。如果您使用 XSLT 聚合策略，则使用 org.apache.camel.component.xslt.saxon.XsltSaxonAggregationStrategy 进行 Saxon 支持。并使用 org.apache.camel.component.xslt.saxon.XsltSaxonBuilder 进行 Saxon 支持（如果使用 xslt 构建器）。另请注意，只有 camel-xslt-saxon 中也支持 allowStax，因为 JDK XSLT 不支持它。

XML DSL 稍微改变。

自定义负载均衡器 EIP 已从 < custom> 改为 &lt; customLoadBalancer>

在 <secureXML> tag 中，XMLSecurity 数据格式将属性 keyOrTrustStoreParametersId 重新命名为 keyOrTrustStoreParametersRef。

& lt;zipFile& gt; 数据格式已重命名为 < zipfile>。