Red Hat build of Apache Camel for Quarkus のリリースノート

Quarkus TLS レジストリー は、Quarkus によって提供される拡張機能であり、TLS 設定を一元管理して、アプリケーション全体で安全な接続の管理と維持を容易にします。

Quarkus TLS レジストリーは、Quarkus CXF 3.16.0 以降でトラストストア、キーストア、その他の TLS/SSL 関連の設定で新たに推奨される方法です。

# Define a TLS configuration with name "hello-tls" 

quarkus.tls.hello-tls.trust-store.p12.path = client-truststore.pkcs12
quarkus.tls.hello-tls.trust-store.p12.password = client-truststore-password

# Basic client settings
quarkus.cxf.client.hello.client-endpoint-url = https://localhost:${quarkus.http.test-ssl-port}/services/hello
quarkus.cxf.client.hello.service-interface = io.quarkiverse.cxf.it.security.policy.HelloService

# Use "hello-tls" defined above for this client
quarkus.cxf.client.hello.tls-configuration-name = hello-tls

Quarkus TLS レジストリー によって提供されるすべてのクライアント関連オプションは、Vert.x ベースの CXF クライアントでサポートされます。

# Deprecated way of setting the client trust store
quarkus.cxf.client.hello.trust-store-type = pkcs12
quarkus.cxf.client.hello.trust-store = client-truststore.pkcs12
quarkus.cxf.client.hello.trust-store-password = client-truststore-password

Vert.x HttpClient ベースの HTTP Conduit は、Quarkus CXF 3.13.0 で 導入 されました。quarkus.cxf.client."client-name".http-conduit-factory または quarkus.cxf.http-conduit-factory のいずれかのオプションで VertxHttpClientHTTPConduitFactory を設定することで、オプションで使用できるようになりました。

# Before Quarkus CXF 3.16.0, VertxHttpClientHTTPConduitFactory had to be set explicitly
# Set the HTTPConduitFactory per-client
quarkus.cxf.client."client-name".http-conduit-factory = VertxHttpClientHTTPConduitFactory
# Set the HTTPConduitFactory globally
quarkus.cxf.http-conduit-factory = VertxHttpClientHTTPConduitFactory

それ以降、改良とテストを行い、デフォルトの設定として指定されています。

Vert.x HttpClient ベースの HTTP Conduit をデフォルトとして使用する主な理由は次のとおりです。

# A configuration that worked before Quarkus CXF 3.16.0
quarkus.cxf.client.helloAllowAll.client-endpoint-url = https://localhost:8444/services/hello
quarkus.cxf.client.helloAllowAll.service-interface = io.quarkiverse.cxf.it.security.policy.HelloService
quarkus.cxf.client.helloAllowAll.trust-store = client-truststore.pkcs12
quarkus.cxf.client.helloAllowAll.trust-store-password = secret
quarkus.cxf.client.helloAllowAll.hostname-verifier = AllowAllHostnameVerifier

# An equivalent configuration for Quarkus CXF 3.16.0+
quarkus.tls.helloAllowAll.trust-store.p12.path = client-truststore.pkcs12
quarkus.tls.helloAllowAll.trust-store.p12.password = secret
quarkus.tls.helloAllowAll.hostname-verification-algorithm = NONE
quarkus.cxf.client.helloAllowAll.client-endpoint-url = https://localhost:8444/services/hello
quarkus.cxf.client.helloAllowAll.service-interface = io.quarkiverse.cxf.it.security.policy.HelloService
quarkus.cxf.client.helloAllowAll.tls-configuration-name = helloAllowAll

Quarkus CXF 3.17.0 より前では、VertxHttpClientHTTPConduit に基づく CXF クライアントは同期的にしか呼び出すことができませんでした。

@CXFClient("hello")
HelloService hello;

String callHello() {
    // Synchronous CXF client call
    hello.hello("Joe");
}

