迁移 Apache Camel

轮询端点 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。

在 Java 11 中，JAXB 模块已从 JDK 中删除，因此您需要将它们添加为 Maven 依赖项（如使用 XML DSL 或 camel-jaxb 组件时）的 JAXB ：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>

<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.0.1</version>
</dependency>

<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.2</version>
</dependency>

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>

<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.0.1</version>
</dependency>

<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.2</version>
</dependency>

Camel 2.x 中的所有已弃用的组件都会在 Camel 3.x 中删除：

以下组件在 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。从 camel-cxf 进行迁移时，我们建议您从以下列表中选择特定的 JAR。

例如，如果您在 SOAP 中使用 CXF，则在从 camel-cxf 进行迁移时选择 camel-cxf-soap 和 camel-cxf-transport。

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

camel-kafka 组件已删除了 bridgeEndpoint 和 circularTopicDetection 选项，因为组件充当 Camel 2.x 的桥接。换句话说，camel-kafka 将从端点 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 支持。如果使用 xslt 构建器，并使用 org.apache.camel.component.xslt.saxon.XsltSaxonBuilder 作为 Saxon 支持。另请注意，allowStax 只在 camel-xslt-saxon 中被支持，因为 JDK XSLT 不支持它。

XML DSL 稍有变化。

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

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

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