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

Page: 901 / 1108

URLSessionFormat 901
URLSessionFormat
Description
Depending on whether a client computer accepts cookies, this function does the following:
•
If the client does not accept cookies: automatically appends all required client identification
information to a URL
•
If the client accepts cookies: does not append information
This function automatically determines which identifiers are required, and sends only the
required information. It provides a more secure and robust method for supporting client
identification than manually encoding the information in each URL, because it sends only
required information, when it is required, and it is easier to code.
Returns
A URL; if cookies are disabled for the browser, client and session data are appended.
Category
Other functions ; Chapter 15, “Maintaining client identity,” in Chapter 15, “Using Persistent
Data and Locking,” in ColdFusion MX Developer’s Guide
Function syntax
URLSessionFormat ( request_URL )
Parameters
Usage
In the following example, the
cfform
tag posts a request to another page and sends the client
identification, if required. If cookie support is detected, the function returns the following:
myactionpage.cfm
If the detected cookie is not turned on, or cookie support cannot be reliably detected, the
function return value is as follows:
myactionpage.cfm?jsessionid=xxxx;cfid=xxxx&cftoken=xxxxxxxx
Example
<cfform
method="Post"
action="#URLSessionFormat("MyActionPage.cfm")#">
</cfform>
Parameter Description
request_URL URL of a ColdFusion page