JSFLInterface (library)

Categories:Flash

Overview

Overview

The JSFL library is mainly used by the AS3 Module Framework in order to pass data back and forth from ActionScript to JSFL, whilst retaining data types between the two environments, as MMExecute calls and returns are String-based.

Contents

Concept

Values are serialized on the JSFL side into an XML format which retains type information, and is then deserialized on the ActionScript side.

The following data types are supported:

  • Number
  • String
  • Boolean
  • Date
  • Object
  • Array
  • undefined
  • null

Usage

Usually, you won't directly serialize values and send them to ActionScript, as the round-trip is initiated and controlled on the ActionScript side. A tutorial will be available shortly to explain how the AS3 Module Framework works its magic.

The actual conversion code on both the JSFL and ActionScript side is a direct port from the excellent JSFLInterface class by Matthew Tretter.

API

serialize(value)

Serializes values to XML so they can be passed to Flash and be deserialized to values again

Parameters:

  • value Value Any value

Returns:

  •   String An XML String

The following serialises an example object with all the supported data types:

var data =
{
    a:1,
    b:'Hello',
    c:true,
    d:new Date(),
    e:[1,2,3],
    f:undefined,
    g:null
}

var xml = JSFL.serialize(data);
trace(new XML(xml).toXMLString());
<object>
    <property id="a">
        <number>1</number>
    </property>
    <property id="b">
        <string>Hello</string>
    </property>
    <property id="c">
        <true/>
    </property>
    <property id="d">
        <date>1311427124754</date>
    </property>
    <property id="e">
        <array>
            <property id="0">
                <number>1</number>
            </property>
            <property id="1">
                <number>2</number>
            </property>
            <property id="2">
                <number>3</number>
            </property>
        </array>
    </property>
    <property id="f">
        <undefined/>
    </property>
    <property id="g">
        <null/>
    </property>
</object>

Leave a Reply

Your email address will not be published. Required fields are marked *

*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>