第4章 Quarkus CXF エクステンションリファレンス

quarkus.cxf.codegen.wsdl2java.enabled

boolean

true

true の場合、デフォルトまたはカスタム定義された場所で WSDL リソースが見つかるたびに wsdl2java コード生成が実行されます。それ以外の場合は wsdl2java は実行されません。

環境変数:QUARKUS_CXF_CODEGEN_WSDL2JAVA_ENABLED
:Quarkus CXF: 2.0.0 以降

quarkus.cxf.codegen.wsdl2java.includes

string のリスト

wsdl2java ツールで処理する WSDL ファイルを選択するための glob パターンのコンマ区切りリスト。このパスは、現在の Maven または Gradle モジュールの src/main/resources または src/test/resources ディレクトリーからの相対パスとなります。glob 構文は io.quarkus.util.GlobUtil で指定されます。

例:

# Parameters for foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.includes = wsdl/foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.wsdl-location = wsdl/foo.wsdl
# Parameters for bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.includes = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.wsdl-location = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.xjc = ts

# Parameters for foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.includes = wsdl/foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.wsdl-location = wsdl/foo.wsdl
# Parameters for bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.includes = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.wsdl-location = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.xjc = ts

このオプションにはデフォルト値がないため、wsdl2java コード生成はデフォルトで無効になっています。

include を設定せずに quarkus.cxf.codegen.wsdl2java.my-name.excludes を指定すると、ビルド時にエラーが発生します。

quarkus.cxf.codegen.wsdl2java.includes と quarkus.cxf.codegen.wsdl2java.[whatever-name].includes によって選択されたファイルセットが重複していないことを確認します。そうでない場合、ビルド時に例外が発生します。

include と excludes が選択した src/main/resources からのファイルは、ネイティブイメージに自動的に含められるため、quarkus.cxf.wsdl-path (非推奨) または quarkus.native.resources.includes/excludes 経由で追加する必要はありません。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_INCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.codegen.wsdl2java.excludes

string のリスト

wsdl2java ツールで 処理しない WSDL ファイルを選択するためのパスパターンのコンマ区切りリスト。このパスは、現在の Maven または Gradle モジュールの src/main/resources または src/test/resources ディレクトリーからの相対パスとなります。構文は include と同じです。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_EXCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.codegen.wsdl2java.output-directory

string

生成されたファイルが書き込まれるディレクトリー。現在の Maven または Gradle モジュールディレクトリーに対する絶対ディレクトリーまたは相対ディレクトリーです。

デフォルト値はビルドツールに依存します。Maven の場合、通常は target/generated-sources/wsdl2java ですが、Gradle の場合は build/classes/java/quarkus-generated-sources/wsdl2java です。

Quarkus ツールでは、指定されたビルドツールのソースフォルダーとしてデフォルト値を設定することしかできません。これをカスタムパスに設定する場合、ユーザーが責任を持って、ビルドツールがパスをソースフォルダーとして認識していることを確認してください。

また、Maven の target ディレクトリー外のパス、または Gradle の build ディレクトリー外のパスを選択する場合は、以前のビルドによって生成された古いリソースをクリーンアップするように注意する必要があります。たとえば、package-names オプションの値を org.foo から org.bar に変更する場合は、古いパッケージ org.foo の削除に注意する必要があります。

これはオプション -d として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_OUTPUT_DIRECTORY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.codegen.wsdl2java.package-names

string のリスト

トークンのコンマ区切りリスト。各トークンは次のいずれかになります。

これはオプション -p として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_PACKAGE_NAMES
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.exclude-namespace-uris

string のリスト

Java コードを生成するときに無視する WSDL スキーマ名前空間 URI のコンマ区切りリスト。

これはオプション -nexclude として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_EXCLUDE_NAMESPACE_URIS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.service-name

string

生成されたコードに使用する WSDL サービス名。

これはオプション -sn として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_SERVICE_NAME
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.bindings

string のリスト

JAXWS または JAXB バインディングファイルまたは XMLBeans コンテキストファイルを指すパスのリスト。現在の Maven または Gradle モジュールに対する絶対パスまたは相対パス。

これはオプション -b として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_BINDINGS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.validate

boolean

false

true の場合、WSDL は処理前に検証されます。それ以外の場合、WSDL は検証されません。

これはオプション -validate として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_VALIDATE
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.wsdl-location

string

@WebServiceClient アノテーションの wsdlLocation プロパティーの値を指定します。

これはオプション -wsdlLocation として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_WSDL_LOCATION
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.xjc

string のリスト

有効にする XJC 拡張機能のコンマ区切りリスト。以下のエクステンションは、io.quarkiverse.cxf:quarkus-cxf-xjc-plugins 依存関係で利用できます。

これらの値は、-wsdl2java オプション -xjc-Xbg、-xjc-Xbgi、-xjc-Xdv、-xjc-Xjavadoc、-xjc-Xproperty-listener、-xjc-Xts、および -xjc-Xwsdlextension にそれぞれ対応します。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_XJC
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.exception-super

string

java.lang.Exception

wsdl:fault 要素から生成された Fault Bean のスーパークラスとして使用する完全修飾クラス名

これはオプション -exceptionSuper として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_EXCEPTION_SUPER
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.async-methods

string のリスト

非同期兄弟メソッドを生成する SEI メソッドのコンマ区切りリスト。JAX-WS バインディングファイルの enableAsyncMapping に似ています。

これはオプション -asyncMethods として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_ASYNC_METHODS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.bare-methods

string のリスト

ラッパースタイルの兄弟メソッドを生成する SEI メソッドのコンマ区切りリスト。JAX-WS バインディングファイルの enableWrapperStyle に似ています。

これはオプション -bareMethods として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_BARE_METHODS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.mime-methods

string のリスト

mime:content マッピングを有効にする SEI メソッドのコンマ区切りリスト。JAX-WS バインディングファイルの enableMIMEContent に類似しています。

