User Guide

358 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 = "resultvariablename"
topLevelVariable = "toplevelvariablenameforjavascript"
useTimeZoneInfo = "Yes" or "No"
validate = "Yes" or "No" >
See also
cfcollection, cfdump, cfexecute, cfindex, cfobject, cfreport, cfsearch
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: serialize CFML to WDDX
• wddx2cfml: deserialize WDDX to CFML
• cfml2js: serialize CFML to JavaScript
• wddx2js: deserialize 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.
topLevelVariable Required if
action =
"wddx2js"
or
"cfml2js"
Name of top-level JavaScript object created by
deserialization. The object is an instance of the
WddxRecordset object.