GETSOAPREQUEST |
説明 SOAP リクエスト全体を含む XML オブジェクトを返します。通常は、Web サービス CFC 内から呼び出されます。
戻り値 SOAP リクエスト全体を含む XML オブジェクト
カテゴリ XML 関数
ヒストリ ColdFusion MX 7: この関数が追加されました。
関数のシンタックス
    GetSOAPRequest()
関連項目 AddSOAPRequestHeader、AddSOAPResponseHeader、GetSOAPRequestHeader、GetSOAPResponse、GetSOAPResponseHeader、IsSOAPRequest、『ColdFusion MX 開発ガイド』の第36章の「Web サービスの使用」 の「基本的な Web サービスの概念」
パラメータ
使用方法 Web サービスの起動後、この関数を呼び出して、WEB サービスリクエストオブジェクトを取得します。webservice パラメータがない外部の Web サービス CFC からこの関数を呼び出した場合、次の式エラーが返されます。
    Unable to use getSOAPRequest: not processing a web service request.
Web サービス CFC 内からこの関数を呼び出した場合は、webservice 引数を省略できます。この関数は、現在処理しているリクエストに対して機能します。 CFML XML 関数を使用して、返された XML オブジェクトを調べることができます。
例 この例では、リクエストを行って、headerservice.cfc Web サービスの echo_me 関数を実行します。headerservice.cfc Web サービスの実装に関する詳細、echo_me 関数、および Web サービス CFC の内容については、 CFC, see the example for either the AddSOAPResponseHeader 関数または GetSOAPRequestHeader 関数の例を参照してください。
    <!--- CreateObject 関数内の URL がここで示されたものと異なる場合は修正して、
    使用するサーバーおよび "headerservice.cfc" ファイルの場所と一致させなければ
    なりません。
    getSOAPRequest はここでクライアントから呼び出されますが、Web サービス CFC 内から
    呼び出されることもよくあります。 --->

    <cfscript>
       ws = CreateObject("webservice",
            "http://localhost/soapheaders/headerservice.cfc?WSDL");
       ws.echo_me("hello world");
       req = getSOAPRequest(ws);
    </cfscript>
    <cfdump var="#req#">

WEBSERVICE |
オプションです。cfobject タグまたは createobject 関数から返される webservice オブジェクト です。
この関数がクライアントから呼び出される場合に必須です。