GetHttpRequestData |
|
 |
Description
|
Makes HTTP request headers and body available to CFML pages. Useful for capturing SOAP request data, which can be delivered in an HTTP header.
|
|
Returns
|
A ColdFusion structure.
|
|
Category
|
System functions
|
|
Function syntax |
GetHttpRequestData()
|
|
Parameters
|
|
Parameter |
Description |
content |
Raw content from form submitted by client, in string or binary format. For content to |
|
be considered string data, the FORM request header "CONTENT_TYPE" must |
|
start with "text/" or be special case "application/x-www-form-urlencoded". Other |
|
types are stored as a binary object. |
headers |
Structure that contains HTTP request headers as value pairs. Includes custom |
|
headers, such as SOAP requests. |
method |
String that contains the CGI variable Request_Method. |
protocol |
String that contains the Server_Protocol CGI variable. |
|
|
Usage
|
The structure returned by this function contains the following entries:
Note: |
To determine whether data is binary, use IsBinary(x.content).To convert data to a string value, if it can be displayed as a string, use toString(x.content). |
|
The following example shows how this function can return HTTP header information.
|
|
Example<cfset x = GetHttpRequestData()>
<cfoutput>
<table cellpadding = "2" cellspacing = "2">
<tr>
<td><b>HTTP Request item</b></td>
<td><b>Value</b></td> </tr>
<cfloop collection = #x.headers# item = "http_item">
<tr>
<td>#http_item#</td>
<td>#StructFind(x.headers, http_item)#</td> </tr>
</cfloop>
<tr>
<td>request_method</td>
<td>#x.method#</td></tr>
<tr>
<td>server_protocol</td>
<td>#x.protocol#</td></tr>
</table>
<b>http_content --- #x.content#</b>
</cfoutput>
|