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