ГлавнаяСправка по использованию серверного ActionScript › Класс XML

Класс XML

Класс XML: Методы и свойства

Класса XML позволяет загружать, анализировать, отправлять, создавать динамически и изменять XML документы.

Примечание: Загрузить XML файлы можно только по протоколу HTTP, но никак не RTMP.

Прежде, чем станет возможным использовать методы и функции класса XML, необходимо воспользоваться конструктором new XML(), чтобы создать объект класса XML.

Документы XML представлены классом XML. Каждый элемент иерархической структуры документа представлен объектом XMLNode.

Объекты XML и XMLNode построены основываясь на предписании к объектной модели документов первого уровня ( Document Object Model Level 1) которое можно найти по адресу www.w3.org. Предписание содержит спецификации интерфейсов узла и документа. Интерфейс документа наследуется из интерфейса узла, и добавляет методы, такие как createElement() и createTextNode(). В ActionScript объекты XML и XMLNode разработаны с целью разделения функциональности этих классов там, где они совпадают в предписании.

Примечание: Большинство примеров кода для класса XML содержат заявления trace(). Серверное заявление trace() записываются в файл событий приложения и выводятся в панель Журнала Собитий Консоли Администратора.

Доступно с версии

Flash Media Server 2

Краткое описание свойств

Свойство

Описание

XML.attributes

Объект, содержащий все атрибуты заданного объекта XML.

XML.childNodes

Массив дочерних узлов указанного объекта XML. Только чтение;

XML.contentType

MIME тип данных, передаваемых серверу вызовами методов XML.send() или XML.sendAndLoad().

XML.docTypeDecl

Определяет информацию об объявлении DOCTYPE XML документа.

XML.firstChild

Только чтение; Оценивает указанный объект XML и ссылается на первый дочерний узел в списке дочерних узлов узла-родителя.

XML.ignoreWhite

При значении true текстовые узлы, содержащие только пробелы, пропускаются в процессе анализа.

XML.lastChild

Только чтение; Значение XMLNode, ссылающееся на последний узел того же уровня в списке дочерних узлов узла-родителя.

XML.loaded

Булево значение; true если процесс загрузки вызванный методом XML.load() завершился успешно; в противном случаи false.

XML.localName

Только чтение; часть полного имени, содержащее локальное имя XML узла.

XML.namespaceURI

Только чтение; Если узел XML имеет префикс, то namespaceURI является значением объявления xmlns для этого префикса (URI), который обычно называется URI пространства имен.

XML.nextSibling

Только чтение; Значение XMLNode, ссылающееся на следующий узел того же уровня в списке дочерних узлов узла-родителя.

XML.nodeName

Строка, представляющая имя узла объекта XML.

XML.nodeType

Только чтение; Значение константы nodeType, 1 для элемента XML либо 3 для текстового узла.

XML.nodeValue

Значение узла объекта XML.

XML.parentNode

Только чтение; Значение XMLNode, указывающее на родительский узел заданного объекта XML, либо возвращающее null, если родительский узел отсутствует.

XML.prefix

Только чтение; Префикс имени узла XML.

XML.previousSibling

Только чтение; Значение XMLNode, ссылающееся на предыдущий родственный элемент того же уровня в списке дочерних узлов узла-родителя.

XML.status

Числовой код, определяющий удачно или неудачно прошел процесс синтаксического анализа XML документа.

XML.xmlDecl

Строка, задающая информацию об определении XML в документе.

Краткое описание методов

Метод

Описание

XML.addRequestHeader()

Добавляет или изменяет заголовки HTTP запросов (таких как, например, Content-Type или SOAPAction), посылаемых методом POST.

XML.appendChild()

Добавляет указанный узел к списку дочерних узлов объекта XML.

XML.cloneNode()

Формирует и возвращает новый объект XMLNode того же типа, с тем же именем, значением выводимым в Консоль Администратора и атрибутами, что и заданный объект XML.

XML.createElement()

Создает новый XML элемент с именем, заданным параметром name.

XML.createTextNode()

Создает новый текстовый узел XML с заданным текстом.

XML.getBytesLoaded()

Возвращает число загруженных (или полученных в потоке) байт указанного XML документа.

XML.getBytesTotal()

Возвращает размер документа XML в байтах.

XML.getNamespaceForPrefix()

Возвращает унифицированный идентификатор ресурса (URI-адрес) пространства имен, связанного с указанным префиксом узла.

XML.getPrefixForNamespace()

Возвращает префикс, связанный с заданным URI пространства имен узла.

XML.hasChildNodes()

Возвращает true если у заданного объекта XML есть дочерние узлы; в противном случаи возвращает, false.

XML.insertBefore()

Добавляет новый дочерний узел перед указным узлом в список дочерних узлов объекта XML.

XML.load()

Загружает XML документ с объекта типа File или по HTTP с указанного URL и заменяет содержимое вызвавшего его XML объекта загруженными XML данными.

XML.parseXML()

Проводит анализ XML текста, переданного в параметре source, и присваивает указанному XML объекту полученное XML дерево.

XML.removeNode()

Удаляет заданный объект XML из его родительского объекта, так же удаляет все потомки узла.

XML.send()

Перекодирует указанный объект XML в XML документ и отправляет по указанному URL при помощи метода POST.

XML.sendAndLoad()

Перекодирует указанный объект XML в XML документ и отправляет по указанному URL при помощи метода HTTP POST, скачивает ответ сервера и загружает его в указанный объект.

XML.toString()

Оценивает заданный объект XML, формирует текстовое представление структуры XML, включая узел, его дочерние объекты и атрибуты, и возвращает результат в виде строки.

Краткое описание обработчиков событий

Обработчик событий

Описание

XML.onData()

Вызывается когда XML текст был полностью скачан из сервера или когда происходит ошибка скачивания текстового XML с сервера.

XML.onHTTPStatus()

Вызывается когда Flash Media Interactive Server получает от сервера HTTP код состояния.

XML.onLoad()

Вызывается когда XML документа получен от сервера.

Ярлыки: , ,

  1. Пока без комментариев.
  1. Пока нету.