27.5. エンドポイントオプション

beanId (common)

既存の設定済み CxfRsEndpoint を検索する場合。接頭辞として bean: を使用する必要があります。

String

address (common)

サービス公開アドレス。

String

features (common)

機能リストを CxfRs エンドポイントに設定します。

List

loggingFeatureEnabled (common)

このオプションは、インバウンドおよびアウトバウンドの REST メッセージをログに書き込む CXF ロギング機能を有効にします。

false

boolean

loggingSizeLimit (common)

ロギング機能が有効になっているときにロガーが出力するバイト数の合計サイズを制限します。

int

modelRef (common)

このオプションは、アノテーションのないリソースクラスに役立つモデルファイルを指定するために使用されます。このオプションを使用する場合、サービスクラスを省略して、ドキュメントのみのエンドポイントをエミュレートできます。

String

providers (common)

カスタム JAX-RS プロバイダーリストを CxfRs エンドポイントに設定します。コンマで区切られたレジストリーで検索するプロバイダーのリストを含む文字列を指定できます。

String

resourceClasses (common)

REST サービスとしてエクスポートするリソースクラス。複数のクラスはコンマで区切ることができます。

List

schemaLocations (common)

着信 XML または JAXB 駆動型 JSON の検証に使用できるスキーマのロケーションを設定します。

List

skipFaultLogging (common)

このオプションは、PhaseInterceptorChain がキャッチした Fault のログ記録をスキップするかどうかを制御します。

false

boolean

bindingStyle (consumer)

リクエストとレスポンスが Camel との間でどのようにマッピングされるかを設定します。2 つの値が可能です: SimpleConsumer: このバインディングスタイルは、リクエストパラメーター、マルチパートなどを処理し、それらを IN ヘッダー、IN 添付、およびメッセージボディーにマップします。org.apache.cxf.message.MessageContentsList の低レベル処理を排除することを目的としています。また、レスポンスマッピングの柔軟性とシンプルさも向上します。一般コンシューマーのみご利用いただけます。デフォルト: デフォルトのスタイル。コンシューマーの場合、これにより MessageContentsList がルートに渡され、ルートで低レベルの処理が必要になります。これは従来のバインディングスタイルで、CXF スタックから入ってくる org.apache.cxf.message.MessageContentsList を IN メッセージボディーに単純にダンプします。ユーザーは、JAX-RS メソッド署名によって定義されたコントラクトに従ってそれを処理する責任があります。カスタム: バインディングオプションを介してカスタムバインディングを指定できます。

列挙値:

デフォルト

BindingStyle

publishedEndpointUrl (consumer)

このオプションは、リソースアドレス URL と _wadl でアクセスできる WADL から発行された endpointUrl をオーバーライドできます。

String

bridgeErrorHandler (consumer (advanced))

コンシューマーを Camel ルーティングエラーハンドラーにブリッジすることを可能にします。つまり、Camel コンシューマーが受信メッセージなどを取得しようとしているときに発生した例外 (可能な場合) は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されるようになります。重要: これは、サードパーティーコンポーネントが例外が出力された場合に Camel に警告することを許可している場合にのみ可能です。一部のコンポーネントはこれを内部でのみ処理するため、bridgeErrorHandler は使用できません。他の状況では、Camel コンポーネントを改良してサードパーティーコンポーネントに接続し、今後のリリースでこれを可能にする可能性があります。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。

false

boolean

exceptionHandler (consumer (advanced))

consumer によるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されないことに注意してください。デフォルトでは、consumer は例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。

ExceptionHandler

exchangePattern (consumer (advanced))

consumer がエクスチェンジを作成する際に交換パターンを設定します。

列挙値:

ExchangePattern

serviceBeans (consumer (advanced))

REST サービスとしてエクスポートするサービス Bean (レジストリーで検索する Bean ID)。複数の Bean はコンマで区切ることができます。

String

cookieHandler (producer)

HTTP セッションを維持するように Cookie ハンドラーを設定します。

CookieHandler

hostnameVerifier (producer)

使用するホスト名ベリファイア。# 表記を使用して、レジストリーから HostnameVerifier を参照します。

HostnameVerifier

sslContextParameters (producer)

Camel SSL 設定リファレンス。# 表記を使用して、SSL コンテキストを参照します。

SSLContextParameters

throwExceptionOnFailure (producer)

このオプションは、CxfRsProducer に戻りコードを検査するように指示し、戻りコードが 207 より大きい場合は例外を生成します。

true

boolean

httpClientAPI (producer (advanced))

true の場合、CxfRsProducer は HttpClientAPI を使用してサービスを呼び出します。false の場合、CxfRsProducer は ProxyClientAPI を使用してサービスを呼び出します。

true

boolean

ignoreDeleteMethodMessageBody (producer (advanced))

このオプションは、HTTP API の使用時に DELETE メソッドのメッセージ本文を無視するように CxfRsProducer に指示するために使用されます。

false

boolean

lazyStartProducer (producer (advanced))

最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。

false

boolean

maxClientCacheSize (producer (advanced))

このオプションを使用すると、キャッシュの最大サイズを設定できます。実装は、CXF クライアントまたは ClientFactoryBean を CxfProvider および CxfRsProvider にキャッシュします。

10

int

synchronous (producer (advanced))

同期処理を厳密に使用するかどうかを設定します。

false

boolean

binding (advanced)

カスタム CxfBinding を使用して、Camel メッセージと CXF メッセージ間のバインディングを制御します。

CxfRsBinding

bus (advanced)

カスタム設定の CXF バスを使用するには。

バス

continuationTimeout (advanced)

このオプションは、CXF サーバーが Jetty またはサーブレットトランスポートを使用している場合にデフォルトで CxfConsumer で使用できる CXF 継続タイムアウトを設定するために使用されます。

30000

long

cxfRsConfigurer (advanced)

このオプションは、プログラムによる方法での CXF エンドポイントの設定をサポートする org.apache.camel.component.cxf.jaxrs.CxfRsEndpointConfigurer の実装を適用できます。ユーザーは、CxfEndpointConfigurer の configure\\{Server/Client} メソッドを実装することで、CXF サーバーとクライアントを設定できます。

CxfRsConfigurer

defaultBus (advanced)

CXF エンドポイントが独自にバスを作成するときに、デフォルトのバスを設定します。

false

boolean

headerFilterStrategy (advanced)

カスタムの HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルタリングします。

HeaderFilterStrategy

performInvocation (advanced)

オプションが true の場合、Camel はリソースクラスインスタンスの呼び出しを実行し、さらに処理するために応答オブジェクトを交換に入れます。

false

boolean

propagateContexts (advanced)

このオプションが true の場合、JAXRS UriInfo、HttpHeaders、Request、および SecurityContext コンテキストは、型指定された Camel エクスチェンジプロパティーとしてカスタム CXFRS プロセッサーで使用できます。これらのコンテキストは、JAX-RS API を使用して現在のリクエストを分析するために使用できます。

false

boolean