1.2. 迁移到 Apache Camel 4

轮询端点 URI 现在作为属性存储在 Exchange （使用键 CamelToEndpoint）上，与所有其他 EIP 一样。在 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 的 enums 数量已从 83 减少到 37，这意味着使用删除的值的自定义组件需要选择其中一个剩余值。我们这样做以整合 Camel 社区中所有组件的类别数。

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

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

itemPartitionKey 已更新。现在，它是一个不是 PartitionKey 的 String。CAMEL-19222 中的更多详细信息。

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

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

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

这也适用于 String, int 等 Java 类型。

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

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

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

keyType 参数已被删除。现在，缓存的 Key 将仅为 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。有关底层更改的详细列表，请参阅 hapi-fhir （在 Camel 中使用 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 方法更改，但其他 API 方法与以前相同。

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

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

最后，选项 soTimeout 以及 socket Config 中包含的任何参数（需要以 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 等。

camel-web3j 将 web3j JAR 从 3.x 升级到 5.0，它有很多 API 更改，因此不再提供一些之前的 API 调用。

以下常量已从 BaseMainSupport / MainConstants 移到 Main Constants ：

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

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

在 Camel JBang 的 init 的 -dir 参数中，并运行 目标已重命名为需要 2 dashes-- dir，就像所有其他选项一样。

camel stop 命令现在默认停止所有正在运行的集成( option-- 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 规格。

camel-optaplanner 组件已改为使用 SolverManager。如果您在 Camel 3 中使用 SoverManager，则不再需要 Route 中的布尔值 useSolverManager。弃用的 ProblemFactChange 已被 ProblemChange 替代。

新的 URI 路径为：

from("optaplanner:myProblemName")
  .to("...")

from("optaplanner:myProblemName")
  .to("...")

您可以通过两种方式传递 Optaplanner SolverManager ：

在 Quarkus 上运行 camel-optaplanner 时，请使用 Quarkus 方法创建 SolverManager。

您可以通过提供 XML 配置文件，迁移旧的 Camel Optaplanner 路由，它允许 Camel Optaplanner 处理为这些传统路由创建 SolverManager ：

from("optaplanner:myProblemName?configFile=PATH/TO/CONFIG.FILE.xml")
  .to("...")

from("optaplanner:myProblemName?configFile=PATH/TO/CONFIG.FILE.xml")
  .to("...")

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

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

默认延迟（在 slack consumer 上）从 0.5s 改为 10s，以避免 Slack 通常的速率限制。

uri 标签现在是静态的，而不是动态（默认），因为带有动态值的 URI 而导致潜在的标签太多。这可以通过设置 camel.metrics.uriTagDynamic=true 来再次启用。

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

例如：

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

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

可以使用 http://localhost:8080/myservice 调用端点，因为不使用 context-path。

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

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