これはオプション -mimeMethods として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_MIME_METHODS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java.additional-params

string のリスト

include および excludes によって選択されたファイルとともに、CXF wsdl2java ツールに渡される追加のコマンドラインパラメーターのコンマ区切りリスト。例: -keep,-dex,false。サポートされているすべてのオプションは、wsdl2java のドキュメント を確認してください。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA_ADDITIONAL_PARAMS
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws.enabled

boolean

true

true の場合、includes および excludes オプションによって選択された Java クラスがあるたびに java2ws WSDL 生成が実行されます。それ以外の場合、java2ws は実行されません。

環境変数: QUARKUS_CXF_JAVA2WS_ENABLED
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws.includes

string のリスト

java2ws ツールで処理するクラス名を選択するための glob パターンのコンマ区切りリスト。glob 構文は io.quarkus.util.GlobUtil で指定されます。パターンは、org.acme.MyClass などの完全修飾クラス名と照合されます。

includes と excludes が適用されるクラス名の範囲は、次のように定義されます。1.Jandex で表示される クラスのみが考慮されます。2. それらの中から、@WebService でアノテーションが付けられたものだけが選択されます。

例:

アプリケーションに @WebService アノテーションが付けられた 2 つのクラスが含まれており、その両方が Jandex で表示されるとします。それらの名前は org.foo.FruitWebService と org.bar.HelloWebService です。

そのような場合:

# Parameters for the foo package
quarkus.cxf.java2ws.foo-params.includes = org.foo.*
quarkus.cxf.java2ws.foo-params.additional-params = -servicename,FruitService
# Parameters for the bar package
quarkus.cxf.java2ws.bar-params.includes = org.bar.*
quarkus.cxf.java2ws.bar-params.additional-params = -servicename,HelloService

# Parameters for the foo package
quarkus.cxf.java2ws.foo-params.includes = org.foo.*
quarkus.cxf.java2ws.foo-params.additional-params = -servicename,FruitService
# Parameters for the bar package
quarkus.cxf.java2ws.bar-params.includes = org.bar.*
quarkus.cxf.java2ws.bar-params.additional-params = -servicename,HelloService

このオプションにはデフォルト値がないため、java2ws WSDL 生成はデフォルトで無効になっています。

include を設定せずに quarkus.cxf.java2ws.excludes を指定すると、ビルド時にエラーが発生します。

quarkus.cxf.java2ws.includes と quarkus.cxf.java2ws.[whatever-name].includes によって選択されたクラス名が重複していないことを確認してください。そうでない場合、ビルド時に例外が発生します。

生成された WSDL ファイルをネイティブイメージに含める場合は、quarkus.native.resources.includes/excludes を使用して追加する必要があります。

環境変数: QUARKUS_CXF_JAVA2WS_INCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws.excludes

string のリスト

java2ws ツールで 処理しない Java クラス名を選択するための glob パターンのコンマ区切りリスト。構文は include と同じです。

環境変数: QUARKUS_CXF_JAVA2WS_EXCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws.additional-params

string のリスト

include および excludes によって選択されたファイルとともに CXF java2ws ツールに渡される追加のコマンドラインパラメーターのコンマ区切りリスト。例: -portname,12345。サポートされているすべてのオプションは、java2ws のドキュメント を確認してください。

環境変数: QUARKUS_CXF_JAVA2WS_ADDITIONAL_PARAMS
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws.wsdl-name-template

string

%CLASSES_DIR%/wsdl/%SIMPLE_CLASS_NAME%.wsdl

生成される WSDL ファイルの名前のテンプレート。

テンプレートで使用できるプレースホルダーは 4 つあります。

環境変数: QUARKUS_CXF_JAVA2WS_WSDL_NAME_TEMPLATE
Quarkus CXF: 2.0.0 以降

quarkus.cxf.path

string

/services

CXF リソースのデフォルトパス。

環境変数: QUARKUS_CXF_PATH
Quarkus CXF: 1.0.0 以降

quarkus.cxf.min-chunk-size

int

128

データの書き込み時に割り当てられるメモリーチャンクのサイズ (バイト単位)。

これは非常に高度な設定であり、アプリケーションの出力 IO 操作にどのように影響するかを正確に理解している場合に限り設定してください。

環境変数: QUARKUS_CXF_MIN_CHUNK_SIZE
Quarkus CXF: 2.6.0 以降

quarkus.cxf.output-buffer-size

int

8191

出力ストリームレスポンスバッファーのサイズ (バイト単位)。レスポンスがこれより大きく、content-length が指定されていない場合、レスポンスはチャンク化されます。

この値を大きくすると、メモリー使用量は増えますが、レスポンスが大きい場合のパフォーマンスがわずかに向上する可能性があります。

環境変数: QUARKUS_CXF_OUTPUT_BUFFER_SIZE
Quarkus CXF: 2.6.0 以降

quarkus.cxf.http-conduit-factory

QuarkusCXFDefault、CXFDefault、VertxHttpClientHTTPConduitFactory、HttpClientHTTPConduitFactory、URLConnectionHTTPConduitFactory

quarkus.cxf.client."client-name".http-conduit-factory を介してこの設定をオーバーライドするクライアントを除くすべてのクライアントに対して HTTPConduitFactory 実装を選択します。

環境変数: QUARKUS_CXF_HTTP_CONDUIT_FACTORY
Quarkus CXF: 2.3.0 以降

quarkus.cxf.decoupled-endpoint-base

string

quarkus.cxf.client."client-name".decoupled-endpoint の接頭辞として使用する URI ベース。通常は、次のように設定します。

quarkus.cxf.decoupled-endpoint-base = https://api.example.com:${quarkus.http.ssl-port}${quarkus.cxf.path}
# or for plain HTTP
quarkus.cxf.decoupled-endpoint-base = http://api.example.com:${quarkus.http.port}${quarkus.cxf.path}

