User Guide

444 Chapter 2: ColdFusion Tags
cfwddx
Description
Serializes and deserializes CFML data structures to the XML-based WDDX format. The WDDX
is an XML vocabulary for describing complex data structures in a standard, generic way.
Implementing it lets you use the HTTP protocol to such information among application server
platforms, application servers, and browsers.
This tag generates JavaScript statements to instantiate JavaScript objects equivalent to the
contents of a WDDX packet or CFML data structure. Interoperates with Unicode.
Category
Extensibility tags
Syntax
<cfwddx
action = "action"
input = "inputdata"
output = "result variable name"
topLevelVariable = "top-level variable name for JavaScript"
useTimeZoneInfo = "yes" or "no"
validate = "yes" or "no" >
See also
cfcollection
, cfdump, cfexecute, cfindex, cfobject, cfreport, cfsearch, ToScript;
Chapter 35, “Using XML and WDDX,” in ColdFusion MX Developer’s Guide
History
ColdFusion MX
• Changed column name case behavior: ColdFusion preserves the case of column names in
JavaScript. (Earlier releases converted query column names to lowercase.)
• Changed encoding format support: this tag supports several encoding formats. The default
encoding format is UTF-8. The tag interoperates with Unicode.
Attributes
Attribute Req/Opt Default Description
action Required • cfml2wddx: serializes CFML to WDDX.
• wddx2cfml: deserializes WDDX to CFML.
• cfml2js: serializes CFML to JavaScript.
• wddx2js: deserializes WDDX to JavaScript.
input Required A value to process.
output
Required if
action =
"wddx2cfml"
Name of variable for output. If action = "WDDX2JS" or
"CFML2JS", and this attribute is omitted, result is output
in HTML stream.