Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

SoapBindingStyle

Web メソッドとして使用される場合に、このクエリが使用するバインディング・スタイルまたは SOAP 呼び出し機能を指定します。Web サービスまたは Web クライアントとして定義されているクラス内でのみ適用されます。

使用法

クエリが (Web メソッドとして使用される場合に) 使用する既定のバインディング・スタイルをオーバーライドするには、以下の構文を使用します。

Query name(formal_spec) As classname [ WebMethod, SoapBindingStyle = soapbindingstyle ]
{
   //implementation
}

soapbindingstyle は以下のいずれかの値になります。

  • document — この Web メソッドはドキュメント・スタイルの呼び出しを使用します。

    このバインディング・スタイルにより、SOAP メッセージはドキュメントとしてフォーマットされ、通常はパートを 1 つのみ持ちます。

    SOAP メッセージでは、通常、<Body> 要素に 1 つの子要素が含まれます。<Body> 要素のそれぞれの子は、メッセージ・パートに対応します。

  • rpc — この Web メソッドは RPC (リモート・プロシージャ呼び出し) スタイルの呼び出しを使用します。

    このバインディング・スタイルにより、SOAP メッセージは複数のパートを持つメッセージとしてフォーマットされます。

    SOAP メッセージでは、<Body> 要素に 1 つの子要素が含まれ、その名前は対応する処理名から取得されます。この要素は生成されたラッパ要素であり、これにはメソッドの引数リストの引数ごとに 1 つの子要素が含まれます。

Important:

手動で作成した Web サービスでは、通常はこのキーワードの既定値が最適な値となります。SOAP ウィザードで WSDL から Web クライアントまたは Web サービスを生成すると、このキーワードはその WSDL に最適に設定されます。この値を変更すると、Web クライアントまたは Web サービスは機能しなくなる場合があります。

詳細

このキーワードは、このクエリが Web メソッドとして呼び出された場合の、このクエリによって使用されるバインディング・スタイルを指定します。

このキーワードは、指定されたクエリに対して、SoapBindingStyle クラス・キーワードをオーバーライドします。

既定値

このキーワードを省略すると、<soap:operation> 要素の style 属性が、代わりに SoapBindingStyle クラス・キーワードの値により決定されます。

WSDL との関係

詳細は、SoapBindingStyle メソッド・キーワードのエントリを参照してください (同じ名前のクラス・キーワードがあると、メソッド・キーワードやクエリ・キーワードの動作よりも WSDL のパートのほうに大きく影響します)。

SOAP メッセージへの影響

詳細は、SoapBindingStyle クラス・キーワードのエントリを参照してください。

関連項目

FeedbackOpens in a new tab