Примеры использования объектов
Приведем некоторые примеры использования объектной модели.
Создание объекта документа
Работа с содержимым XML документа в DOM начинается с создания объекта, реализующего методы класса Document. В IE5 этим объектом является XMLDOMDocument. Создание объекта из сценариев осуществляется при помощи стандартных методов new ActiveXObject(JScript) и CreateObject:
<script language="JScript">
var docobj = new ActiveXObject("Microsoft.XMLDOM");
...
и
<script language="VBScript">
Dim docobj
Set docobj = CreateObject("Microsoft.XMLDOM").
...
Если данные включаются в документ в виде DSO-объектов, то для доступа к документу можно также использовать объектную модель HTMLстраницы, получая ссылку на XML-документ по идентификаторам соответствующих тэгов:
<XML id="source" src="source-file.xml"></XML>
<XML id="style" src="style-file.xsl"></XML>
<SCRIPT FOR="window" EVENT="onload">
xslArea.innerHTML = source.transformNode(style.XMLDocument);
</SCRIPT>
...
<DIV id="xslArea"></DIV>
Первым способом создаются объекты при "ручной"загрузке нового документа. Если же мы хотим получить доступ к данным, встроенным в страницу при помощи тэгов xml или object, то используется второй способ.
Объектной переменной XMLDOMDocument также можно присвоить ссылку на другой объект созданного раннее документа:
docobj.documentElement = otherobj;
Загрузка XML-документа
Все необходимые манипуляции с XML документом осуществляются после его загрузки и создания дерева элементов. Загрузка может осуществляться либо при помощи указателя на соответствующий ресурс: docobj.load("http://myserver/xml/notes.xml"), либо "на лету", при помощи метода loadXML, которому в качестве параметра передается строка- отрывок XML документа:
docobj.loadXML("<recipe><step id='1'>Насыпать чай</step><step id='2'>Залить кипятком </step> <step id='3'>Вылить</step></recipe>");
Анализ документа
Для управления процессом анализа документа можно изменять следующие рассмотренные ранее свойства XMLDOMObject : async, validateOnParse, resolveExternals, preserveWhiteSpaces.
Необходимо запомнить, что анализ XML документа производится непосредственно после загрузки его содержимого - остановить этот процесс можно только используя метод abort. Поэтому свойства обработчика нужно изменять перед его загрузкой.
В процессе анализа документа обработчиком могут вызываться некоторые события, перехватывая которые можно отслеживать все шаги обработки. Для назначения классов обработчиков используются свойства , описанные в таблице. Вот пример программы-обработчика события , возникающего при изменении текущего состояния анализатора.
<script>
var xmldoc;
var messages = new Array(5);
var result_str = " Демонстрация обработки событий<hr/>";
messages[0]="Загрузка документа.";
messages[1]="Загрузка завершена. Начинаю анализ документа";
messages[2]="Начинаю создание объектной модели";
messages[3]="Обработку завершил";
function startParse(url){
xmldoc = new ActiveXObject("Microsoft.XMLDOM");
xmldoc.onreadystatechange = onChangeState;
xmldoc.load(url);
xmlMessages.innerHTML = result_str;
}
function onChangeState(){
var state = xmldoc.readyState;
result_str += messages[state-1] + "<BR>";
}
</script>
<BODY onLoad="startParse('notepad.xml')">
<DIV id="xmlMessages"></DIV>
</BODY>
Другой способ назначить обработчик событий для элемента - это использование атрибута event тэга <script>:
<XML id="xmlID" src="notes.xml"></XML>
<script for="xmlID" event="onreadystatechange">
alert(xmlID.readyState);
</script>
Обработка ошибок
Информация об обнаруженных в результате разбора XML-документа ошибках передается сценарию через объект XMLDOMParseError. Ссылку на него возвращает метод parseError объекта XMLDOMDocument. Узнать о типе ошибки можно по ее коду, содержащемся в свойстве errorCode (если разбор закончился успешно, то значение errorCode равно 0). При помощи свойств filepos, line, linepos, reason, srcText и url можно получить полную информацию о причине появления ошибки и ее местонахождении.
<SCRIPT language="JavaScript">
var docobj;
var result_str = "<hr/>";
function view(){
docobj = new ActiveXObject("Microsoft.XMLDOM");
docobj.load("music.xml");
if (docobj.parseError.errorCode != 0){
xmlTree.innerHTML=reportParseError(docobj.parseError);
return;
}
xmlTree.innerHTML = docobj.xml;
}
function reportParseError(error){
error_str = "<H4>Ошибка при загрузке документа '" + error.url + "'</H4>" +
"<p><font color='red'>" + error.reason + "</font></p>";
if (error.line > 0)
error_str += "<H5>" + "Строка " + error.line + ", символ " + error.linepos +
"\n" + error.srcText + "</H4>";
return error_str;
}
</script>
<BODY onLoad="startParse()">
<DIV id="xmlTree"></DIV>
</BODY>
</HTML>
...
Сохранение XML документа.
Созданное в памяти компьютера объектное дерево можно сохранить в текстовый файл, используя метод save:
xmlobj.save ("menu.xml");
Кроме этого, XML-документ можно сохранить в другом XMLDOMDOcument объекте, передав в качестве аргумента функции ссылку на него.
Обход дерева элементов
Для работы со списком элементов в объектной модели XML-анализатора Microsoft предназначены специальные объекты: XMLDOMNode - представляющий узел дерева и XMLDOMNodeList - список узлов, поддерево. Их описание приведено в таблице.
Просмотр списка элементов документа всегда начинается с получения нужного поддерева. Для этого у объекта XMLDOMNode используется методы childNodes, selectNodes или getElementsByTagName, возвращающие объект XMLDOMNodeList. Количество элементов этом поддереве можно узнать при помощи свойства length.
Вот, например, как будет выглядеть процедура рекурсивного просмотра документа произвольной структуры:
<SCRIPT language="JavaScript">
var result_str = "<hr/>";
var docobj = new ActiveXObject("Microsoft.XMLDOM");
function printElements(){
docobj.load("music.xml");
viewNode(docobj.documentElement);
xmlTree.innerHTML = result_str;
}
function viewNode(node){
var childnodes = curNode.childNodes.length;
result_str+=" "+curNode.nodeName+"<br/>";
for(var i=0;i<childnodes;i++){
viewNode(curNode.childNodes.item(i));
}
}
</SCRIPT>
<BODY onLoad="printElements()">
<DIV id="xmlTree"></DIV>
</BODY>
</HTML>
Навигация по документу осуществляется обычным перебором массива элементов в цикле for или при помощи методf nextNode. И в том и в другом случае мы сначала выбираем нужное поддерево, а затем обрабатываем его элементы. Необходимо заметить также, что в XMLDOMNodeList отражаются все изменения, вносимые в структуру XML-документа, и информация в результате будет всегда актуальной.
Поиск элемента
Поиск нужного элемента или поддерева осуществляется при помощи методов selectNode и selectSingleNode (то же что и selectNode, только возвращает первый найденный элемент). В качестве параметров им необходимо указать строку XSL запроса (образец поиска - XSL pattern).
Синтаксис языка запросов очень гибок и является одним из самых мощных механизмов в XSL - при помощи них можно осуществлять поиск элемента по названию, значению атрибутов, содержанию, учитывая вложенность и положение в дереве элементов. Наиболее ярко все эти возможности демонстрируются при обработке XML-документов стилевыми таблицами XSL , когда мы можем выделять из общего дерева необходимые нам элементы и применять к ним специальные форматирующие инструкции.
Внешне язык XSL запросов немного напоминает обычный способ определения пути к ресурсу в файловой системе - список узлов дерева, разделенных символом /. Для указания на текущий элемент используется символ "." , на родительский - "..", для выделения всех дочерних элементов - символ "*", для выделения элемента, расположенного просто "ниже" по дереву(не важно на каком уровне вложенности) - "//".
Вот примеры простых XSL шаблонов:
"/music-collection" - корневой элемент
"bards/" - возвращает дочерние элементы для элемента bards
"authors-list//" - список всех элементов, вложенных в authors-list
"author[@id]" - список элементов author, в котором определен атрибут id
"author[@id=2]" - элемент author, в котором значение атрибута id равно двум
"author[address]" - список элементов author, которые содержат хотя бы один элемент address
"author[address or city]" - список элементов author, содержащих элементы address или city
Условие на значение в запросе должно заключаться в символы "[" и "]". Для выбора значения атрибута в условии указывается символ @.
Применяя к XML- документу различные шаблоны поиска, можно осуществлять сложные манипуляции с его содержимым, динамически изменяя объем отображаемой пользователю информации в зависимости от производимых им действий (например, динамическая сортировка, отображение подчиненных таблиц и т.д.) Более подробное описание XSL-таблиц будет приведено в одной из следующих статей.
[Назад]
[Содержание]
[Вперед]
Если Вы не нашли что искали, то рекомендую воспользоваться поиском по сайту:
|