quarkus.cxf.decoupled-endpoint-base = https://api.example.com:${quarkus.http.ssl-port}${quarkus.cxf.path}
# or for plain HTTP
quarkus.cxf.decoupled-endpoint-base = http://api.example.com:${quarkus.http.port}${quarkus.cxf.path}

HTTP ハンドラー内から WS クライアントを呼び出す場合は、このオプションは指定せず、代わりに org.apache.cxf.ws.addressing.decoupled.endpoint.base キーを使用して WS クライアントのリクエストコンテキストで動的に設定できます。RESTeasy ハンドラーメソッドからこれを行う方法の例を次に示します。

import java.util.Map;
import jakarta.inject.Inject;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.Context;
import jakarta.ws.rs.core.MediaType;
import jakarta.ws.rs.core.UriInfo;
import jakarta.xml.ws.BindingProvider;
import io.quarkiverse.cxf.annotation.CXFClient;
import org.eclipse.microprofile.config.inject.ConfigProperty;

@Path("/my-rest")
public class MyRestEasyResource {

    @Inject
    @CXFClient("hello")
    HelloService helloService;

    @ConfigProperty(name = "quarkus.cxf.path")
                     String quarkusCxfPath;

    @POST
    @Path("/hello")
    @Produces(MediaType.TEXT_PLAIN)
        public String hello(String body, @Context UriInfo uriInfo) throws IOException {

        // You may consider doing this only once if you are sure that your service is accessed
        // through a single hostname
        String decoupledEndpointBase = uriInfo.getBaseUriBuilder().path(quarkusCxfPath);
        Map>String, Object< requestContext = ((BindingProvider)
        helloService).getRequestContext();
        requestContext.put("org.apache.cxf.ws.addressing.decoupled.endpoint.base",
        decoupledEndpointBase);

        return wsrmHelloService.hello(body);
    }
}

import java.util.Map;
import jakarta.inject.Inject;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.Context;
import jakarta.ws.rs.core.MediaType;
import jakarta.ws.rs.core.UriInfo;
import jakarta.xml.ws.BindingProvider;
import io.quarkiverse.cxf.annotation.CXFClient;
import org.eclipse.microprofile.config.inject.ConfigProperty;

@Path("/my-rest")
public class MyRestEasyResource {

    @Inject
    @CXFClient("hello")
    HelloService helloService;

    @ConfigProperty(name = "quarkus.cxf.path")
                     String quarkusCxfPath;

    @POST
    @Path("/hello")
    @Produces(MediaType.TEXT_PLAIN)
        public String hello(String body, @Context UriInfo uriInfo) throws IOException {

        // You may consider doing this only once if you are sure that your service is accessed
        // through a single hostname
        String decoupledEndpointBase = uriInfo.getBaseUriBuilder().path(quarkusCxfPath);
        Map>String, Object< requestContext = ((BindingProvider)
        helloService).getRequestContext();
        requestContext.put("org.apache.cxf.ws.addressing.decoupled.endpoint.base",
        decoupledEndpointBase);

        return wsrmHelloService.hello(body);
    }
}

Environment variable: QUARKUS_CXF_DECOUPLED_ENDPOINT_BASE
Quarkus CXF: 2.7.0 以降

quarkus.cxf.logging.enabled-for

clients、services、both、none

none

メッセージロギングを有効にする対象 (クライアント、サービス、両方、該当なし) を指定します。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.enabled または quarkus.cxf.client."client-name".logging.enabled を使用して、クライアントまたはサービスエンドポイントごとに上書きできます。

環境変数: QUARKUS_CXF_LOGGING_ENABLED_FOR
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.pretty

boolean

false

true の場合、XML 要素がログ内でインデントされます。そうでない場合は、インデントされずに表示されます。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.pretty または quarkus.cxf.client."client-name".logging.pretty を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_PRETTY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.limit

int

49152

ログ内で切り捨てられるメッセージの長さ (バイト単位)。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.limit または quarkus.cxf.client."client-name".logging.limit を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_LIMIT
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.in-mem-threshold

long

-1

ディスクに書き込まれるメッセージの長さ (バイト単位)。-1 は無制限を意味します。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.in-mem-threshold または quarkus.cxf.client."client-name".logging.in-mem-threshold を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_IN_MEM_THRESHOLD
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.log-binary

boolean

false

true の場合はバイナリーペイロードがログに記録され、そうでない場合は記録されません。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.log-binary または quarkus.cxf.client."client-name".logging.log-binary を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_LOG_BINARY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.log-multipart

boolean

true

true の場合はマルチパートペイロードがログに記録され、そうでない場合は記録されません。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.log-multipart または quarkus.cxf.client."client-name".logging.log-multipart を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_LOG_MULTIPART
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.verbose

boolean

true

true の場合は詳細なロギングが有効になり、そうでない場合は有効になりません。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.verbose または quarkus.cxf.client."client-name".logging.verbose を使用して、クライアントまたはサービスエンドポイントごとに上書きできます。

環境変数: QUARKUS_CXF_LOGGING_VERBOSE
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.in-binary-content-media-types

string のリスト

LoggingInInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。この設定は、quarkus.cxf.endpoint."/endpoint-path".logging.in-binary-content-media-types または quarkus.cxf.client."client-name".logging.in-binary-content-media-types を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_IN_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.out-binary-content-media-types

string のリスト

LoggingOutInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。この設定は、quarkus.cxf.endpoint."/endpoint-path".logging.out-binary-content-media-types または quarkus.cxf.client."client-name".logging.out-binary-content-media-types を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_OUT_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.binary-content-media-types

string のリスト

LoggingOutInterceptor および LoggingInInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.binary-content-media-types または quarkus.cxf.client."client-name".logging.binary-content-media-types を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.sensitive-element-names

string のリスト

ログでマスクされる機密情報を含む XML 要素のコンマ区切りリスト。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.sensitive-element-names または quarkus.cxf.client."client-name".logging.sensitive-element-names を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_SENSITIVE_ELEMENT_NAMES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.logging.sensitive-protocol-header-names

string のリスト

ログでマスクされる機密情報を含むプロトコルヘッダーのコンマ区切りリスト。この設定は quarkus.cxf.endpoint."/endpoint-path".logging.sensitive-protocol-header-names または quarkus.cxf.client."client-name".logging.sensitive-protocol-header-names を使用して、クライアントまたはサービスエンドポイントごとにオーバーライドできます。

環境変数: QUARKUS_CXF_LOGGING_SENSITIVE_PROTOCOL_HEADER_NAMES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".includes

string のリスト

wsdl2java ツールで処理する WSDL ファイルを選択するための glob パターンのコンマ区切りリスト。このパスは、現在の Maven または Gradle モジュールの src/main/resources または src/test/resources ディレクトリーからの相対パスとなります。glob 構文は io.quarkus.util.GlobUtil で指定されます。

例:

# Parameters for foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.includes = wsdl/foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.wsdl-location = wsdl/foo.wsdl
# Parameters for bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.includes = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.wsdl-location = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.xjc = ts

# Parameters for foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.includes = wsdl/foo.wsdl
quarkus.cxf.codegen.wsdl2java.foo-params.wsdl-location = wsdl/foo.wsdl
# Parameters for bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.includes = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.wsdl-location = wsdl/bar.wsdl
quarkus.cxf.codegen.wsdl2java.bar-params.xjc = ts

このオプションにはデフォルト値がないため、wsdl2java コード生成はデフォルトで無効になっています。

include を設定せずに quarkus.cxf.codegen.wsdl2java.my-name.excludes を指定すると、ビルド時にエラーが発生します。

quarkus.cxf.codegen.wsdl2java.includes と quarkus.cxf.codegen.wsdl2java.[whatever-name].includes によって選択されたファイルセットが重複していないことを確認します。そうでない場合、ビルド時に例外が発生します。

include と excludes が選択した src/main/resources からのファイルは、ネイティブイメージに自動的に含められるため、quarkus.cxf.wsdl-path (非推奨) または quarkus.native.resources.includes/excludes 経由で追加する必要はありません。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__INCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".excludes

string のリスト

wsdl2java ツールで 処理しない WSDL ファイルを選択するためのパスパターンのコンマ区切りリスト。このパスは、現在の Maven または Gradle モジュールの src/main/resources または src/test/resources ディレクトリーからの相対パスとなります。構文は include と同じです。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__EXCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".output-directory

string

生成されたファイルが書き込まれるディレクトリー。現在の Maven または Gradle モジュールディレクトリーに対する絶対ディレクトリーまたは相対ディレクトリーです。

デフォルト値はビルドツールに依存します。Maven の場合、通常は target/generated-sources/wsdl2java ですが、Gradle の場合は build/classes/java/quarkus-generated-sources/wsdl2java です。

Quarkus ツールでは、指定されたビルドツールのソースフォルダーとしてデフォルト値を設定することしかできません。これをカスタムパスに設定する場合、ユーザーが責任を持って、ビルドツールがパスをソースフォルダーとして認識していることを確認してください。

また、Maven の target ディレクトリー外のパス、または Gradle の build ディレクトリー外のパスを選択する場合は、以前のビルドによって生成された古いリソースをクリーンアップするように注意する必要があります。たとえば、package-names オプションの値を org.foo から org.bar に変更する場合は、古いパッケージ org.foo の削除に注意する必要があります。

これはオプション -d として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__OUTPUT_DIRECTORY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".package-names

string のリスト

トークンのコンマ区切りリスト。各トークンは次のいずれかになります。

これはオプション -p として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__PACKAGE_NAMES
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".exclude-namespace-uris

string のリスト

Java コードを生成するときに無視する WSDL スキーマ名前空間 URI のコンマ区切りリスト。

これはオプション -nexclude として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__EXCLUDE_NAMESPACE_URIS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".service-name

string

生成されたコードに使用する WSDL サービス名。

これはオプション -sn として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__SERVICE_NAME
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".bindings

string のリスト

JAXWS または JAXB バインディングファイルまたは XMLBeans コンテキストファイルを指すパスのリスト。現在の Maven または Gradle モジュールに対する絶対パスまたは相対パス。

これはオプション -b として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__BINDINGS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".validate

boolean

false

true の場合、WSDL は処理前に検証されます。それ以外の場合、WSDL は検証されません。

これはオプション -validate として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__VALIDATE
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".wsdl-location

string

@WebServiceClient アノテーションの wsdlLocation プロパティーの値を指定します。

これはオプション -wsdlLocation として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__WSDL_LOCATION
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".xjc

string のリスト

有効にする XJC 拡張機能のコンマ区切りリスト。以下のエクステンションは、io.quarkiverse.cxf:quarkus-cxf-xjc-plugins 依存関係で利用できます。

これらの値は、-wsdl2java オプション -xjc-Xbg、-xjc-Xbgi、-xjc-Xdv、-xjc-Xjavadoc、-xjc-Xproperty-listener、-xjc-Xts、および -xjc-Xwsdlextension にそれぞれ対応します。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__XJC
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".exception-super

string

java.lang.Exception

wsdl:fault 要素から生成された Fault Bean のスーパークラスとして使用する完全修飾クラス名

これはオプション -exceptionSuper として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__EXCEPTION_SUPER
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".async-methods

string のリスト

非同期兄弟メソッドを生成する SEI メソッドのコンマ区切りリスト。JAX-WS バインディングファイルの enableAsyncMapping に似ています。

これはオプション -asyncMethods として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__ASYNC_METHODS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".bare-methods

string のリスト

ラッパースタイルの兄弟メソッドを生成する SEI メソッドのコンマ区切りリスト。JAX-WS バインディングファイルの enableWrapperStyle に似ています。

これはオプション -bareMethods として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__BARE_METHODS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".mime-methods

string のリスト

mime:content マッピングを有効にする SEI メソッドのコンマ区切りリスト。JAX-WS バインディングファイルの enableMIMEContent に類似しています。

これはオプション -mimeMethods として wsdl2java に渡されます

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__MIME_METHODS
Quarkus CXF: 2.4.0 以降

quarkus.cxf.codegen.wsdl2java."named-parameter-sets".additional-params

string のリスト

include および excludes によって選択されたファイルとともに、CXF wsdl2java ツールに渡される追加のコマンドラインパラメーターのコンマ区切りリスト。例: -keep,-dex,false。サポートされているすべてのオプションは、wsdl2java のドキュメント を確認してください。

環境変数: QUARKUS_CXF_CODEGEN_WSDL2JAVA__NAMED_PARAMETER_SETS__ADDITIONAL_PARAMS
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws."named-parameter-sets".includes

string のリスト

java2ws ツールで処理するクラス名を選択するための glob パターンのコンマ区切りリスト。glob 構文は io.quarkus.util.GlobUtil で指定されます。パターンは、org.acme.MyClass などの完全修飾クラス名と照合されます。

includes と excludes が適用されるクラス名の範囲は、次のように定義されます。1.Jandex で表示される クラスのみが考慮されます。2. それらの中から、@WebService でアノテーションが付けられたものだけが選択されます。

例:

アプリケーションに @WebService アノテーションが付けられた 2 つのクラスが含まれており、その両方が Jandex で表示されるとします。それらの名前は org.foo.FruitWebService と org.bar.HelloWebService です。

そのような場合:

# Parameters for the foo package
quarkus.cxf.java2ws.foo-params.includes = org.foo.*
quarkus.cxf.java2ws.foo-params.additional-params = -servicename,FruitService
# Parameters for the bar package
quarkus.cxf.java2ws.bar-params.includes = org.bar.*
quarkus.cxf.java2ws.bar-params.additional-params = -servicename,HelloService

# Parameters for the foo package
quarkus.cxf.java2ws.foo-params.includes = org.foo.*
quarkus.cxf.java2ws.foo-params.additional-params = -servicename,FruitService
# Parameters for the bar package
quarkus.cxf.java2ws.bar-params.includes = org.bar.*
quarkus.cxf.java2ws.bar-params.additional-params = -servicename,HelloService

このオプションにはデフォルト値がないため、java2ws WSDL 生成はデフォルトで無効になっています。

include を設定せずに quarkus.cxf.java2ws.excludes を指定すると、ビルド時にエラーが発生します。

quarkus.cxf.java2ws.includes と quarkus.cxf.java2ws.[whatever-name].includes によって選択されたクラス名が重複していないことを確認してください。そうでない場合、ビルド時に例外が発生します。

生成された WSDL ファイルをネイティブイメージに含める場合は、quarkus.native.resources.includes/excludes を使用して追加する必要があります。

環境変数: QUARKUS_CXF_JAVA2WS__NAMED_PARAMETER_SETS__INCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws."named-parameter-sets".excludes

string のリスト

java2ws ツールで 処理しない Java クラス名を選択するための glob パターンのコンマ区切りリスト。構文は include と同じです。

環境変数: QUARKUS_CXF_JAVA2WS__NAMED_PARAMETER_SETS__EXCLUDES
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws."named-parameter-sets".additional-params

string のリスト

include および excludes によって選択されたファイルとともに CXF java2ws ツールに渡される追加のコマンドラインパラメーターのコンマ区切りリスト。例: -portname,12345。サポートされているすべてのオプションは、java2ws のドキュメント を確認してください。

環境変数: QUARKUS_CXF_JAVA2WS__NAMED_PARAMETER_SETS__ADDITIONAL_PARAMS
Quarkus CXF: 2.0.0 以降

quarkus.cxf.java2ws."named-parameter-sets".wsdl-name-template

string

%CLASSES_DIR%/wsdl/%SIMPLE_CLASS_NAME%.wsdl

生成される WSDL ファイルの名前のテンプレート。

テンプレートで使用できるプレースホルダーは 4 つあります。

環境変数: QUARKUS_CXF_JAVA2WS__NAMED_PARAMETER_SETS__WSDL_NAME_TEMPLATE
Quarkus CXF: 2.0.0 以降

quarkus.cxf.client."client-name".service-interface

string

クライアントサービスインターフェイスクラス名

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__SERVICE_INTERFACE
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".alternative

boolean

false

これが代替プロキシークライアント設定であるかどうかを示します。true の場合、アノテーション @CXFClient なしでクライアントを設定するときにこの設定は無視されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__ALTERNATIVE
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".native.runtime-initialized

boolean

false

true の場合、ネイティブコンパイラーにより生成されたクライアント動的プロキシークラスは実行時に初期化されます。そうでない場合、プロキシークラスはビルド時に初期化されます。

サービスエンドポイントインターフェイスがメソッドシグネチャー内で実行時に初期化されるクラスを参照する場合は、これを true に設定します。たとえば、サービスインターフェイスに int add(Operands o) メソッドがあり、Operands クラスに対して実行時の初期化がリクエストされたとします。このとき、この設定パラメーターが true に設定されていなければ、ネイティブコンパイラーは Classes that should be initialized at run time got initialized during image building: org.acme.Operands …​ jdk.proxy<some-number>.$Proxy<some-number> caused initialization of this class のような例外をスローします。jdk.proxy<some-number>.$Proxy<some-number> は、ネイティブコンパイラーにより生成されたプロキシークラスです。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__NATIVE_RUNTIME_INITIALIZED
Quarkus CXF: 2.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".implementor

string

サービスエンドポイント実装クラス

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__IMPLEMENTOR
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".wsdl

string

サービスエンドポイント WSDL パス

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__WSDL
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".soap-binding

string

SOAP バインディングの URL は、次の 4 つの値のいずれかになります。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__SOAP_BINDING
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".published-endpoint-url

string

公開されたサービスエンドポイント URL

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__PUBLISHED_ENDPOINT_URL
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.enabled

