3.3. 迁移到 Apache Camel 3

在 Java 11 中，JAXB 模块已从 JDK 中删除，因此您需要将它们添加为 Maven 依赖项（如果使用 JAXB 时，如使用 XML DSL 或 camel-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>

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 将从 endpoint uri 发送消息到主题。要覆盖它，请使用带有新主题的 KafkaConstants.OVERRIDE_TOPIC 标头。请参阅 camel-kafka 组件文档以了解更多信息。

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

telegram:bots/myTokenHere

to

telegram:bots?authorizationToken=myTokenHere

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

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

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>。