Obiekty XML

Flash Player 9 i nowsze wersje, Adobe AIR 1.0 i nowsze wersje

Obiekt XML może reprezentować element XML, atrybut, komentarz, instrukcję przetwarzania lub element tekstowy.

Obiekt XML może zawierać treść prostą albo treść złożoną. Obiekt XML, który ma węzły podrzędne, jest sklasyfikowany jako mający treść złożoną. Obiekt XML ma treść prostą, jeśli jest jednym z następujących obiektów: atrybutem, komentarzem, instrukcją przetwarzania lub węzłem tekstowym.

Na przykład poniższy obiekt XML zawiera treść złożoną, w tym komentarz i instrukcję przetwarzania:

XML.ignoreComments = false; 
XML.ignoreProcessingInstructions = false; 
var x1:XML =  
    <order> 
        <!--This is a comment. --> 
        <?PROC_INSTR sample ?> 
        <item id='1'> 
            <menuName>burger</menuName> 
            <price>3.95</price> 
        </item> 
        <item id='2'> 
            <menuName>fries</menuName> 
            <price>1.45</price> 
        </item> 
    </order>

Jak widzimy w poniższym przykładzie, można teraz użyć metod comments() i processingInstructions() do utworzenia nowych obiektów XML — komentarza i instrukcji przetwarzania:

var x2:XML = x1.comments()[0]; 
var x3:XML = x1.processingInstructions()[0];

Właściwości XML

Klasa XML ma pięć właściwości statycznych:

  • Właściwości ignoreComments oraz ignoreProcessingInstructions określają, czy podczas analizowania obiektu XML mają być ignorowane komentarze i/lub instrukcje przetwarzania.

  • Właściwość ignoreWhitespace określa, czy w znacznikach elementów oraz wyrażeniach osadzonych rozdzielonych tylko białymi spacjami mają być ignorowane znaki białych spacji.

  • Właściwości prettyIndenti prettyPrinting służą do formatowania tekstu zwracanego przez metody toString() i toXMLString() klasy XML.

Szczegółowe informacje o tych właściwościach zawiera Skorowidz języka ActionScript 3.0 dla platformy Adobe Flash.

Metody XML

Poniższe metody umożliwiają operowanie na hierarchicznej strukturze obiektów XML:

  • appendChild()

  • child()

  • childIndex()

  • children()

  • descendants()

  • elements()

  • insertChildAfter()

  • insertChildBefore()

  • parent()

  • prependChild()

Poniższe metody umożliwiają operowanie na atrybutach obiektu XML:

  • attribute()

  • attributes()

Poniższe metody umożliwiają operowanie na właściwościach obiektu XML:

  • hasOwnProperty()

  • propertyIsEnumerable()

  • replace()

  • setChildren()

Poniższe metody służą do pracy z nazwami kwalifikowanymi i przestrzeniami nazw:

  • addNamespace()

  • inScopeNamespaces()

  • localName()

  • name()

  • namespace()

  • namespaceDeclarations()

  • removeNamespace()

  • setLocalName()

  • setName()

  • setNamespace()

Poniższe metody służą do operowania na określonych typach treści XML i rozpoznawania ich:

  • comments()

  • hasComplexContent()

  • hasSimpleContent()

  • nodeKind()

  • processingInstructions()

  • text()

Poniższe metody służą do konwertowania danych na ciągi znaków i formatowania obiektów XML:

  • defaultSettings()

  • setSettings()

  • settings()

  • normalize()

  • toString()

  • toXMLString()

Istnieje też kilka dodatkowych metod:

  • contains()

  • copy()

  • valueOf()

  • length()

Szczegółowe informacje o tych metodach zawiera Skorowidz języka ActionScript 3.0 dla platformy Adobe Flash.