true、false、pretty

true または pretty の場合はメッセージのロギングが有効になり、それ以外の場合は有効になりません。値が pretty (2.7.0 以降) の場合、pretty 属性は実際には true に設定されます。デフォルトは quarkus.cxf.logging.enabled-for で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_ENABLED
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.pretty

boolean

true の場合、XML 要素がログ内でインデントされます。そうでない場合は、インデントされずに表示されます。デフォルトは quarkus.cxf.logging.pretty で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_PRETTY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.limit

int

ログ内で切り捨てられるメッセージの長さ (バイト単位)。デフォルトは quarkus.cxf.logging.limit で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_LIMIT
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.in-mem-threshold

long

ディスクに書き込まれるメッセージの長さ (バイト単位)。-1 は無制限を意味します。デフォルトは quarkus.cxf.logging.in-mem-threshold で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_IN_MEM_THRESHOLD
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.log-binary

boolean

true の場合はバイナリーペイロードがログに記録され、そうでない場合は記録されません。デフォルトは quarkus.cxf.logging.log-binary で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_LOG_BINARY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.log-multipart

boolean

true の場合はマルチパートペイロードがログに記録され、そうでない場合は記録されません。デフォルトは quarkus.cxf.logging.log-multipart で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_LOG_MULTIPART
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.verbose

boolean

true の場合は詳細なロギングが有効になり、そうでない場合は有効になりません。デフォルトは quarkus.cxf.logging.verbose で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_VERBOSE
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.in-binary-content-media-types

string のリスト

LoggingInInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。デフォルトは quarkus.cxf.logging.in-binary-content-media-types で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_IN_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.out-binary-content-media-types

string のリスト

LoggingOutInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。デフォルトは quarkus.cxf.logging.out-binary-content-media-types で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_OUT_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.binary-content-media-types

string のリスト

LoggingOutInterceptor および LoggingInInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。デフォルトは quarkus.cxf.logging.binary-content-media-types で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.sensitive-element-names

string のリスト

ログでマスクされる機密情報を含む XML 要素のコンマ区切りリスト。デフォルトは quarkus.cxf.logging.sensitive-element-names で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_SENSITIVE_ELEMENT_NAMES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".logging.sensitive-protocol-header-names

string のリスト

ログでマスクされる機密情報を含むプロトコルヘッダーのコンマ区切りリスト。デフォルトは quarkus.cxf.logging.sensitive-protocol-header-names で指定されます。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__LOGGING_SENSITIVE_PROTOCOL_HEADER_NAMES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.endpoint."/endpoint-path".features

string のリスト

完全修飾 CXF Feature クラス名または名前付き CDI Bean のコンマ区切りリスト。

例:

quarkus.cxf.endpoint."/hello".features = org.apache.cxf.ext.logging.LoggingFeature
quarkus.cxf.endpoint."/fruit".features = #myCustomLoggingFeature

quarkus.cxf.endpoint."/hello".features = org.apache.cxf.ext.logging.LoggingFeature
quarkus.cxf.endpoint."/fruit".features = #myCustomLoggingFeature

2 番目の場合、#myCustomLoggingFeature Bean は次のように生成できます。

import org.apache.cxf.ext.logging.LoggingFeature;
import javax.enterprise.context.ApplicationScoped;
import javax.enterprise.inject.Produces;

class Producers {

    @Produces
    @ApplicationScoped
    LoggingFeature myCustomLoggingFeature() {
        LoggingFeature loggingFeature = new LoggingFeature();
        loggingFeature.setPrettyLogging(true);
        return loggingFeature;
    }
}

import org.apache.cxf.ext.logging.LoggingFeature;
import javax.enterprise.context.ApplicationScoped;
import javax.enterprise.inject.Produces;

class Producers {

    @Produces
    @ApplicationScoped
    LoggingFeature myCustomLoggingFeature() {
        LoggingFeature loggingFeature = new LoggingFeature();
        loggingFeature.setPrettyLogging(true);
        return loggingFeature;
    }
}

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__FEATURES
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".handlers

string のリスト

Handler クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__HANDLERS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".in-interceptors

string のリスト

InInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__IN_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".out-interceptors

string のリスト

OutInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__OUT_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".out-fault-interceptors

string のリスト

OutFaultInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__OUT_FAULT_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".in-fault-interceptors

string のリスト

InFaultInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__IN_FAULT_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.endpoint."/endpoint-path".schema-validation.enabled-for

in、request、out、response、both、none

XML スキーマ検証を有効にするメッセージを選択します。指定されていない場合、@org.apache.cxf.annotations.SchemaValidation や @org.apache.cxf.annotations.EndpointProperty(key = "schema-validation-enabled", value = "true") アノテーションなどの他の手段で有効にされていない限り、XML スキーマ検証は適用されません。

環境変数: QUARKUS_CXF_ENDPOINT___ENDPOINT_PATH__SCHEMA_VALIDATION_ENABLED_FOR
Quarkus CXF: 2.7.0 以降

quarkus.cxf.client."client-name".wsdl

string

このクライアントのサービスプロキシーを生成する際に使用する WSDL ドキュメントを指す URL、リソースパス、またはローカルファイルシステムパス。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__WSDL
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".soap-binding

string

SOAP バインディングの URL は、次の 4 つの値のいずれかになります。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__SOAP_BINDING
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".client-endpoint-url

string

クライアントエンドポイント URL

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CLIENT_ENDPOINT_URL
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".endpoint-namespace

string

クライアントエンドポイントの namespace

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__ENDPOINT_NAMESPACE
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".endpoint-name

string

クライアントエンドポイントの名前

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__ENDPOINT_NAME
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".username

string

HTTP Basic 認証のユーザー名

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__USERNAME
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".password

string

HTTP Basic 認証のパスワード

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__PASSWORD
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".secure-wsdl-access

boolean

false

