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


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

spring-ws:type:lookupKey:webServiceEndpointUri
Copy to Clipboard Toggle word wrap

パスとクエリーのパラメーターは次のとおりです。

65.4.1. パスパラメーター (4 パラメーター)

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

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 オブジェクトを参照できるようにします。

列挙値:

  • ROOT_QNAME
  • ACTION
  • TO
  • SOAP_ACTION
  • XPATHRESULT
  • URI
  • URI_PATH
  • BEANNAME
 

EndpointMappingType

lookupKey (consumer)

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

 

String

webServiceEndpointUri (producer)

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

 

String

expression (consumer)

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

 

String

65.4.2. クエリーパラメーター (21 パラメーター)

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

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 (advanced))

コンシューマーの 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 がエクスチェンジを作成する際に交換パターンを設定します。

列挙値:

  • InOnly
  • InOut
  • InOptionalOut
 

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 (advanced))

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

false

boolean

sslContextParameters (security)

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

 

SSLContextParameters

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat