324.2. オプション


Spring WebService コンポーネントは、以下にリストされている 2 つのオプションをサポートしています。

名前説明デフォルトタイプ

useGlobalSslContext Parameters (security)

グローバル SSL コンテキストパラメーターの使用を有効にします。

false

boolean

resolveProperty Placeholders (advanced)

起動時にコンポーネントがプロパティープレースホルダーを解決するかどうか。String タイプのプロパティーのみがプロパティープレースホルダーを使用できます。

true

boolean

Spring WebService エンドポイントは、URI 構文を使用して設定されます。

spring-ws:type:lookupKey:webServiceEndpointUri

パスおよびクエリーパラメーターを使用します。

324.2.1. パスパラメーター (3 パラメーター):

名前説明デフォルトタイプ

type

エンドポイントマッピングが使用されている場合のエンドポイントマッピングタイプ。rootqname - メッセージに含まれるルート要素の修飾名に基づいて Web サービスリクエストをマップするオプションを提供します。soapaction - メッセージのヘッダーで指定された SOAP アクションに基づいて Web サービスリクエストをマップするために使用されます。uri - 特定の URI を対象とする Web サービスリクエストをマップするため。xpathresult - 入力メッセージに対する XPath 式の評価に基づいて Web サービス要求をマップするために使用されます。評価の結果は、エンドポイント URI で指定された XPath の結果と一致する必要があります。beanname - PayloadRootQNameEndpointMapping、SoapActionEndpointMapping などの既存の (レガシー) エンドポイントマッピングと統合するために、org.apache.camel.component.spring.ws.bean.CamelEndpointDispatcher オブジェクトを参照できるようにします。

 

EndpointMappingType

lookupKey

エンドポイントマッピングが使用されている場合のエンドポイントマッピングキー

 

String

webServiceEndpointUri

プロデューサーに使用するデフォルトの Web サービスエンドポイント uri。

 

String

324.2.2. クエリーパラメーター(22 個のパラメーター):

名前説明デフォルトタイプ

messageFilter (common)

カスタム MessageFilter を提供するオプション。たとえば、ヘッダーや添付を自分で処理したい場合などです。

 

MessageFilter

bridgeErrorHandler (consumer)

コンシューマーの Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、コンシューマーが受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、コンシューマーは org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。

false

boolean

endpointDispatcher (consumer)

Spring org.springframework.ws.server.endpoint.MessageEndpoint は、Spring -WS によって受信されたメッセージを Camel エンドポイントにディスパッチし、PayloadRootQNameEndpointMapping、SoapActionEndpointMapping などの既存の (レガシー) エンドポイントマッピングと統合します。

 

CamelEndpointDispatcher

endpointMapping (consumer)

Registry/ApplicationContext 内の org.apache.camel.component.spring.ws.bean.CamelEndpointMapping のインスタンスへの参照。すべての Camel/Spring-WS エンドポイントを提供するために、レジストリーで必要な Bean は 1 つだけです。この Bean は MessageDispatcher によって自動検出され、エンドポイントで指定された特性 (ルート QName、SOAP アクションなど) に基づいて要求を Camel エンドポイントにマップするために使用されます。

 

CamelSpringWSEndpoint マッピング

expression (consumer)

オプション type=xpathresult の場合に使用する XPath 式。次に、このオプションを設定する必要があります。

 

String

exceptionHandler (consumer)

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

 

ExceptionHandler

exchangePattern (consumer)

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

 

ExchangePattern

allowResponseAttachment Override (producer)

実際のサービス層からの添付とのイン/アウトエクスチェンジで SOAP レスポンスの添付をオーバーライドするオプション。呼び出されたサービスが SOAP 添付を追加または書き換える場合、このオプションを true に設定すると、変更された SOAP 添付をイン/アウトメッセージ添付で上書きできます

false

boolean

allowResponseHeaderOverride (producer)

実際のサービス層からのヘッダー情報とのイン/アウトエクスチェンジで SOAP レスポンスヘッダーをオーバーライドするオプション。呼び出されたサービスが SOAP ヘッダーを追加または書き換える場合、このオプションを true に設定すると、変更された SOAP ヘッダーをイン/アウトメッセージヘッダーで上書きできます。

false

boolean

faultAction (producer)

メソッドによって提供される faultAction レスポンス WS-Addressing Fault Action ヘッダーの値を示します。

 

URI

faultTo (producer)

メソッドによって提供される faultAction レスポンス WS-Addressing FaultTo ヘッダーの値を示します。

 

URI

messageFactory (producer)

カスタム WebServiceMessageFactory を提供するオプション。たとえば、SAAJ の代わりに Apache Axiom で Web サービスメッセージを処理する場合などです。

 

WebServiceMessage ファクトリー

messageIdStrategy (producer)

一意のメッセージ ID の生成を制御するカスタム MessageIdStrategy を提供するオプション。

 

MessageIdStrategy

messageSender (producer)

カスタム WebServiceMessageSender を提供するオプション。たとえば、認証を実行したり、代替トランスポートを使用したりします

 

WebServiceMessage 送信元

outputAction (producer)

メソッドによって提供されるレスポンス WS-Addressing Action ヘッダーの値を示します。

 

URI

replyTo (producer)

メソッドによって提供される、replyTo レスポンス WS-Addressing ReplyTo ヘッダーの値を示します。

 

URI

soapAction (producer)

リモート Web サービスにアクセスするときに SOAP 要求内に含める SOAP アクション

 

String

timeout (producer)

プロデューサーを使用して Web サービスを呼び出す際のソケット読み取りタイムアウト (ミリ秒単位) を設定します。URLConnection.setReadTimeout() および CommonsHttpMessageSender.setReadTimeout() を参照してください。このオプションは、ビルトインメッセージ送信者の実装である CommonsHttpMessageSender および HttpUrlConnectionMessageSender を使用する場合に機能します。コンポーネントに提供される Spring WS 設定オプションをカスタマイズしない限り、これらの実装の 1 つがデフォルトで HTTP ベースのサービスに使用されます。非標準の送信者を使用している場合は、独自のタイムアウト設定を処理することが想定されています。ビルトインメッセージ送信者 HttpComponentsMessageSender は、非推奨になった CommonsHttpMessageSender の代わりに考慮されます。HttpComponentsMessageSender.setReadTimeout() を参照してください。

 

int

webServiceTemplate (producer)

カスタム WebServiceTemplate を提供するオプション。これにより、クライアント側の Web サービス処理を完全に制御できます。カスタムインターセプターの追加や、障害リゾルバー、メッセージ送信者、またはメッセージファクトリーの指定など。

 

WebServiceTemplate

wsAddressingAction (producer)

Web サービスにアクセスするときに含める WS-Addressing 1.0 アクションヘッダー。To ヘッダーは、エンドポイント URI で指定された Web サービスのアドレスに設定されます (デフォルトの Spring-WS 動作)。

 

URI

synchronous (advanced)

同期処理を厳密に使用するか、Camel が非同期処理を使用できるかどうかを設定します (サポートされている場合)。

false

boolean

sslContextParameters (security)

SSLContextParameters を使用してセキュリティーを設定する場合。

 

SSLContextParameters

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.