Quarkus CXF 3.17.0 では、VertxHttpClientHTTPConduit ベースのクライアントに非同期モードが導入されました。

import io.smallrye.mutiny.Uni;

@CXFClient("hello")
HelloService hello;

Uni<String> callHelloAsync() {
    return Uni.createFrom()
            // Asynchronous CXF client call returning java.util.concurrent.Future
            .future(hello.helloAsync("Joe"))
            .map(HelloResponse::getReturn);
}

これは、既存の Apache HttpClient 5 Async HTTP Transport とほぼ同じように動作します。主な違いは、(現在は非推奨となっている) io.quarkiverse.cxf:quarkus-cxf-rt-transports-http-hc5 依存関係をアプリケーションに追加する必要がなくなったことです。

組み込みの wsdl2java ツールを使用して 非同期メソッドを生成する 必要があります。

詳細は、非同期クライアント ページを確認してください。

Quarkus CXF 3.17.0 より前では、特定のクライアントに対して quarkus.cxf.client."client-name".auto-redirect が有効になっている場合でも、VertxHttpClientHTTPConduit ベースの CXF クライアントは HTTP リダイレクト (Location 応答ヘッダーを含む HTTP ステータスコード 301、302、303、および 307) に従いませんでした。

Quarkus CXF 3.17.0 では、この機能に加えて quarkus.cxf.client."client-name".max-retransmits の適切なサポートも追加されています。

新しい設定プロパティー quarkus.cxf.client."client-name".redirect-relative-uri が導入されました。これは、CXF ですでにサポートされている CXF クライアント要求コンテキストで http.redirect.relative.uri プロパティーを設定することと同じです。

詳細は quarkus.cxf.client."client-name".max-same-uri のドキュメントを確認してください。

@dcheng1248 の 貢献 に特に感謝します。

Quarkus CXF 3.17.0 では、VertxHttpClientHTTPConduit による リダイレクトのサポート が追加されました。これには、再送信のためにリクエスト本体の基本的なメモリー内キャッシュが含まれていました。Quarkus CXF 3.18.0 以降、VertxHttpClientHTTPConduit は、本体のサイズが設定可能なしきい値を超えた場合に、データをディスクにオフロードできるようになりました。新しい機能がどのように動作するかを確認するには、次の新しい設定オプションのドキュメントを確認してください。

Quarkus CXF 3.20.0 より前では、リモートサービスが 401 Unauthorized または 407 Proxy Authentication Required との応答が返されると、VertxHttpClientHTTPConduit でサポートされているクライアントは単に失敗していました。唯一の回避策は URLConnectionHTTPConduit などの他の HTTP conduit を使用することでした。

Quarkus CXF 3.20.0 以降、VertxHttpClientHTTPConduit は、次の 1 つ以上のオプションから派生した Authorization ヘッダー値を含む新しいリクエストを送信することにより、401 および 407 ステータスコードを適切に処理します。

Quarkus CXF 3.19.0 より前は、quarkus.cxf.client."client-name".tls-configuration-name または (現在は非推奨) quarkus.cxf.client."client-name".key-store* および quarkus.cxf.client."client-name".trust-store* オプションを使用してしか、CXF クライアントごとにトラストストアおよびキーストアを設定することができませんでした。

複数のクライアントがある場合、この設定は冗長になる可能性があります。

Quarkus CXF 3.19.0 以降では、quarkus.cxf.client.tls-configuration-name オプションを使用して、すべてのクライアントのトラストストアとキーストアを設定できます。

Quarkus CXF 3.19.0 より前では、quarkus-jdbc-Oracle を quarkus-cxf-integration-tracing-opentelemetry または quarkus-cxf-rt-ws-rm と 1 つのアプリケーションで組み合わせると、ネイティブイメージのビルド中に次のようなエラーが発生しました。