true の場合、username が設定されていれば WSDL をリクエストする際に Authentication ヘッダーが事前に送信されます。そうでない場合、WSDL は匿名でリクエストされます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__SECURE_WSDL_ACCESS
Quarkus CXF: 2.7.0 以降

quarkus.cxf.client."client-name".logging.enabled

true、false、pretty

true または pretty の場合はメッセージのロギングが有効になり、それ以外の場合は有効になりません。値が pretty (2.7.0 以降) の場合、pretty 属性は実際には true に設定されます。デフォルトは quarkus.cxf.logging.enabled-for で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_ENABLED
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.pretty

boolean

true の場合、XML 要素がログ内でインデントされます。そうでない場合は、インデントされずに表示されます。デフォルトは quarkus.cxf.logging.pretty で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_PRETTY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.limit

int

ログ内で切り捨てられるメッセージの長さ (バイト単位)。デフォルトは quarkus.cxf.logging.limit で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_LIMIT
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.in-mem-threshold

long

ディスクに書き込まれるメッセージの長さ (バイト単位)。-1 は無制限を意味します。デフォルトは quarkus.cxf.logging.in-mem-threshold で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_IN_MEM_THRESHOLD
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.log-binary

boolean

true の場合はバイナリーペイロードがログに記録され、そうでない場合は記録されません。デフォルトは quarkus.cxf.logging.log-binary で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_LOG_BINARY
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.log-multipart

boolean

true の場合はマルチパートペイロードがログに記録され、そうでない場合は記録されません。デフォルトは quarkus.cxf.logging.log-multipart で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_LOG_MULTIPART
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.verbose

boolean

true の場合は詳細なロギングが有効になり、そうでない場合は有効になりません。デフォルトは quarkus.cxf.logging.verbose で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_VERBOSE
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.in-binary-content-media-types

string のリスト

LoggingInInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。デフォルトは quarkus.cxf.logging.in-binary-content-media-types で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_IN_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.out-binary-content-media-types

string のリスト

LoggingOutInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。デフォルトは quarkus.cxf.logging.out-binary-content-media-types で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_OUT_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.binary-content-media-types

string のリスト

LoggingOutInterceptor および LoggingInInterceptor のデフォルト値に追加する、追加のバイナリーメディアタイプのコンマ区切りリスト。log-binary が true の場合を除き、そのコンテンツはログに記録されません。デフォルトは quarkus.cxf.logging.binary-content-media-types で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_BINARY_CONTENT_MEDIA_TYPES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.sensitive-element-names

string のリスト

ログでマスクされる機密情報を含む XML 要素のコンマ区切りリスト。デフォルトは quarkus.cxf.logging.sensitive-element-names で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_SENSITIVE_ELEMENT_NAMES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".logging.sensitive-protocol-header-names

string のリスト

ログでマスクされる機密情報を含むプロトコルヘッダーのコンマ区切りリスト。デフォルトは quarkus.cxf.logging.sensitive-protocol-header-names で指定されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__LOGGING_SENSITIVE_PROTOCOL_HEADER_NAMES
Quarkus CXF: 2.6.0 以降

quarkus.cxf.client."client-name".features

string のリスト

完全修飾 CXF Feature クラス名のコンマ区切りリスト。

以下に例を示します。

quarkus.cxf.endpoint."/my-endpoint".features = org.apache.cxf.ext.logging.LoggingFeature

quarkus.cxf.endpoint."/my-endpoint".features = org.apache.cxf.ext.logging.LoggingFeature

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__FEATURES
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".handlers

string のリスト

Handler クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__HANDLERS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".in-interceptors

string のリスト

InInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__IN_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".out-interceptors

string のリスト

OutInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__OUT_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".out-fault-interceptors

string のリスト

OutFaultInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__OUT_FAULT_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".in-fault-interceptors

string のリスト

InFaultInterceptor クラスのコンマ区切りリスト

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__IN_FAULT_INTERCEPTORS
Quarkus CXF: 1.0.0 以降

quarkus.cxf.client."client-name".connection-timeout

long

30000

タイムアウトするまでにコンシューマーが接続の確立を試みる期間 (ミリ秒単位) を指定します。0 は無限を意味します。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CONNECTION_TIMEOUT
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".receive-timeout

long

60000

コンシューマーがタイムアウトするまでの応答を待つ期間 (ミリ秒単位) を指定します。0 は無限を意味します。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__RECEIVE_TIMEOUT
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".connection-request-timeout

long

60000

Connection Manager からの接続を要求する場合に使用する時間 (ミリ秒単位) を指定します (該当する場合)。0 は無限を意味します。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CONNECTION_REQUEST_TIMEOUT
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".auto-redirect

boolean

false

コンシューマーが、サーバーが発行するリダイレクトに自動的に従うかどうかを指定します (名前は標準の一部ではありません)。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__AUTO_REDIRECT
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".max-retransmits

int

-1

リダイレクトに許可される再送信の最大回数を指定します。再送信回数には、認証のための再送信も含まれます。各リダイレクトにより、UNAUTHORIZED 応答コード (つまり 401) の再送信が発生する可能性があります。負の数値は再送信回数が無制限であることを示します。ただし、ループ保護が提供されます。デフォルトは無制限です (名前は標準の一部ではありません)。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__MAX_RETRANSMITS
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".allow-chunking

boolean

true

true の場合、クライアントは必要に応じてチャンクストリームを自由に使用できますが、必ずしもチャンクストリームを使用する必要はありません。false の場合、クライアントは必ず通常のチャンク化されていないリクエストを使用する必要があります。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__ALLOW_CHUNKING
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".chunking-threshold

int

4096

AllowChunking が true の場合、メッセージのチャンク化が開始されるしきい値が設定されます。この制限を下回るメッセージはチャンク化されません。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CHUNKING_THRESHOLD
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".chunk-length

int

-1

