Packageidv.cjcat.stardust.common.xml
Classpublic class XMLBuilder

XMLBuilder can generate Stardust elements' XML representations and reconstruct elements from existing XML data.

Every StardustElement objects can generate its XML representation through the StardustElement.toXML() method. And they can reconstrcut configurations from existing XML data through the StardustElement.parseXML() method.



Public Methods
 MethodDefined by
  
XMLBuilder
  
buildFromXML(xml:XML):void
Reconstructs elements from XML representations.
XMLBuilder
  
[static] Generate the XML representation of an Stardust element.
XMLBuilder
  
After reconstructing elements through the buildFromXML() method, reconstructed elements can be extracted through this method.
XMLBuilder
  
registerClass(elementClass:Class):void
To use XMLBuilder with your custom subclasses of Stardust elements, you must register your class and XML tag name first.
XMLBuilder
  
registerClasses(classes:Array):void
Registers multiple classes.
XMLBuilder
  
Registers multiple classes from a ClassPackage object.
XMLBuilder
  
unregisterClass(name:String):void
Undos the XML tag name registration.
XMLBuilder
Constructor detail
XMLBuilder()constructor
public function XMLBuilder()
Method detail
buildFromXML()method
public function buildFromXML(xml:XML):void

Reconstructs elements from XML representations.

After calling this method, you may extract constrcuted elements through the getElementByName() method.

Parameters
xml:XML
buildXML()method 
public static function buildXML(element:StardustElement):XML

Generate the XML representation of an Stardust element.

All related elements' would be included in the XML representation.

Parameters
element:StardustElement

Returns
XML
getElementByName()method 
public function getElementByName(name:String):StardustElement

After reconstructing elements through the buildFromXML() method, reconstructed elements can be extracted through this method.

Each Stardust element has a name; this name is used to identify elements.

Parameters
name:String

Returns
StardustElement
registerClass()method 
public function registerClass(elementClass:Class):void

To use XMLBuilder with your custom subclasses of Stardust elements, you must register your class and XML tag name first.

For example, if you register the MyAction class with XML tag name "HelloWorld", XMLBuilder knows you are refering to the MyAction class when a tag appears in the XML representation. All default classes in the Stardust engine are already registered,

Parameters
elementClass:Class
registerClasses()method 
public function registerClasses(classes:Array):void

Registers multiple classes.

Parameters
classes:Array
registerClassesFromClassPackage()method 
public function registerClassesFromClassPackage(classPackage:ClassPackage):void

Registers multiple classes from a ClassPackage object.

Parameters
classPackage:ClassPackage
unregisterClass()method 
public function unregisterClass(name:String):void

Undos the XML tag name registration.

Parameters
name:String