org.graalvm.compiler.debug.GraalError: com.oracle.graal.pointsto.constraints.UnsupportedFeatureException:
Detected a MBean server in the image heap. This is currently not supported, but could be changed in the future.
Management beans are registered in many global caches that would need to be cleared and properly re-built at image build time.
Class of disallowed object: com.sun.jmx.mbeanserver.JmxMBeanServer

Quarkus CXF 3.19.0 でこの問題は修正されました。

各サービスメソッドに対して、ビルド時にいくつかの補助クラスが生成されます。これらは、操作の要求または応答を表す場合があります。したがって、com.acme.HelloService.hello() メソッドでは、少なくとも 2 つのクラス com.acme.jaxws_asm.Hello と com.acme.jaxws_asm.HelloResponse が生成されます。Quarkus CXF 3.20.0 および CXF 4.1.1 より前では、サービスクラスの名前は考慮されませんでした。したがって、単一の Java パッケージ内に同じ名前のメソッドを含む複数のサービスインターフェイスがある場合、それらの補助クラスの名前が衝突することになります。つまり、これらのサービスの 1 つだけに適したクラスの 1 セットだけがアプリケーションに保存されることになります。実行時に、アプリケーションログに次のエラーメッセージが表示される場合があります。

java.lang.IllegalArgumentException: argument type mismatch
     at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
     at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
     at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
     at java.base/java.lang.reflect.Method.invoke(Method.java:568)
     at org.apache.cxf.databinding.AbstractWrapperHelper.createWrapperObject(AbstractWrapperHelper.java:114)
     at org.apache.cxf.jaxws.interceptors.WrapperClassOutInterceptor.handleMessage(WrapperClassOutInterceptor.java:91)
     at org.apache.cxf.phase.PhaseInterceptorChain.doIntercept(PhaseInterceptorChain.java:307)
     at org.apache.cxf.endpoint.ClientImpl.doInvoke(ClientImpl.java:530)
     at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:441)
     at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:356)
     at org.apache.cxf.endpoint.ClientImpl.invoke(ClientImpl.java:314)
     at org.apache.cxf.frontend.ClientProxy.invokeSync(ClientProxy.java:96)
     at org.apache.cxf.jaxws.JaxWsClientProxy.invoke(JaxWsClientProxy.java:140)
     at jdk.proxy6/jdk.proxy6.$Proxy132.hello(Unknown Source)

この問題は CXF 4.1.1 および Quarkus CXF 3.20.0 で修正されました。新しいバージョンでは、サービスクラスの名前が考慮されます。したがって、上記の例では、生成されるクラスの名前はそれぞれ com.acme.jaxws_asm.helloservice.Hello と com.acme.jaxws_asm.helloservice.HelloResponse です。

quarkus.cxf.http-conduit-factory と quarkus.cxf.client."client-name".http-conduit-factory の HttpClientHTTPConduitFactory 値は、Quarkus CXF 2.3.0 で導入されて以来存在しています。

HttpClientHTTPConduit hs、Quarkus CXF 内で実際に広く受け入れられることはありませんでした。CXF でこれがデフォルトとして使用され、#992、CXF-8885、CXF-8951、CXF-8946、CXF-8903 などのバグを回避するために、独自のデフォルト (URLConnectionHTTPConduitFactory) を導入せざるを得ませんでした。現在、Quarkus で非常に適切にサポートできる VertxHttpClientHTTPConduit があるため、HttpClientHTTPConduit にリソースを費やす理由はなくなりました。

HttpClientHTTPConduitFactory はドキュメントで非推奨としてマークされ、まだ使用しているユーザーのためにアプリケーションの起動時にいくつかの警告が追加されました。

io.quarkiverse.cxf:quarkus-cxf-rt-transports-http-hc5 エクステンションは、Quarkus CXF 3.19.0 以降非推奨となり、3.21.0 で削除される予定です。代わりに VertxHttpClientHTTPConduit の非同期モード を使用してください。

これは、今後に向けて Vert.x HttpClient に基づく単一の HTTP Conduit のみをサポートする弊社の取り組みの一環です。