HttpURLConnection のチャンク長を指定します。この値は、java.net.HttpURLConnection.setChunkedStreamingMode (int chunklen) で使用されます。chunklen は、各チャンクに書き込むバイト数を示します。chunklen が 0 以下の場合、デフォルト値が使用されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CHUNK_LENGTH
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".accept

string

クライアントが処理できる MIME タイプを指定します (例: HTML、JPEG、GIF など)

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__ACCEPT
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".accept-language

string

クライアントが希望する言語を指定します (例: English、French など)

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__ACCEPT_LANGUAGE
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".accept-encoding

string

クライアントが処理できるエンコーディングを指定します (例: gzip)

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__ACCEPT_ENCODING
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".content-type

string

POST リクエストで送信されるストリームのコンテンツタイプを指定します。(Web サービスの場合は text/xml にする必要がありますが、クライアントがフォームデータを送信する場合は application/x-www-form-urlencoded に設定できます。)

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CONTENT_TYPE
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".host

string

要求が呼び出されるリソースのインターネットホストおよびポート番号を指定します。デフォルトでは、これが URL に基づき送信されます。特定の DNS シナリオまたはアプリケーション設計では、これを設定するように要求される場合がありますが、通常は必要ありません。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__HOST
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".connection

close、keep-alive

keep-alive

接続の処理。close の場合は、各要求/応答ダイアログの後にサーバーへの接続が閉じられます。Keep-Alive の場合、クライアントはサーバーに対して接続を開いたままにするように要求し、サーバーがその keep alive 要求を受け入れると、接続が再利用されます。多くのサーバーとプロキシーは keep-alive 要求を受け入れません。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CONNECTION
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".cache-control

string

no-cache を指定するために使用されることがほとんどですが、要求に対して 12 個程度のキャッシュ関連のディレクティブが標準でサポートしされています。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__CACHE_CONTROL
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".version

string

auto

接続に使用される HTTP バージョン。デフォルト値 auto は、quarkus.cxf.client."client-name".http-conduit-factory で定義された HTTPConduit 実装のデフォルト値を使用します。その他の使用できる値: 1.1、2。

一部の HTTPConduit 実装では、一部の値がサポートされていない可能性があります。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__VERSION
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".browser-type

string

User-Agent HTTP ヘッダーの値。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__BROWSER_TYPE
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".decoupled-endpoint

string

別のプロバイダー コンシューマー接続を介して応答を受信するための URI パス (/ で始まる) または完全な URI。値が / で始まる場合、quarkus.cxf.client."client-name".decoupled-endpoint-base で設定されたベース URI が接頭辞として付加されてから、WS-Addressing ReplyTo メッセージヘッダーの値として使用されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__DECOUPLED_ENDPOINT
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".proxy-server

string

プロキシーサーバーが使用されている場合は、そのアドレスを指定します。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__PROXY_SERVER
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".proxy-server-port

int

プロキシーサーバーが使用するポート番号を指定します。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__PROXY_SERVER_PORT
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".non-proxy-hosts

string

プロキシー設定を使用しないホスト名のリストを指定します。例:

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__NON_PROXY_HOSTS
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".proxy-server-type

http、socks

http

プロキシーサーバーのタイプを指定します。HTTP または SOCKS を使用できます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__PROXY_SERVER_TYPE
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".proxy-username

string

プロキシー認証のユーザー名

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__PROXY_USERNAME
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".proxy-password

string

プロキシー認証のパスワード

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__PROXY_PASSWORD
Quarkus CXF: 2.2.3 以降

quarkus.cxf.client."client-name".http-conduit-factory

QuarkusCXFDefault、CXFDefault、VertxHttpClientHTTPConduitFactory、HttpClientHTTPConduitFactory、URLConnectionHTTPConduitFactory

このクライアントの HTTPConduitFactory 実装を選択します。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__HTTP_CONDUIT_FACTORY
Quarkus CXF: 2.3.0 以降

quarkus.cxf.client."client-name".key-store

string

このクライアントのキーストアの場所です。リソースは最初にクラスパスで検索され、次にファイルシステムで検索されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__KEY_STORE
Quarkus CXF: 3.8.1 以降

quarkus.cxf.client."client-name".key-store-password

string

キーストアのパスワード

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__KEY_STORE_PASSWORD
Quarkus CXF: 3.8.1 以降

quarkus.cxf.client."client-name".key-store-type

string

JKS

キーストアのタイプ。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__KEY_STORE_TYPE
Quarkus CXF: 3.8.1 以降

quarkus.cxf.client."client-name".key-password

string

キーのパスワード。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__KEY_PASSWORD
Quarkus CXF: 3.8.1 以降

quarkus.cxf.client."client-name".trust-store

string

このクライアントのトラストストアの場所です。リソースは最初にクラスパスで検索され、次にファイルシステムで検索されます。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__TRUST_STORE
Quarkus CXF: 2.5.0 以降

quarkus.cxf.client."client-name".trust-store-password

string

トラストストアのパスワード。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__TRUST_STORE_PASSWORD
Quarkus CXF: 2.5.0 以降

quarkus.cxf.client."client-name".trust-store-type

string

JKS

トラストストアのタイプ。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__TRUST_STORE_TYPE
Quarkus CXF: 2.5.0 以降

quarkus.cxf.client."client-name".hostname-verifier

string

次のいずれかです。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__HOSTNAME_VERIFIER
Quarkus CXF: 2.5.0 以降

quarkus.cxf.client."client-name".schema-validation.enabled-for

in、request、out、response、both、none

XML スキーマ検証を有効にするメッセージを選択します。指定されていない場合、@org.apache.cxf.annotations.SchemaValidation や @org.apache.cxf.annotations.EndpointProperty(key = "schema-validation-enabled", value = "true") アノテーションなどの他の手段で有効にされていない限り、XML スキーマ検証は適用されません。

環境変数: QUARKUS_CXF_CLIENT__CLIENT_NAME__SCHEMA_VALIDATION_ENABLED_FOR
Quarkus CXF: 2.7.0 以降