Objetos XML

Flash Player 9 e posterior, Adobe AIR 1.0 e posterior

Um objeto XML pode representar um elemento, atributo, comentários, instrução de processamento ou elemento de texto XML.

Um objeto XML pode ter conteúdo simples ou conteúdo complexo. Um objeto XML que tem nós filho tem conteúdo complexo. Um objeto XML terá conteúdo simples se contiver um dos seguintes itens: um atributo, um comentário, uma instrução de processamento ou um nó de texto.

Por exemplo, o objeto XML a seguir tem conteúdo complexo, incluindo um comentário e uma instrução de processamento:

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>

Como mostra o exemplo a seguir, agora você pode usar os métodos comments() e processingInstructions() para criar novos objetos XML, um comentário e uma instrução de processamento:

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

propriedades XML

A classe XML tem cinco propriedades estáticas:

  • As propriedades ignoreComments e ignoreProcessingInstructions determinam se comentários ou instruções de processamento devem ser ignorados quando o objeto XML é analisado.

  • A propriedade ignoreWhitespace determina se os caracteres de espaço em branco devem ser ignorados em tags de elemento e expressões incorporadas que são separadas somente por caracteres de espaço em branco.

  • As propriedades prettyIndenteprettyPrinting são usadas para formatar o texto que é retornado pelos métodos toString() e toXMLString() da classe XML.

Veja os detalhes dessas propriedades na Referência do ActionScript 3.0 para a plataforma Adobe Flash.

Métodos XML

Os métodos a seguir permitem trabalhar com a estrutura hierárquica dos objetos XML:

  • appendChild()

  • child()

  • childIndex()

  • children()

  • descendants()

  • elements()

  • insertChildAfter()

  • insertChildBefore()

  • parent()

  • prependChild()

Os métodos a seguir permitem trabalhar com atributos de objetos XML:

  • attribute()

  • attributes()

Os métodos a seguir permitem trabalhar com propriedades de objetos XML:

  • hasOwnProperty()

  • propertyIsEnumerable()

  • replace()

  • setChildren()

Os métodos a seguir permitem trabalhar com nomes e namespaces qualificados:

  • addNamespace()

  • inScopeNamespaces()

  • localName()

  • name()

  • namespace()

  • namespaceDeclarations()

  • removeNamespace()

  • setLocalName()

  • setName()

  • setNamespace()

Os métodos a seguir permitem trabalhar e determinar tipos específicos de conteúdo XML:

  • comments()

  • hasComplexContent()

  • hasSimpleContent()

  • nodeKind()

  • processingInstructions()

  • texto()

Os métodos a seguir servem para conversão em strings e formatação de objetos XML:

  • defaultSettings()

  • setSettings()

  • settings()

  • normalize()

  • toString()

  • toXMLString()

Existem alguns métodos adicionais:

  • contains()

  • copiar()

  • valueOf()

  • length()

Veja a documentação desses métodos na Referência do ActionScript 3.0 para a plataforma Adobe Flash.