Недавно один хороший человек предложил сделать сайт на Flash и именно на ActionScript 2. Проект мне понравился тем, что уже практически всё было готово к моей работе, т.е. предоставили FLA файл с дизайном и PDF с описанием как должно всё выглядеть после завершения задания. И, как всегда, оказалось, что работу нужно делать на вчера.
Сайт разбит на разделы отдельными файлами, каждый из них загружается после нажатия кнопки меню. Сайт должен получать все данные с помощью XML сгенерированным со всеми динамическими данными. Вот тут я начал вспоминать DOM XML модель ActionScript 2, которой мне предстоит пользоваться – постоянные поиски нужных узлов, использование ID'шников и XMLNode.firstChild/lastChild/childNodes. В общем, эйфория с E4X закончилась. Тогда я решил написать более удобные интерфейсы для доступа к XML данным. Это не E4X, но намного удобнее (как мне показалось) средств класса XMLNode.
Пример XML документа, который будет использован далее:

<?xml version="1.0" encoding="utf-8"?>
<root test="true">
	<child length="5">
		<node value="one"/>
		<node value="two"/>
		<node value="three"/>
		<node value="four"/>
		<node value="five"/>
		<![CDATA[child 1 data]]>
	</child>
	<child attr1="value 1"><![CDATA[child 2 data]]></child>
	<child attr2="value 2"><![CDATA[child 3 data]]></child>
	<another1/>
	<another2/>
</root>

import aw.template.xml.XMLMirror;
var mrr:XMLMirror = new XMLMirror(XML);
trace(mrr.test); // true
trace(mrr.children.child.getValue()); // child 1 data
trace(mrr.children.child.children.node.value); // one

По примеру не трудно догадаться, что атрибуты узлов становятся свойствами объектов, а дочерние узлы становятся свойствами объекта children. На самом деле всё обстоит немного сложнее. В обоих случаях – XMLMirror и XMLAccessor, я использовал "волшебный" метод Object.__resolve.
В XMLMirror, атрибуты сохраняются в объекте XMLMirror.attributes, а метод XMLMirror.__resolve перенаправляет запрос на объект attributes.
Дочерние узлы сортируются по именам в объектеXMLMirror.children. Для одноимённых узлов создаются объекты MirrorList, в них и сохраняются узлы с одинаковыми именами. MirrorList сам не является массивом, но хранит внутри себя массив элементов и использует метод MirrorList.__resolve. Он возвращает элемент по номеру, а если номер не задан, то перенаправляет запрос на первый элемент массива, с индексом "0".
Пример:

import aw.template.xml.XMLMirror;
var mrr:XMLMirror = new XMLMirror(XML);
// разные способы доступа к атрибуту дают один результат
trace(mrr.test); // true
trace(mrr.attributes.test); // true
// доступ к атрибуту length первого узла child
trace(mrr.children.child.length); // 5
// доступ к массиву узлов child
trace(mrr.children.child.getList()); // child 1 data,child 2 data,child 3 data
// доступ к массиву длине массива узлов child
trace(mrr.children.child.getLength()); // 3
// разные способы доступа к узлу дают один результат
trace(mrr.children.child.children.node.value); // one
trace(mrr.children.child.children.node[0].value); // one
// получение количества всех одноимённых вложеных узлов
trace(mrr.getDescendants('node').getLength()); // 5

Свойства объекта XMLMirror:

• attributes:Object – объект содержащий атрибуты узла
• children:Object – объект содержащий списки дочерних узлов

Методы объекта XMLMirror:

• getChildList():MirrorList – возвращает массив дочерних узлов
• getChildNames():Array – возвращает массив имён дочерних узлов
• getDescendants(name:String):MirrorList – возвращает все одноимённые вхождения
• getName():String – имя XML узла
• getParent():XMLMirror – указывает на родительский объект XMLMirror
• getValue():String – содержит строковое значение из XML узла
• toString():String – возвращает строковое значение хранящееся из XML узла
• create(xml:XMLNode, save:Boolean):XMLMirror – статический метод создающий XMLMirror

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

• XMLNode – Узел, который следует преобразовать.
• Boolean – указывает на необходимость сохранение порядка элементов. Если установить в true, то метод getChildList будет возвращать список дочерних узлов сохраняя их последовательность, предопределённую в XML документе. Иначе, узлы будут каталогизированы по именам в любом порядке. По умолчанию, имеет значение "false".

Методы объекта MirrorList:

• clone():MirrorList – клонирует список узлов
• getLength():Number – возвращает количество элементов
• getList():Array – возвращает массив элементов списка
• pop():Object – вызывает одноимённый метод в массиве содержащем элементы списка
• push(o:Object, …):Number – вызывает одноимённый метод в массиве содержащем элементы списка
• shift():Object – вызывает одноимённый метод в массиве содержащем элементы списка
• unshift(o:Object, …):Number – вызывает одноимённый метод в массиве содержащем элементы списка

Загрузить все классы XMLMirror.

import aw.template.xml.XMLAccessor;
var acc :XMLAccessor = new XMLAccessor(XML);
// доступ к атрибуту
trace(acc.$test); // true
trace(acc.child.node.$value); // one
trace(acc.child.node[1].$value); // two
// доступ к дочернему узлу, без индекса узла - возвращается XMLAccessorList
trace(acc.another1); // <another1 />
// доступ к атрибуту узла без указания его ноиера
trace(acc.child.$length); // 5
// количество дочерних узлов "node"
trace(acc.child.node.getLength()); // 5
// количество всех узлов. здесь используется XMLAccessor только для получения узла child,
// а дальше обращение происходит к свойству childNodes объекта XMLNode.
trace(acc.child.childNodes.length); // 6
// аналогично предыдущему - XMLAccessor использовался только для получения втрого узла child.
trace(acc.child[1].firstChild.nodeValue); // child 2 data

При попытке получения узла без указания индекса узла, вы всегда будете получать объект типа XMLAccessorList.

Для всех дочерних одноимённых узлов создаются списки, использующие метод "__resolve". Такие списки создаются во время выполнения запроса, по имени узла. Если номер узла не задан, то будет использован первый элемент из списка. Списком является объект типа XMLAccessorList, содержащий в себе массив.
Каждый раз, используя данный стиль доступа, нужно создавать объект XMLAccessor, привязывая его к XML узлу (достаточно передать в конструктор). И именно этот, созданный объект, нужно использовать как корневой элемент для цепочек доступа. Так же, следует учитывать, что нельзя прерывать цепочку доступа переходя на нативные способы DOM XML и после этого пытаться опять воспользоватся свойствами XMLAccessor, т.е. он действует, только если вести непрерывную цепочку доступа от объекта XMLAccessor к цели.
Пример:

import aw.template.xml.XMLAccessor;
var acc :XMLAccessor = new XMLAccessor(XML);
// правильно
trace(acc.child); //  получаем XMLAccessorList c одним узлом: <child length="5">...
trace(acc.child.node); // получаем XMLAccessorList: <node value="one" />,<node...
trace(acc.child.node[4]); // <node value="five" />
trace(acc.another1); // получаем XMLAccessorList c одним узлом: <another1 />
// неправильно
var child:XMLNode = acc.child[0];
trace(child.node[3]);
// неправильно
trace(acc.childNodes[0].node[3])

Никаких методов и свойств объект XMLAccessor не определяет.
Конструктор XMLAccessor принимает один параметр:

• XML/XMLNode – Узел, который будет использоватся

Методы объекта XMLAccessorList:

• toString():String – строковое представление массива элементов списка
• valueOf():Array – массив содержащий элементы списка
• getList():Array – массив содержащий элементы списка
• getLength():Number – количество элементов списке

Общим недостатком обоих методов можно считать отсутствие поддержки пространств имён – вы не сможете воспользоваться ими в данном случае.

Метки: ActionScript 3, E4X, EventDispatcher, Proxy, XML

Запись опубликована 29.06.2008 в 6:42 пп и размещена в рубрике ActionScript 2, Flash. Вы можете следить за обсуждением этой записи с помощью ленты RSS 2.0. Можно оставить комментарий или сделать обратную ссылку с вашего сайта.