CFML Reference
ColdFusion Functions

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.

Return value

A ColdFusion structure.

Category

System functions

Syntax

GetHttpRequestData()

Usage

The structure returned by this function contains the following entries:

Parameter	Description
headers	Structure that contains HTTP request headers as value pairs. Includes custom headers, such as SOAP requests.
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.
method	String that contains the CGI variable Request_Method.
protocol	String that contains the Server_Protocol CGI variable.

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>

ColdFusion 9 | ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6

Comments are no longer accepted for ColdFusion MX. ColdFusion 8 is the current version.