Red Hat build of Apache Camel for Spring Boot への移行

ポーリングされるエンドポイント URI が、他のすべての EIP と同様に、Exchange のプロパティーとして (キー CamelToEndpoint とともに) 保存されるようになりました。これは 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 に削減されました。つまり、削除された値を使用しているカスタムコンポーネントに、残りの値の 1 つを指定する必要があります。これは、Camel コミュニティー内のすべてのコンポーネントのカテゴリーの数を整理するために行われました。

この DSL ジェネレーターでは、基礎となるモデルクラス (apicurio-data-models) が 1.1.27 から 2.0.3 に更新されました。

camel-atom コンポーネントのサードパーティーの Atom クライアントが、Apache Abdera から RSSReader に変更されました。これにより、フィードオブジェクトが 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.foo.MyOrder は 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 パラメーターが削除されました。キャッシュのキーは String 型のみになりました。詳細は、CAMEL-18877 を参照してください。

基盤となる hapi-fir ライブラリーが 4.2.0 から 6.2.4 にアップグレードされました。Delete API メソッドのみが変更され、org.hl7.fhir.instance.model.api.IBaseOperationOutcome ではなく ca.uhn.fhir.rest.api.MethodOutcome を返すようになりました。基礎となる変更の詳細なリストについては、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 メソッドがいくつか変更されていますが、その他は以前と同じです。

このコンポーネントは、Apache HttpComponents v5 を使用するようにアップグレードされました。これは、基礎となるクライアントの設定方法に影響を与えます。当初の 3 つのタイムアウト (connectionRequestTimeout、connectTimeout、および socketTimeout) ではなく、4 つの異なるタイムアウト (connectionRequestTimeout、connectTimeout、soTimeout、および responseTimeout) があります。これらの一部のデフォルト値が変更されているため、ドキュメントで詳細を参照してください。

HttpClient の可能な設定パラメーターから socketTimeout が削除されていることに注意してください。代わりに responseTimeout を使用してください。

最後に、オプション soTimeout と SocketConfig に含まれるパラメーターには、接頭辞として httpConnection を付ける必要があります。HttpClientBuilder および RequestConfig に定義されているパラメーターを含む残りのパラメーターには、以前のように接頭辞として httpClient を付ける必要があります。

org.apache.camel.http.common.HttpBinding の API が、再利用しやすいようにわずかに変更されました。parseBody メソッドが、入力パラメーターとして HttpServletRequest を受け取るようになりました。また、すべての HttpMessage が汎用の Message タイプに変更されました。

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 から MainConstants に移動しました。

メトリクスの名前が、Micrometer の命名規則に従って変更されました。

コマンド camel dependencies の名前が camel dependency に変更されました。

Camel JBang では、init および run ゴールの -dir パラメーターの名前が変更され、他のすべてのオプションと同様に 2 つのダッシュ --dir が必要になりました。

camel stop コマンドは、デフォルトで実行中のすべてのインテグレーションを停止します (オプション --all は削除されました)。

プレースホルダー置換 が、$name 構文ではなく #name を使用するように変更されました。

camel-openapi-java コンポーネントが、io.apicurio.datamodels ではなく io.swagger.v3 ライブラリーを使用するように変更されました。その結果、パブリックメソッド org.apache.camel.openapi.RestOpenApiReader.read() の戻り値の型が、io.apicurio.datamodels.openapi.models.OasDocument ではなく io.swagger.v3.oas.models.OpenAPI になりました。OpenAPI 2.0 (swagger) 仕様が解析されると、swagger パーサーによって OpenAPI 3.0.x に自動的にアップグレードされます。このバージョンでは、OpenAPI 3.1.x 仕様もサポートされています。関連する spring-boot スターターコンポーネントが、新しい戻り値の型を使用するように変更されました。

生成された DTO の Blob フィールドのプロパティー名に 'Url' が付加されなくなりました。たとえば、ContentVersionUrl プロパティーは ContentVersion になりました。

Slack によって頻繁にレートが制限されるのを避けるために、slack コンシューマーのデフォルトの遅延が 0.5 秒から 10 秒に変更されました。

camel-spring-rabbitmq のオプション replyTimeout が修正され、デフォルト値が 5 - 30 秒になりました (これは Spring で使用されるデフォルト値です)。

Camel は、Spring Boot のシャットダウン時に、少し遅れてシャットダウンするようになりました。これにより、Spring Boot の正常シャットダウンが完了 (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 エンドポイントに、サーブレットのコンテキストパス (デフォルトは camel) が接頭辞として付けられなくなりました。

以下に例を示します。

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

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

以前は、myservice を呼び出すには、http://localhost:8080/camel/myservice などのコンテキストパスを含める必要がありました。現在、このコンテキストパスは使用されていないため、http://localhost:8080/myservice を使用してエンドポイントを呼び出すことができます。

ルートまたはコンシューマーが一時停止している場合、http ステータス 404 ではなく 503 が返されるようになりました。

このコンポーネントは Twitter4j バージョン 4.1.2 を使用するように更新されました。これに伴い、いくつかのクラスで使用される パッケージ が移動しました。Twit ステータスなどの特定の Twitter 関連データにアクセスする場合は、使用するパッケージを 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 から移動しました。このため、アサーション句ビルダー の多くのメソッドが削除されています。

activemq-camel コンポーネントを使用している場合は、コンポーネント名が org.apache.activemq.camel.component.ActiveMQComponent から org.apache.camel.component.activemq.ActiveMQComponent に変更になった camel-activemq コンポーネントを使用するように移行する必要があります。

コンポーネント camel-aws が複数のコンポーネントに分割されました。

camel-cxf JAR が、SOAP と REST、および Spring と Spring 以外の JAR に分割されました。came-cxf から移行する場合は、次のリストから特定の JAR を選択することが推奨されます。

たとえば、SOAP および Spring XML で CXF を使用している場合は、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 はエンドポイント uri からトピックにメッセージを送信します。これをオーバーライドするには、新しいトピックで KafkaConstants.OVERRIDE_TOPIC ヘッダーを使用します。詳細は、camel-kafka コンポーネントのドキュメントを参照してください。

camel-telegram コンポーネントでは、認可トークンが uri-path からクエリーパラメーターに移動しました。以下に例を示します。

telegram:bots/myTokenHere

telegram:bots/myTokenHere

移動後は次のようになります。

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 に移動しました。JDK の XSTL エンジン (Xalan) を使う場合は camel-xslt、Saxon を使う場合は camel-xslt-saxon というように分けられています。そのため、Camel エンドポイント URI のコンポーネント名には、xslt および xslt-saxon を使用する必要があります。XSLT 集約ストラテジーを使用している場合は、Saxon のサポートのために org.apache.camel.component.xslt.saxon.XsltSaxonAggregationStrategy を使用します。また、xslt ビルダーを使用する場合は、Saxon のサポートのために org.apache.camel.component.xslt.saxon.XsltSaxonBuilder を使用します。なお、allowStax は JDK の XSLT ではサポートされておらず、camel-xslt-saxon でのみサポートされています。

XML DSL が若干変更になりました。

カスタムロードバランサーの EIP が <custom> から <customLoadBalancer> に変更になりました。

XMLSecurity データ形式では、<secureXML> タグの keyOrTrustStoreParametersId 属性の名称が keyOrTrustStoreParametersRef に変更されました。

<zipFile> データ形式が <zipfile> に名前が変更になりました。