MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 611 / 1108

GetHttpRequestData 611
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()
Returns
The function returns a structure containing the following entries:
Usage
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)
.
Example
The following example shows how this function can return HTTP header information.
<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>
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.