| Pakiet | flash.xml |
| Klasa | public class XMLNode |
| Dziedziczenie | XMLNode  Object |
| Podklasy | XMLDocument |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| attributes : Object
Obiekt zawierający wszystkie atrybuty określonej instancji obiektu XMLNode. | XMLNode | ||
| childNodes : Array [tylko do odczytu]
Tablica potomków określonego obiektu XMLNode. | XMLNode | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| firstChild : XMLNode
Analizuje określony obiekt XMLDocument i odwołuje się do pierwszego potomka na liście potomków węzła nadrzędnego. | XMLNode | ||
| lastChild : XMLNode
Wartość XMLNode, która odwołuje się do ostatniego potomka na liście potomków węzła. | XMLNode | ||
| localName : String [tylko do odczytu]
Część nazwy węzła XML będąca nazwą lokalną. | XMLNode | ||
| namespaceURI : String [tylko do odczytu]
Jeśli węzeł XML ma prefiks, parametr URIprzestrzeninazw stanowi wartość deklaracji xmlns dla tego prefiksu (identyfikator URI), którą nazywa się zwykle identyfikatorem URI przestrzeni nazw. | XMLNode | ||
| nextSibling : XMLNode
Wartość XMLNode, która odwołuje się do następnego węzła siostrzanego na liście potomków węzła nadrzędnego. | XMLNode | ||
| nodeName : String
Ciąg znaków reprezentujący nazwę węzła obiektu XMLNode. | XMLNode | ||
| nodeType : uint
Stała będąca wartością parametru nodeType: XMLNodeType.ELEMENT_NODE w przypadku elementu XML lub XMLNodeType.TEXT_NODE w przypadku węzła tekstowego. | XMLNode | ||
| nodeValue : String
Wartość węzła obiektu XMLDocument. | XMLNode | ||
| parentNode : XMLNode
Wartość XMLNode, która odwołuje się do węzła macierzystego określonego obiektu XML, a jeśli węzeł nie ma węzła nadrzędnego zwraca wartość null. | XMLNode | ||
| prefix : String [tylko do odczytu]
Prefiks nazwy węzła XML. | XMLNode | ||
| previousSibling : XMLNode
Wartość XMLNode, która odwołuje się do poprzedniego węzła siostrzanego na liście potomków węzła nadrzędnego. | XMLNode | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Tworzy nowy obiekt XMLNode. | XMLNode | ||
Dołącza określony węzeł do listy elementów potomnych obiektu XML. | XMLNode | ||
Konstruuje i zwraca nowy węzeł XML, którego typ, nazwa, wartość i atrybuty są identyczne jak w przypadku określonego obiektu XML. | XMLNode | ||
Zwraca identyfikator URI przestrzeni nazw, skojarzony z określonym prefiksem węzła. | XMLNode | ||
Zwraca prefiks skojarzony z identyfikatorem URI przestrzeni nazw węzła. | XMLNode | ||
Wskazuje, czy określony obiekt XMLNode ma węzły potomne. | XMLNode | ||
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
Umieszcza nowy węzeł potomny na liście elementów potomnych obiektu XML, przed węzłem określonym za pomocą parametru przed. | XMLNode | ||
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
Usuwa określony obiekt XML z obiektu nadrzędnego. | XMLNode | ||
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
Analizuje określony obiekt XMLNode, konstruuje tekstową reprezentację struktury XML (łącznie z węzłem, jego węzłami potomnymi i atrybutami) i zwraca wynik w postaci ciągu. | XMLNode | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
attributes | właściwość |
attributes:Object| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Obiekt zawierający wszystkie atrybuty określonej instancji obiektu XMLNode. Obiekt XMLNode.attributes zawiera po jednej zmiennej dla każdego atrybutu instancji XMLNode. Ponieważ zmienne te są zdefiniowane jako część obiektu, z reguły są nazywane właściwościami obiektu. Wartość każdego atrybutu jest przechowywana w odpowiedniej właściwości jako ciąg znaków. Na przykład jeśli mamy atrybut o nazwie color, w celu pobrania jego wartości należałoby podać ciąg color jako nazwę właściwości. Ilustruje to następujący kod:
var myColor:String = doc.firstChild.attributes.color
Implementacja
public function get attributes():Object public function set attributes(value:Object):voidchildNodes | właściwość |
childNodes:Array [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tablica potomków określonego obiektu XMLNode. Każdy element tablicy jest odwołaniem do obiektu XMLNode reprezentującego węzeł potomny. Jest to właściwość przeznaczona tylko do odczytu i nie można jej używać do manipulowania węzłami potomnymi. Do manipulowania węzłami potomnymi służą metody appendChild(), insertBefore() i removeNode().
Ta właściwość jest niezdefiniowana (undefined) dla węzłów tekstowych (nodeType == 3).
Implementacja
public function get childNodes():ArrayPowiązane elementy interfejsu API
firstChild | właściwość |
public var firstChild:XMLNode| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Analizuje określony obiekt XMLDocument i odwołuje się do pierwszego potomka na liście potomków węzła nadrzędnego. Właściwość ma wartość null, jeśli węzeł nie ma węzłów potomnych. Właściwość ma wartość undefined, jeśli węzeł jest węzłem tekstowym. Jest to właściwość przeznaczona tylko do odczytu i nie można jej używać do manipulowania węzłami potomnymi; służą do tego metody appendChild(), insertBefore() i removeNode().
Powiązane elementy interfejsu API
lastChild | właściwość |
public var lastChild:XMLNode| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość XMLNode, która odwołuje się do ostatniego potomka na liście potomków węzła. Właściwość XMLNode.lastChild ma wartość null, jeśli węzeł nie ma potomków. Tej właściwości nie można używać do manipulowania węzłami potomnymi; służą do tego metody appendChild(), insertBefore() i removeNode().
Powiązane elementy interfejsu API
localName | właściwość |
localName:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Część nazwy węzła XML będąca nazwą lokalną. Jest to nazwa elementu bez prefiksu przestrzeni nazw. Na przykład węzeł <contact:mailbox/>bob@example.com</contact:mailbox> ma nazwę lokalną równą "mailbox" i prefiks równy "contact", zaś pełna nazwa elementu to "contact.mailbox".
Dostęp do prefiksu przestrzeni nazw jest możliwy za pośrednictwem właściwości prefix obiektu węzła XML. Właściwość nodeName zwraca pełną nazwę (składającą się z prefiksu i nazwy lokalnej).
Implementacja
public function get localName():StringnamespaceURI | właściwość |
namespaceURI:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Jeśli węzeł XML ma prefiks, namespaceURI jest wartością deklaracji xmlns dla tego prefiksu (identyfikatorem URI), nazywanym zazwyczaj identyfikatorem URI przestrzeni nazw. Deklaracja xmlns znajduje się w bieżącym węźle lub w węźle zlokalizowanym wyżej w hierarchii XML.
Jeśli węzeł XML nie ma prefiksu, wartość właściwości namespaceURI zależy od tego, czy jest zdefiniowana domyślna przestrzeń nazw (jak w deklaracji xmlns="http://www.example.com/"). Jeśli jest zdefiniowana domyślna przestrzeń nazw, właściwość namespaceURI będzie miała wartość tej domyślnej przestrzeni nazw. Jeśli nie ma domyślnej przestrzeni nazw, właściwość namespaceURI danego węzła jest ciągiem pustym ("").
Do identyfikowania przestrzeni nazw skojarzonej z określonym prefiksem służy metoda getNamespaceForPrefix(). Właściwość namespaceURI zwraca prefiks skojarzony z nazwą węzła.
Implementacja
public function get namespaceURI():StringPowiązane elementy interfejsu API
nextSibling | właściwość |
public var nextSibling:XMLNode| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość XMLNode, która odwołuje się do następnego węzła siostrzanego na liście potomków węzła nadrzędnego. Właściwość ma wartość null, jeśli węzeł nie ma następnego węzła siostrzanego. Tej właściwości nie można używać do manipulowania węzłami potomnymi; służą do tego metody appendChild(), insertBefore() i removeNode().
Powiązane elementy interfejsu API
nodeName | właściwość |
public var nodeName:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ciąg znaków reprezentujący nazwę węzła obiektu XMLNode. Jeśli obiekt XMLNode jest elementem XML (nodeType == 1), nodeName jest nazwą znacznika reprezentującego węzeł w pliku XML. Na przykład TITLE to nazwanodeName znacznika HTML TITLE. Jeśli obiekt XMLNode jest węzłem tekstowym (nodeType == 3), nodeName ma wartość null.
Powiązane elementy interfejsu API
nodeType | właściwość |
public var nodeType:uint| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Stała będą wartością parametru nodeType: XMLNodeType.ELEMENT_NODE w przypadku elementu XML albo XMLNodeType.TEXT_NODE w przypadku węzła tekstowego.
Wartość nodeType jest liczbą należącą do typu wyliczeniowego NodeType opisanego w zaleceniu W3C DOM Level 1: http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html. Wartości wymieniono w poniższej tabeli:
| Wartość całkowita | Zdefiniowana stała |
|---|---|
| 1 | ELEMENT_NODE |
| 3 | TEXT_NODE |
| 5 | ENTITY_REFERENCE_NODE |
| 7 | PROCESSING_INSTRUCTION_NODE |
| 9 | DOCUMENT_NODE |
| 11 | DOCUMENT_FRAGMENT_NODE |
W programie Flash Player wbudowana klasa XMLNode obsługuje tylko wartości XMLNodeType.ELEMENT_NODE i XMLNodeType.TEXT_NODE.
Powiązane elementy interfejsu API
nodeValue | właściwość |
public var nodeValue:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość węzła obiektu XMLDocument. Jeśli obiekt XMLDocument jest węzłem tekstowym, właściwość nodeType ma wartość 3, a właściwość nodeValue zawiera tekst węzła. Jeśli obiekt XMLDocument jest elementem XML (nodeType ma wartość 1), właściwość nodeValue jest równa null i przeznaczona tylko do odczytu.
Powiązane elementy interfejsu API
parentNode | właściwość |
public var parentNode:XMLNode| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość XMLNode, która odwołuje się do węzła macierzystego określonego obiektu XML, a jeśli węzeł nie ma węzła nadrzędnego zwraca wartość null. Jest to właściwość przeznaczona tylko do odczytu i nie można jej używać do manipulowania węzłami potomnymi; służą do tego metody appendChild(), insertBefore() i removeNode().
Powiązane elementy interfejsu API
prefix | właściwość |
prefix:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Prefiks nazwy węzła XML. Na przykład węzeł <contact:mailbox/>bob@example.com</contact:mailbox> ma prefiks "contact" i nazwę lokalną "mailbox", a pełna nazwa elementu to "contact.mailbox".
Właściwość nodeName obiektu węzła XML zwraca pełną nazwę (składającą się z prefiksu i nazwy lokalnej). Dostęp do nazwy lokalnej będącej częścią nazwy elementu można uzyskać za pośrednictwem właściwości localName.
Implementacja
public function get prefix():StringpreviousSibling | właściwość |
public var previousSibling:XMLNode| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość XMLNode, która odwołuje się do poprzedniego węzła siostrzanego na liście potomków węzła nadrzędnego. Właściwość ma wartość null, jeśli węzeł nie ma poprzedniego węzła siostrzanego. Tej właściwości nie można używać do manipulowania węzłami potomnymi; służą do tego metody appendChild(), insertBefore() i removeNode().
Powiązane elementy interfejsu API
XMLNode | () | Konstruktor |
public function XMLNode(type:uint, value:String)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy nowy obiekt XMLNode. Przed wywołaniem którejkolwiek metody klasy XMLNode należy za pomocą konstruktora utworzyć obiekt XMLNode.
Uwaga: Do dodawania elementów i węzłów tekstowych do drzewa dokumentu XML należy używać metod createElement() i createTextNode().
type:uint — Typ węzła: 1 w przypadku elementu XML albo 3 w przypadku węzła tekstowego.
| |
value:String — Tekst XML przeanalizowany w celu utworzenia nowego obiektu XMLNode.
|
Powiązane elementy interfejsu API
appendChild | () | metoda |
public function appendChild(node:XMLNode):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dołącza określony węzeł do listy elementów potomnych obiektu XML. Ta metoda działa bezpośrednio na węźle wskazywanym przez parametr childNode; nie dołącza ona kopii węzła. Jeśli węzeł przeznaczony do dołączenia już istnieje w innej strukturze drzewa, dołączenie węzła do nowego położenia spowoduje usunięcie go z obecnego położenia. Jeśli parametr childNode wskazuje węzeł, który już istnieje w innej strukturze drzewa XML, dołączony węzeł potomny zostanie usunięty z istniejącego węzła nadrzędnego i dopiero potem umieszczony w nowej strukturze drzewa.
Parametry
node:XMLNode — Obiekt XMLNode reprezentujący węzeł, który ma zostać przeniesiony z jego bieżącego położenia na listę węzłów podrzędnych obiektu my_xml.
|
cloneNode | () | metoda |
public function cloneNode(deep:Boolean):XMLNode| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Konstruuje i zwraca nowy węzeł XML, którego typ, nazwa, wartość i atrybuty są identyczne jak w przypadku określonego obiektu XML. Jeśli parametr deep jest ustawiony na true, wszystkie węzły potomne są klonowane rekurencyjnie, wskutek czego powstaje dokładna kopia drzewa dokumentu oryginalnego obiektu.
Zwrócony klon węzła nie jest już skojarzony z drzewem sklonowanego elementu. Dlatego właściwości nextSibling, parentNode i previousSibling mają wartość null. Jeśli parametr deep jest ustawiony na false lub węzeł my_xml nie ma węzłów potomnych, właściwości firstChild i lastChild także są równe null.
Parametry
deep:Boolean — Wartość typu Boolean; jeśli jest ustawiona na true, obiekty potomne określonego obiektu XML będą klonowane rekurencyjnie.
|
XMLNode — Obiekt XMLNode.
|
getNamespaceForPrefix | () | metoda |
public function getNamespaceForPrefix(prefix:String):String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca identyfikator URI przestrzeni nazw, skojarzony z określonym prefiksem węzła. Aby określić identyfikator URI, metoda getPrefixForNamespace() przeszukuje hierarchię XML od węzła w górę i zwraca identyfikator URI pierwszej deklaracji xmlns dla danego prefiksu (prefix).
Jeśli dla określonego prefiksu nie ma zdefiniowanej przestrzeni nazw, metoda zwraca null.
W przypadku określenia pustego ciągu ("") jako parametru prefix i obecności definicji domyślnej przestrzeni nazw w węźle (tak jak w xmlns="http://www.example.com/"), metoda zwraca identyfikator URI tej domyślnej przestrzeni nazw.
Parametry
prefix:String — Prefiks, dla którego metoda zwraca skojarzoną przestrzeń nazw.
|
String — Przestrzeń nazw skojarzona z określonym prefiksem.
|
Powiązane elementy interfejsu API
getPrefixForNamespace | () | metoda |
public function getPrefixForNamespace(ns:String):String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca prefiks skojarzony z identyfikatorem URI przestrzeni nazw węzła. Aby określić prefiks, metoda getPrefixForNamespace() przeszukuje hierarchię XML od węzła w górę i zwraca prefiks pierwszej deklaracji xmlns z identyfikatorem URI przestrzeni nazw zgodnym z parametrem ns.
Jeśli dla danego identyfikatora URI nie ma pasujących deklaracji xmlns, metoda zwraca null. Jeśli dla danego identyfikatora URI istnieje deklaracja xmlns, ale nie zawiera ona przypisania prefiksu, metoda zwraca pusty ciąg znaków ("").
Parametry
ns:String — Identyfikator URI przestrzeni nazw, dla której metoda zwraca skojarzony prefiks.
|
String — Prefiks skojarzony z określoną przestrzenią nazw.
|
Powiązane elementy interfejsu API
hasChildNodes | () | metoda |
public function hasChildNodes():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wskazuje, czy określony obiekt XMLNode ma węzły potomne. Ta właściwość ma wartość true, jeśli określony obiekt XMLNode ma węzły potomne; w przeciwnym razie ma wartość false.
Boolean — Zwraca wartość true, jeśli określony obiekt XMLNode ma węzły potomne; w przeciwnym razie zwraca wartość false.
|
insertBefore | () | metoda |
public function insertBefore(node:XMLNode, before:XMLNode):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Umieszcza nowy węzeł potomny na liście elementów potomnych obiektu XML, przed węzłem określonym za pomocą parametru beforeNode. Jeśli parametr beforeNode jest niezdefiniowany lub równy null, węzeł jest dodawany za pomocą metody appendChild(). Jeśli parametr beforeNode nie określa węzła potomnego względem obiektu my_xml, wstawianie kończy się niepowodzeniem.
Parametry
node:XMLNode — Węzeł XMLNode, który ma być wstawiony.
| |
before:XMLNode — Obiekt XMLNode przed punktem wstawienia węzła childNode.
|
Powiązane elementy interfejsu API
removeNode | () | metoda |
public function removeNode():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Usuwa określony obiekt XML z obiektu nadrzędnego. Usuwa także wszystkich potomków węzła.
toString | () | metoda |
public function toString():String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Analizuje określony obiekt XMLNode, konstruuje tekstową reprezentację struktury XML (łącznie z węzłem, jego węzłami potomnymi i atrybutami) i zwraca wynik w postaci ciągu znaków.
W przypadku obiektów XMLDocument najwyższego poziomu (utworzonych za pomocą konstruktora) metoda XMLDocument.toString() generuje deklarację XML dokumentu (zapisaną we właściwości XMLDocument.xmlDecl), a po niej deklarację DOCTYPE dokumentu (zapisaną we właściwości XMLDocument.docTypeDecl), po niej zaś reprezentację tekstową wszystkich węzłów XML w obiekcie. Deklaracja XML nie jest uwzględniana w wynikach, jeśli właściwość XMLDocument.xmlDecl jest równa null. Deklaracja DOCTYPE nie jest uwzględniana w wynikach, jeśli właściwość XMLDocument.docTypeDecl jest równa null.
String — Ciąg znaków reprezentujący obiekt XMLNode.
|
Powiązane elementy interfejsu API
package {
import flash.display.Sprite;
import flash.xml.XMLDocument;
import flash.xml.XMLNode;
import flash.xml.XMLNodeType;
public class XMLDocumentExample extends Sprite {
public function XMLDocumentExample() {
var result:XMLDocument = new XMLDocument();
result.ignoreWhite = true;
result.parseXML(getXMLString());
var books:Array = parseBooks(result.firstChild);
trace("books: \n" + books);
}
private function parseBooks(node:XMLNode):Array {
var books:Array = new Array();
var kids:Array = node.childNodes;
for each(var item:XMLNode in kids) {
parseBook(item, books);
}
return books;
}
private function parseBook(node:XMLNode, books:Array):void {
var item:Book = new Book();
item.setPublisher(node.attributes.publisher);
item.setName(node.attributes.name);
books.push(item);
}
private function getXMLString():String {
var list:XML = <books>
<book publisher="Addison-Wesley" name="Design Patterns" />
<book publisher="Addison-Wesley" name="The Pragmatic Programmer" />
<book publisher="Addison-Wesley" name="Test Driven Development" />
<book publisher="Addison-Wesley" name="Refactoring to Patterns" />
<book publisher="O'Reilly Media" name="The Cathedral & the Bazaar" />
<book publisher="O'Reilly Media" name="Unit Test Frameworks" />
</books>;
return list.toXMLString();
}
}
}
class Book {
private var publisher:String;
private var name:String;
public function setPublisher(publisher:String):void {
this.publisher = publisher;
}
public function setName(name:String):void {
this.name = name;
}
public function toString():String {
return "[Book name: " + name + " publisher: " + publisher + "]\n";
}
}
Tue Jun 12 2018, 12:06 PM Z