MACROMEDIA ColdFusion MX, Develop Manual

Page: 701 / 860

Moving complex data across the web with WDDX 701
Data type comparisons
The following table compares the basic WDDX data types with the data types to which they
correspond in the languages and technologies commonly used on the web:
Time zone processing
Producers and consumers of WDDX packets can be in geographically dispersed locations.
Therefore, it is important to use time zone information when serializing and deserializing data, to
ensure that date-time values are represented correctly.
The
cfwddx action=cfml2wddx
tag
useTimezoneInfo
attribute specifies whether to use time
zone information in serializing the date-time data. In the JavaScript implementation,
useTimezoneInfo
is a property of the
WddxSerializer
object. In both cases the default
useTimezoneInfo
value is True.
Date-time values in WDDX are represented using a subset of the ISO8601 format. Time zone
information is represented as an hour/minute offset from Coordinated Universal Time (UTC);
for example, “2002-9-8T12:6:26-4:0”.
When the
cfwddx
tag deserializes WDDX to CFML, it automatically uses available time zone
information, and converts date-time values to local time. In this way, you do not need to worry
about the details of time zone conversions.
However, when the JavaScript objects supplied with ColdFusion deserialize WDDX to JavaScript
expressions, they do not use time zone information, because in JavaScript it is difficult to
determine the time zone of the browser.
WDDX CFML
XML
Schema Java
ECMAScript/
JavaScript COM
null N/A N/A null null VT_NULL
boolean Boolean boolean java.lang.Boolean boolean VT_BOOL
number Number number java.lang.Double number VT_R8
dateTime DateTime dateTime java.lang.Date Date VT_DATE
string String string java.lang.String string VT_BSTR
array Array N/A java.lang.Vector Array VT_ARRAY |
VT_VARIANT
struct Structure N/A java.lang.
Hashtable Object IWDDXStruct
recordset Query
object N/A coldfusion.run
time.QueryTable WddxRecordset IWDDXRecordset
binary Binary binary byte[] WddxBinary V_ARRAY | UI1