User Guide

GetHttpRequestData 491
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
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>
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.