XML and Flash Actionscript made Easy | Parse XML to Object | Tutorial

XML and flash is something that always seemed to be more complicated than it needed to be. Then I had an idea to parse the xml nodes into actionscript as objects, that would make working with xml tons easier for me, I could just parse it once and then forget about the xml, I could refer to something with the familiar dot syntax rather than worry about firstChild and nextChild and so forth…

This is for AS2. (AS3 has similar functionality built-in via E4X!)

And then I found someone who’d already done that with XML2Object.as, here it is:

[email protected] Class

Actionscript Class:
[cc lang=”actionscript” tab_size=”2″ lines=”40″]
//////////////////
// – Derived from code written by Alessandro Crugnola – http://www.sephiroth.it/file_detail.php?id=129#
// – Refactored and documented by Phil Powell – http://www.sillydomainname.com
// – 25 July 2006 – Added helper method to sanitize Windows line breaks.
//////////////////
// Convert an XML object to an object with nested properties.
//
// Example usage:
//
// import net.produxion.util.XML2Object;
// var contentObj:Object;
// var xml:XML = new XML();
// var xmlLoaded = function( success:Boolean )
// {
// if( success )
// {
// contentObj = XML2Object.deserialize( this );
// this[‘timeline’].play();
// }
// }
//
// xml.ignoreWhite = true;
// xml[‘timeline’] = this;
// xml.onLoad = xmlLoaded;
// xml.load( ‘some.xml’ );
//
/////////////////
// What do you get back?
//
//
//My Title
// // Here be links!
//http://somewhere.com //http://somewhere-else.com //
//

//
// Becomes:
//
// contentObj.content.title.data => “My Title”
// contentObj.content.links.title.data => “Here be links!”
// contentObj.content.links.link => [Array]
// contentObj.content.links.link[0].data => “http://somewhere.com”
// contentObj.content.attributes.created => “22-May-2006”
/////////////////
class XML2Object {private var _result:Object;
private var _xml:XML;
private var _path:Object;
private static var xml2object:XML2Object;public function XML2Object()
{
this._result = new Object();
}

public static function deserialize( xml:XML ):Object
{
xml2object = new XML2Object();
xml2object.xml = xml;
return xml2object.nodesToProperties();
}

public function get xml():XML
{
return _xml;
}

public function set xml( xml:XML ):Void
{
this._xml = xml;
}

private function nodesToProperties( parent:XMLNode, path:Object, name:String, position:Number ):Object
{
var nodes:Array;
var node:XMLNode;

path == undefined ? path = this._result : path = path[name];
if( parent == undefined) parent = XMLNode( this._xml );

if( parent.hasChildNodes() )
{
nodes = parent.childNodes;
if (position != undefined) path = path[position];

while( nodes.length > 0 )
{
node = XMLNode( nodes.shift() );

if ( node.nodeName != undefined )
{
var obj = new Object();
obj.attributes = node.attributes;
obj.data = sanitizeLineBreaks( node.firstChild.nodeValue );

if( path[node.nodeName] != undefined )
{

if( path[node.nodeName].__proto__ == Array.prototype )
{
path[node.nodeName].push( obj );
}
else
{
var copyObj = path[node.nodeName];
delete path[node.nodeName];
path[node.nodeName] = new Array();
path[node.nodeName].push( copyObj );
path[node.nodeName].push( obj );
}
position = path[node.nodeName].length – 1;
}
else
{
path[node.nodeName] = obj;
position = undefined;
}
name = node.nodeName;
}

if( node.hasChildNodes() )
{
this.nodesToProperties( node, path, name, position );
}
}

}
return this._result;
}

private function sanitizeLineBreaks( raw:String )
{
if( raw.indexOf( “\r\n” ) > -1 )
{
return raw.split( “\r\n” ).join( “\n” );
}
return raw;
}
}
[/cc]

Example:

[kml_flashembed fversion=”9.0.0″ movie=”https://circlecube.com/circlecube/wp-content/uploads/sites/10/2008/04/xmltoobject.swf” targetclass=”flashmovie” publishmethod=”dynamic” width=”500″ height=”400″]

Get Adobe Flash player

[/kml_flashembed]

Source:

Here is my example file. But since you cant really see Objects in the code on the stage, I’ve included a recursive trace function to loop through the object and print the data.
[cc lang=”actionscript” tab_size=”2″ lines=”40″]
import XML2Object;

var xmlObject:Object;
var xml:XML = new XML();

var xmlLoaded = function( success:Boolean ){
if( success ) {
xmlObject = XML2Object.deserialize( this );
this[‘timeline’].play();
recurseTrace(xmlObject, ” “);
myTrace(“\n\n”)
myTrace(“xmlObject.catagories.catagory[10].name.data = “+xmlObject.catagories.catagory[10].name.data);
}
}

xml.ignoreWhite = true;
xml.onLoad = xmlLoaded;
xml.load( ‘sampleXML.xml’ );

function recurseTrace(info:Object, indent:String) {
for (var i in info) {
if (info[i] == null){}
else if (typeof info[i] == “object”) {
myTrace(indent + i + ” -“);
recurseTrace(info[i], indent);
}
else {
myTrace(indent + i + ” = ” + info[i] +”, “);
}
}
}

function myTrace(myLine:String){
feedback.text += “|”+myLine;
trace(myLine);
}
[/cc]

And here’s my sample xml file: (it’s the same one I use in my Dynamic Flash Scrolling Link List files)
[cc lang=”xml” tab_size=”2″ lines=”40″]


3D
https://circlecube.com/circlecube/tag/3d/


abstract
https://circlecube.com/circlecube/tag/abstract/


actionscript
https://circlecube.com/circlecube/tag/actionscript/


animation
https://circlecube.com/circlecube/tag/animation/


blog
https://circlecube.com/circlecube/tag/blog/


book
https://circlecube.com/circlecube/tag/book/


CG
https://circlecube.com/circlecube/tag/cg/


charcoal
https://circlecube.com/circlecube/tag/charcoal/


circle cube
https://circlecube.com/circlecube/tag/circle-cube/


collage
https://circlecube.com/circlecube/tag/collage/


color
https://circlecube.com/circlecube/tag/color/


css
https://circlecube.com/circlecube/tag/css/


drawing
https://circlecube.com/circlecube/tag/drawing/


dreamweaver
https://circlecube.com/circlecube/tag/dreamweaver/


experiment
https://circlecube.com/circlecube/tag/experiment/


film
https://circlecube.com/circlecube/tag/film/


final cut
https://circlecube.com/circlecube/tag/final-cut/


flash
https://circlecube.com/circlecube/tag/flash/


[/cc]

Download:

Here’s the XML2Object.as class: XML2Object.as class

 

Here’s a zip containing everything and the working example: xmlToObject.zip

21 thoughts on “XML and Flash Actionscript made Easy | Parse XML to Object | Tutorial

  1. Wow. Thank you! In the past I’ve been in too much of a hurry to even try to work with ActionScript’s stupidly complicated XML handling. On one recent project, I just imported the whole XML file as text, and parsed it using string functions for the bits I needed. (Not very elegant at all, I know.. but in terms of coding time, it was much quicker).

    This is extremely sweet though. (In fact, what you’ve done here is sort of how I thought XML handling in ActionScript *would* work before I found out otherwise).

    Very nice. Very nice.

    -Popo

  2. Can any one help me with this

    Create a Flash Movie: 550 x 400 pixels.
    2. Write 2 external ActionScript files, one of which MUST be the Document
    Class.
    3. Code a Rectangle with a Blue border and fill it with a Red and Greed Gradient
    at a 45 degree angle. (Use the second ActionScript file for this)
    4. Add 10 instances of this Rectangle to the stage, randomly placing them along
    the TOP of the movie, one per second, for 10 seconds.
    5. As soon as a square is added, it should start falling to the bottom of the
    movie, where it bounces before coming to a stop.
    · There should be NO Timeline animation of any kind, in-fact, there should be
    nothing on any Frame of the .fla file at all.
    · The Library of the .fla file should also be completely EMPTY.
    · You are allowed to use no more than 60 lines of code, spread over the 2
    allowed ActionScript Files.
    · You must send the .fla file, together with the 2 ActionScript files in for
    evaluation.

  3. Xml to Object, is that not what e4x does? wich is available in my Flex/Air projects

    I am looking for a deserialize to a custom type

  4. Xml to Object, is that not what e4x does? wich is available in my Flex/Air projects

    I am looking for a deserialize to a custom type

    1. @Bart – Yes, but note this is for as2, this xml to object is pre e4x, there are multiple ways to do it, but some as2 developers still could find uses for it. Good luck with the deserialiser.

  5. @Bart – Yes, but note this is for as2, this xml to object is pre e4x, there are multiple ways to do it, but some as2 developers still could find uses for it. Good luck with the deserialiser.

  6. Wowzers..

    I’m writing some code to deal with a massive amount of XML data and faced with bug fixing in the dark I was ready to bang my head against a brickwall until I saw your little trace function there.. that is a real life saver.. thanks a lot for that!!

    Cheers
    M.

  7. Evan,

    Awesome class! I’m stuck on AS2 for a project that won’t move to AS3 any time soon. I was parsing my own XML, but this is much easier. It works great on my little XML file. How does it do with large files?

    1. Does anyone know how to apply this class to an XML which is not a file?
      I have PHP function which imports data back into Flash in XML form, but I’m having problems parsing it.

      Thanks in advance,
      Mariano

  8. Hey Evan,
    nice tutorial, thank you. I found this one after viewing your AS2 version. I only know AS3 and am trying to use this example but in the simplicity you did the AS2 tutorial.

    So right now I’m trying to strip everything out and have my html page with the embedded flash simply display all the hex codes for your colour variable, in other words, just a list of the items separated by the commas.

    Thing is I keep getting errors and cannot exactly tell what code has to stay and what can go…..any help?!

  9. On a related note: “readable object serialization” … the routine I’ve linked below doesn’t convert to or from XML, but it does take your flash objects and serializes them into an easy-to-read string, from which it can recreate the object. MUCH easier to read datafiles in this format compared to XML datafiles:

    http://kionetics.com/programmingProjects/readableSerialization/readableSerialization.html

    It’s just in AS2, but I’d like to do an AS3 version some time in the future.

    Of course, ideally you want many if not most of your parameters stored in individual database fields so this seems moot, but you may have complex data objects that need no parsing outside your program, and which you might want to inspect or view as a well formatted object, in which case it makes sense to serialize them with this routine and store it as a string for each record in a single database field. It’s nice keeping your db-field-count at a minimum too.

  10. I need to find id say 44. how do I make a method that from this CML finds the right id and (44) and return me a line Parent = -9?

    1. @BlueRaja – not a bad idea. I hope most everyone is able to use as3 by now if they are in flash and never came back to update this old post. We did discuss as2 vs as3 in the comments though. Hope that helped you.

Comments are closed.