3.2. 迁移到 Apache Camel 4

轮询的端点 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,connectTimeout,soTimeout , 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 等。

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

以下常数已从 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 规格。

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

新 URI 路径为：

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

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

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

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

您可以通过提供 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 status 503 现在会返回，而不是 404。

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

默认延迟（在 slack 消费者上）从 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 status 503 现在会返回，而不是 404。

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