119.5. エンドポイントオプション
Spring WebService エンドポイントは、URI 構文を使用して設定されます。
spring-ws:type:lookupKey:webServiceEndpointUri
パスとクエリーのパラメーターは次のとおりです。
119.5.1. パスパラメーター (4 パラメーター) リンクのコピーリンクがクリップボードにコピーされました!
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| type (consumer) | エンドポイントマッピングが使用されている場合のエンドポイントマッピングタイプ。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 (consumer) | エンドポイントマッピングが使用されている場合のエンドポイントマッピングキー。 | String | |
| webServiceEndpointUri (producer) | プロデューサーに使用するデフォルトの Web サービスエンドポイント uri。 | String | |
| expression (consumer) | オプション type=xpathresult の場合に使用する XPath 式。次に、このオプションを設定する必要があります。 | String |
119.5.2. クエリーパラメーター (21 パラメーター) リンクのコピーリンクがクリップボードにコピーされました!
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| messageFilter (common) | カスタム MessageFilter を提供するオプション。たとえば、ヘッダーや添付を自分で処理したい場合などです。 | MessageFilter | |
| messageIdStrategy (common) | WS-Addressing の一意のメッセージ ID の生成を制御するカスタム MessageIdStrategy を提供するオプション。 | MessageIdStrategy | |
| 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 エンドポイントにマップするために使用されます。 | CamelSpringWSEndpointMapping | |
| bridgeErrorHandler (consumer (上級)) | consumer の Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、consumer が受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | boolean |
| exceptionHandler (consumer (上級)) | consumer によるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されないことに注意してください。デフォルトでは、consumer は例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | ExceptionHandler | |
| exchangePattern (consumer (上級)) | consumer がエクスチェンジを作成する際に交換パターンを設定します。 列挙値:
| ExchangePattern | |
| allowResponseAttachmentOverride (producer) | 実際のサービス層からの添付とのイン/アウトエクスチェンジで SOAP レスポンスの添付をオーバーライドするオプション。呼び出されたサービスが SOAP 添付を追加または書き換える場合、このオプションを true に設定すると、変更された SOAP 添付をイン/アウトメッセージ添付で上書きできます。 | false | boolean |
| allowResponseHeaderOverride (producer) | 実際のサービス層からのヘッダー情報とのイン/アウトエクスチェンジで SOAP レスポンスヘッダーをオーバーライドするオプション。呼び出されたサービスが SOAP ヘッダーを追加または書き換える場合、このオプションを true に設定すると、変更された SOAP ヘッダーをイン/アウトメッセージヘッダーで上書きできます。 | false | boolean |
| faultAction (producer) | メソッドによって提供される faultAction レスポンス WS-Addressing Fault Action ヘッダーの値を示します。詳細には、org.springframework.ws.soap.addressing.server.annotation.Action アノテーションを参照してください。 | URI | |
| faultTo (producer) | メソッドによって提供される faultAction レスポンス WS-Addressing FaultTo ヘッダーの値を示します。詳細には、org.springframework.ws.soap.addressing.server.annotation.Action アノテーションを参照してください。 | URI | |
| messageFactory (producer) | カスタム WebServiceMessageFactory を提供するオプション。たとえば、SAAJ の代わりに Apache Axiom で Web サービスメッセージを処理する場合などです。 | WebServiceMessageFactory | |
| messageSender (producer) | カスタム WebServiceMessageSender を提供するオプション。たとえば、認証を実行したり、代替トランスポートを使用したりします。 | WebServiceMessageSender | |
| outputAction (producer) | メソッドによって提供されるレスポンス WS-Addressing Action ヘッダーの値を示します。詳細には、org.springframework.ws.soap.addressing.server.annotation.Action アノテーションを参照してください。 | URI | |
| replyTo (producer) | メソッドによって提供される、replyTo レスポンス WS-Addressing ReplyTo ヘッダーの値を示します。詳細には、org.springframework.ws.soap.addressing.server.annotation.Action アノテーションを参照してください。 | 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 | |
| lazyStartProducer (producer (上級)) | 最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | boolean |
| sslContextParameters (security) | SSLContextParameters を使用してセキュリティーを設定する場合。 | SSLContextParameters |