Description

Creates a WDDX packet for a passed WddxRecordset instance.

Syntax

object.serialize( rootobj )

Parameters

Return value

Returns a serialized WDDX packet as a string if the function succeeds, or a null value if an error occurs.

Usage

Call this function to serialize the data in a WddxRecordset instance.

Example

This example shows a JavaScript function that you can call to serialize a WddxRecordset instance. It copies serialized data to a form field for display:

function serializeData(data, formField) 
{ 
    wddxSerializer = new WddxSerializer(); 
    wddxPacket = wddxSerializer.serialize(data); 
    if (wddxPacket != null) 
    { 
        formField.value = wddxPacket; 
    } 
    else 
    { 
        alert("Couldn't serialize data"); 
    } 
}

Description

Serializes a property of a structure. If an object is not a string, number, array, Boolean, or date, WddxSerializer treats it as a structure.

Syntax

object.serializeVariable( name, obj )

Parameters

Return value

Returns a Boolean True if serialization was successful; False, otherwise.

This is an internal function; you do not typically call it.

Example

This example is from the WddxSerializer serializeValue function:

... 
// Some generic object; treat it as a structure 
    this.write("<struct>"); 
    for (prop in obj) 
    { 
        bSuccess = this.serializeVariable(prop, obj[prop]); 
        if (! bSuccess) 
        { 
            break; 
        } 
    } 
    this.write("</struct>"); 
...

Description

Recursively serializes eligible data in a passed instance. Eligible data includes:

• String

• Number

• Boolean

• Date

• Array

• Recordset

• Any JavaScript object

  This function serializes null values as empty strings.

Syntax

object.serializeValue( obj )

Parameters

Return value

Returns a Boolean True if obj was serialized successfully; False, otherwise.

Usage

This is an internal function; you do not typically call it.

Example

This example is from the WddxSerializer serialize function:

... 
this.wddxPacket = ""; 
this.write("<wddxPacket version='1.0'><header/><data>"); 
bSuccess = this.serializeValue(rootObj); 
this.write("</data></wddxPacket>"); 
if (bSuccess) 
{ 
    return this.wddxPacket; 
} 
else 
{ 
    return null; 
} 
...

Description

Appends data to a serialized data stream.

Syntax

object.write( str )

Parameters

Return value

Returns an updated serialized data stream as a String.

Usage

This is an internal function; you do not typically call it.

Example

This example is from the WddxSerializer serializeValue function:

... 
else if (typeof(obj) == "number") 
{ 
    // Number value 
    this.write("<number>" + obj + "</number>"); 
} 
else if (typeof(obj) == "boolean") 
{ 
    // Boolean value 
    this.write("<boolean value='" + obj + "'/>"); 
} 
...