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 オブジェクト です。
この関数がクライアントから呼び出される場合に必須です。