Доступ и отображение элементов XML-документа

В этом разделе вы познакомитесь с основными приемами использования HTML-страницы и DOM для отображения элементов XML-документа. Эти приемы демонстрируются в Листингах 9.2 и 9.3.

<?xml version="1.0"?>

<BOOK> <TITLE>The Adventures of Huckleberry Finn</TITLE> <AUTHOR>Mark Twain</AUTHOR> <BINDING>mass market paperback</BINDING> <PAGES>298</PAGES> <PRICE>$5.49</PRICE> </BOOK>

Листинг 9.2. Book.xml (html, txt)

Листинг 9.3. DomDemo Fixed.htm (html, txt)

Листинг 9.2 содержит простой XML-документ, который описывает одну книгу. Его корневой элемент, BOOK, содержит пять дочерних элементов (TITLE, AUTHOR, BINDING, PAGES и PRICE), каждый из которых содержит символьные данные, описывающие характеристики книги.

Листинг 9.3 содержит HTML-страницу, которая отображает содержимое каждого из дочерних элементов в XML-документе. На рисунке 9.2 показано как эта страница выглядит в Internet Explorer 5.

Рис. 9.2.

XML-документ связан со страницей через следующий фрагмент данных:

Страница отображает XML-документ посредством следующего блока кода сценария, который содержится в элементе HEAD страницы:

<SCRIPT LANGUAGE="JavaScript" FOR="window" EVENT="ONLOAD"> Document = dsoBook.XMLDocument; title.innerText= Document.documentElement.childNodes(0)text; author.innerText= Document.documentElement.childNodes(1)text; binding.innerText= Document.documentElement.childNodes(2)text; pages.innerText= Document.documentElement.childNodes(3)text; price.innerText= Document.documentElement.childNodes(4)text; </SCRIPT>

Установки атрибутов FOR="window" и EVENT="ONLOAD" предписывают браузеру выполнять код из элемента SCRIPT при первом открытии окна страницы до того, как будет отображено содержимое страницы.

Ссылка. Примеры сценариев в этой лекции написаны на языке Microsoft JScript – версии Microsoft родового языка для сценариев JavaScript. Полную информацию о JScript, включая учебник, вы можете найти на следующих Web-сайтах, предоставленных MSDN: http://msdn.microsoft.com/workshop/c-frame.htm#/workshop/languages/jscript/handling.asp и http://msdn.microsoft.com/scripting/default.htm?/scripting/jscript/default.htm.

Сценарий первым делом получает узел Document, который представляет весь документ и формирует корневой элемент иерархии узлов DOM. Он делает это через член XMLDocument DSO, как было описано ранее в этой лекции:

Document = dsoBook.XMLDocument;

Далее сценарий получает доступ и отображает символьные данные, содержащиеся в каждом из дочерних элементов корневого элемента (TITLE, AUTHOR, BINDING, PAGES и PRICE). Например, он отображает содержимое первого дочернего элемента (TITLE) следующим образом:

title.innerText= Document.documentElement.childNodes(0).text;

Вот пояснение выражения, стоящего справа от знака равенства.

Document содержит узел Document в основании (корне) иерархии узлов DOM.documentElement представляет собой свойство узла Document. Оно содержит узел Element, представляющий корневой элемент XML-документа – в нашем примере, BOOK.

Примечание. Свойство documentElement является одним из специфических для конкретного узла свойств, предоставляемых узлом типа Document. В таблице 9.3 представлены другие полезные свойства, а также методы, относящиеся к узлу Document. Имейте в виду, что для узла Document вы можете использовать и общие свойства узлов, представленные в таблице 9.2.

childNodes является свойством узла Element для корневого элемента. Оно содержит множество всех дочерних узлов корневого узла Element, не являющихся атрибутами. В нашем примере оно содержит узлы Element для пяти дочерних XML-элементов: TITLE, AUTHOR, BINDING, PAGES и PRICE. Выражение childNodes(0) ссылается на первый из этих дочерних узлов (а именно, на элемент TITLE).

Примечание. В рассматриваемом примере страницы (Листинг 9.3) вы можете использовать выражение Document.childNodes(2), чтобы получить доступ к узлу корневого элемента. (Выражение Document.childNodes(0) относится к узлу XML-объявления, а выражение Document.childNodes(1) относится к узлу комментария.) Однако преимущество использования свойства documentElement узла Document заключается в том, что его значение не зависит от положения корневого элемента внутри XML-документа. Например, если бы вы удалили комментарий в начале документа, либо если бы добавили объявление типа документа, выражение Document.childNodes(2) больше не представляло бы корневой элемент.

text является свойством узла, возвращаемого выражением childNodes(0). Оно предоставляет весь текст, содержащийся в этом узле, а также текст, принадлежащий любому подчиненному узлу Element. В нашем примере TITLE не имеет подчиненных элементов, поэтому свойство text содержит только собственно текст элемента TITLE, "The Adventures of Huckleberry Finn".>

Доступ и отображение значений атрибутов в XML-документе

Атрибут, который содержится в XML-элементе, представляется дочерним узлом Attribute. Однако вы не сможете обратиться к дочернему узлу Attribute с использованием свойств childNodes, firstChild или lastChild, которые годятся для доступа к дочерним узлам других типов. Вместо этого вам потребуется воспользоваться свойством attributes узла Element.

Примечание. DOM использует узлы Attribute для представления не только атрибутов, но и нескольких типов других компонентов XML, которые состоят из пар имя-значение, а именно: имя и значение в инструкции по обработке (например, version="1.0" в XML-объявлении);ключевое слово SYSTEM, за которым следует системный литерал в объявлении типа документа, объявлении внешнего примитива, либо в объявлении нотации;ключевое слово NDATA, за которым следует имя нотации в объявлении не разбираемого примитива.

Возьмем в качестве примера XML-документ из Листинга 9.6.

<?xml version="1.0"?>

<INVENTORY> <BOOK Binding="mass market paperback" InStock="yes" Review="***"> <TITLE>The Adventures of Huckleberry Finn</TITLE> <AUTHOR Born="1835">Mark Twain</AUTHOR> <PAGES>298</PAGES> <PRICE>$5.49</PRICE> </BOOK> <BOOK Binding="hardcover" InStock="no"> <TITLE>Leaves of Grass</TITLE> <AUTHOR Born="1819">Walt Whitman</AUTHOR> <PAGES>462</PAGES> <PRICE>$7.75</PRICE> </BOOK> <BOOK Binding="mass market paperback" InStock="yes" Review="****"> <TITLE>The Legend of Sleepy Hollow</TITLE> <AUTHOR>Washington Irving</AUTHOR> <PAGES>98</PAGES> <PRICE>$2.95</PRICE> </BOOK> </INVENTORY>

Листинг 9.6. Inventory Attributes.xml (html, txt)

Элементы BOOK в этом документе имеют от двух до трех атрибутов. Следующее выражение в сценарии получает узел для первого элемента BOOK:

Document.documentElement.childNodes(0)

(В этих и последующих примерах в данном разделе предполагается, что Document содержит узел Document.)

Свойство attributes данного узла Element предоставляет набор NamedNodeMap узлов Attribute для всех атрибутов, принадлежащих первому элементу BOOK:

NamedNodeMap = Document.documentElement.childNodes(0).attributes

Групповой объект NamedNodeMap несколько отличается от группового объекта NodeList, предоставляемого свойством узла childNodes. В таблице 9.7 приведены свойство и несколько полезных методов, предоставляемых объектами NamedNodeMap.

Таблица 9.7. Свойство и некоторые полезные методы, предоставляемы групповым объектом NamedNodeMap. Свойство attributes узла предоставляет объект NamedNodeMapСвойство NamedNodeMapОписаниеПримерМетод NamedNodeMapОписаниеПример

length	Количество узлов, содержащихся в наборе	AttributeCount = Element.attributes.length;
getNamedItem (имя-атр)	Возвращает узел, который носит заданное имя	Attribute = Element.attributes.getNamedItem ("Binding");
item (индекс, отсчитываемый от нуля) (метод по умолчанию)	Возвращает узел в заданной индексом позиции (0 соответствует первому узлу)	SecondAttribute = Element.attributes.item (1); или SecondAttribute = Element.attributes (1);
reset ()	Устанавливает внутренний указатель на позицию перед первым узлом в наборе, так что последующий вызов nextNode возвращает первый узел	Element.attributes.reset ();
nextNode ()	Возвращает следующий узел в наборе в соответствии со значением внутреннего указателя	Element.attributes.reset (); FirstAttribute = Element.attributes.nextNode ();

Вы можете воспользоваться свойством length объекта NamedNodeMap и установленным по умолчанию методом item, чтобы перемещаться внутри набора и извлекать отдельные узлы Attribute. Например, следующий фрагмент сценария отображает имя и значение каждого атрибута для первого элемента BOOK рассматриваемого документа:

NamedNodeMap = Document.documentElement.childNodes(0).attributes; for (i=0; i<NamedNodeMap.length; ++i) alert ("node name: " + NamedNodeMap(i).nodeName + "\n" + "node value: " + NamedNodeMap(i).nodeValue);

Доступ к примитивам и нотациям XML

Как говорилось в лекции 6, вы используете объявление не разбираемого примитива для включения в XML-документ внешних данных. (Все не разбираемые примитивы являются общими внешними примитивами.) При использовании не разбираемого примитива вы назначаете его имя атрибуту типа ENTITY или ENTITIES, что ассоциирует файл внешнего примитива с определенным XML-элементом. XML-процессор не имеет доступа к файлу не разбираемого примитива. Он просто делает описание примитива и его нотацию доступными приложению, которое может получать и соответствующим образом использовать информацию.

В этом разделе вы познакомитесь с XML-документом и HTML-страницей, которые демонстрируют основные этапы в использовании DOM для извлечения из XML-документа информации о примитиве, а также нотации, описывающей формат примитива. Листинг 9.7 содержит пример XML-документа, а Листинг 9.8 содержит пример HTML-страницы.

Листинг 9.7. Inventory Entity.xml (html, txt)

Листинг 9.8. Inventory Entity.htm (html, txt)

Каждый элемент BOOK в рассматриваемом примере XML-документа содержит атрибут типа ENTITY с именем Review, которому присваивается имя не разбираемого примитива, содержащего обзор для данной книги. Пример HTML-страницы включает сценарий, который демонстрирует основные действия, которые сценарий DOM должен выполнить, чтобы извлечь всю информацию о примитиве при обнаружении атрибута с типом ENTITY или ENTITIES. В частности, сценарий извлекает информацию о не разбираемом примитиве, назначенном атрибуту Review для первого элемента BOOK. Он отображает эту информацию в окне предупреждающего сообщения, как показано на рисунке 9.7.

Рис. 9.7.

Вот краткое пояснение основных действий, выполняемых сценарием:

Attribute = Document.documentElement.childNodes(0).attributes(0);

Сценарий использует свойство dataType узла (см. таблицу 9.2), чтобы определить, имеет ли атрибут тип ENTITY:

if (Attribute.dataType == "entity") { /* получить информацию из примитива */ }

Использование других способов доступа к элементам

В рассмотренных примерах сценариев доступ к узлам Element в иерархической структуре осуществлялся с использованием свойств childNodes или firstChild узла. При этом происходил переход от одного узла к другому. Аналогичным образом вы можете применять свойства узла lastChild, previousSibling, nextSibling и parentNode (см. таблицу 9.2).

Примечание. Свойства childNodes, firstChild и lastChild дают возможность доступа только к дочерним узлам, которые не являются атрибутами, в то время как свойства previousSibling и nextSibling могут быть использованы для доступа к вершинному узлу любого типа.

Другим способом доступа к XML-элементам является использование свойства getElementsByTagName, которое позволяет извлечь все элементы, имеющие определенное имя типа (например, TITLE). Этот метод может использоваться для узла Document (см. таблицу 9.3), а также для узла Element (см. таблицу 9.6). Если вы обращаетесь к методу для узла Document, он возвращает набор узлов Element для всех элементов в документе, обладающих заданным именем типа. Например, следующий оператор позволяет получить группу узлов для всех элементов в документе, обладающих именем BOOK:

NodeList = Document.getElementsByTagName("BOOK");

Если вы обращаетесь к методу getElementsByTagName для узла Element, как в следующем примере, он возвращает набор узлов для всех соответствующих элементов, которые являются подчиненными для узла Element:

NodeList = Element.getElementsByTagName("AUTHOR");

Подсказка. Если в качестве параметра метода getElementsByTagName вы укажете "*", то метод вернет набор узлов для всех элементов (всех элементов в документе, если вы вызываете метод для объекта Document, и всех подчиненных элементов, если вы вызываете метод для объекта Element).

Таблица 9.6. Полезные методы, поддерживаемые узлами Element. Для узлов Element вы также можете применять общие свойства узлов, приведенные в таблице 9.2

Метод узла ElementОписаниеПример

getAttribute (имя-атр)	Возвращает значение атрибута элемента с заданным именем	AttValue = Element.getAttribute ("InStock");
getAttributeNode(имя-атр)	Возвращает узел Attribute, представляющий атрибут элемента с заданным именем	Attribute = Element.getAttributeNode ("InStock");
getElementsByTagName (имя-типа)	Возвращает набор NodeList узлов Element для всех подчиненных элементов элемента с заданным именем. Если указано "*", возвращает узлы для всех подчиненных элементов	AuthorElementCollection = Element.getElementsByTagName ("AUTHOR");

Метод getElementsByTagName предоставляет узлы Element в виде группового объекта NodeList. Доступ к отдельным узлам осуществляется с помощью действий, описанных в разделе "Использование объекта NodeList" ранее в этой лекции. Например, следующий код отображает (в окне предупреждения) текстовое содержимое всех узлов Element в объекте NodeList, возвращенное методом getElementsByTagName:

for (i=0; i < NodeList.length; ++i) alert (NodeList(i).text);

HTML-страница из Листинга 9.5 демонстрирует использование метода getElementsByTagName для узла Document. Страница отображает поле ввода INPUT типа TEXT, которое дает вам возможность ввести имя элемента. Когда вы щелкаете мышью на кнопке Show Elements, вызывается функция ShowElements сценария, которая использует метод getElementsByTagName для узла Document, чтобы найти и отобразить XML-разметку для всех элементов в документе, которые носят введенное вами имя элемента (если они имеются). Заметим, что сценарий использует свойство xml каждого из узлов Element для отображения содержимого XML-разметки элемента. Страница изначально связана с документом Inventory.xml, хотя вы можете отредактировать фрагмент данных, чтобы отобразить элементы из другого XML-документа. На рисунке 9.4 показано как Internet Explorer 5 отобразит страницу после того, как вы ввели в поле ввода INPUT имя AUTHOR и щелкнули мышью на кнопке Show Elements.

Рис. 9.4.

Листинг 9.5. GetElements.htm (html, txt)

Использование объекта NodeList

Свойство childNodes узла содержит набор дочерних узлов текущего узла, не являющихся атрибутами. (Доступ к дочерним узлам-атрибутам осуществляется через свойство attribute узла.) Определенный тип набора, который содержит свойство childNodes, носит название объекта NodeList.

Чтобы извлечь определенный дочерний узел из объекта NodeList, вы можете обратиться к его методу item, указав при этом индекс дочернего узла, который вы хотите получить (индексы отсчитываются с нуля). Например, обращение к следующему методу позволяет получить первый дочерний узел, принадлежащий узлу Element:

FirstNode = Element.childNodes.item(0);

Однако, поскольку item является методом по умолчанию объекта NodeList, вы можете опустить его, как это делалось в предыдущих примерах в этой лекции:

FirstNode = Element.childNodes(0);

В таблице 9.4 представлены свойства и методы, предоставляемые объектом NodeList.

Таблица 9.4. Свойство и методы, поддерживаемые групповым объектом NodeList. Доступ к объекту NodeList осуществляется через свойство childNodes узла

Свойство NodeListОписаниеПримерМетод NodeListОписаниеПример

length	Количество узлов, содержащихся в наборе	NodeCount = Element.childNodes.length;
item (индекс, отсчитываемый с 0) (метод по умолчанию)	Возвращает узел в соответствии с заданным вами индексом, при этом 0 соответствует первому узлу	SecondChild = Element.childNodes.item (1); или SecondChild = Element.childNodes (1);
reset()	Устанавливает внутренний указатель на позицию перед первым узлом в наборе, чтобы последующий вызов nextNode возвращал первый узел	Element.childNodes.reset ();
nextNode ()	Возвращает следующий узел в наборе в соответствии с позицией внутреннего указателя	Element.childNodes.reset (); FirstNode = Element.childNodes.nextNode ();

on_load_lecture()

Дальше »

Если Вы заметили ошибку - сообщите нам.

Страницы:

« |

вопросы | »

для печати и PDA

Телефон: +7 (495) 253-9312, 253-9313, факс: +7 (495) 253-9310, email: info@intuit.ru

Извлечение символьных данных элемента

В сценарии, представленном в Листинге 9.3, свойство text каждого из дочерних элементов (TITLE, AUTHOR, BINDING, PAGES и PRICE) используется для получения символьных данных элемента. Например, следующий оператор используется для извлечения символьных данных элемента TITLE:

title.innerText= Document.documentElement.childNodes(0).text;

Свойство text показывает содержимое элемента в текущем узле, плюс текстовое содержимое любого подчиненного элемента. Оно хорошо подходит для извлечения символьных данных элемента в том случае, если элемент не имеет дочерних элементов (например, элемент TITLE). Однако если элемент содержит один или более дочерних элементов помимо символьных данных, как в приведенном ниже примере, свойство text возвращает весь текст (в данном случае, "Moby-Dick Or, the Whale").

<TITLE>Moby-Dick <SUBTITLE>Or, the Whale</SUBTITLE> </TITLE>

Чтобы получить только символьные данные элемента TITLE, вам потребуется осуществить доступ к дочернему узлу Text.

Как видно из таблицы 9.1, свойство nodeValue узла Element имеет значение null. Если элемент содержит символьные данные, то они хранятся в дочернем узле Text, и вы можете получить их через свойство nodeValue узла Text. Например, чтобы получить данные элемента TITLE ("Moby-Dick"), из предыдущего примера, без символьных данных, принадлежащих элементу SUBTITLE, используем следующее выражение:

Element.firstChild.nodeValue

(Поскольку символьные данные элемента TITLE предшествуют подчиненному элементу, они представляются первым дочерним узлом, и вы можете извлечь их с помощью свойства firstChild.)

Если символьные данные элемента смешаны с дочерними элементами, комментариями или инструкциями по обработке, каждый отдельный блок символьных данных представляется собственным дочерним узлом Text. Например, приведенный ниже элемент ITEM имеет три дочерних узла, расположенных в следующем порядке: узел TEXT, представляющий первый блок символьных данных; узел ELEMENT, представляющий дочерний элемент SUB-ITEM; еще один узел TEXT, представляющий второй блок символьных данных:

<ITEM> блок символьных данных № 1 /* узел TEXT */ <SUB-ITEM>текст подчиненного элемента</SUB-ITEM> блок символьных данных № 2 /* узел TEXT */ </ITEM>

Метод и свойство, предоставляемые узлом Text, приведены в таблице 9.5.

Таблица 9.5. Полезные свойство и метод, поддерживаемые узлами Text. Другие доступные свойства вы можете найти в перечне общих свойств в таблице 9.2Свойство узла TextОписание ПримерМетод узла TextОписаниеПример

Length	Количество символов в тексте узла	CharacterCount = Text.length;
substringData (char-offset, num-chars)	Возвращает строку, содержащую заданное число символов из текстового содержимого узла, начиная с указанной параметром смещения позиции	Substring = Text.substringData (2, 3); (Возвращает третий, четвертый и пятый символы из содержимого элемента Text)

Как использовать страницу проверки на валидность

Воспользуйтесь командой Save (Сохранить) вашего текстового редактора, чтобы сохранить модифицированную страницу.Откройте страницу в Internet Explorer 5.

Страница отобразит окно сообщения, содержащее информацию о первой ошибке, обнаруженной XML-процессором Internet Explorer 5. На рисунке 9.9 показано как будет выглядеть окно сообщения, если документ не содержит ошибок.

Рис. 9.9.

А на рисунке 9.10 показано как оно будет выглядеть при наличии ошибки.

Рис. 9.10.

Как работает страница проверки на валидность

Для HTML-страниц, с которыми вы работали в этой лекции, были приняты два допущения:

связанный XML-документ не имеет ошибок. Если это не так, XML-данные не будут доступны;браузер закончил загрузку и обработку XML-документа к тому времени, когда сценарий предпринимает попытку обратиться к данным. Если это предположение не соответствует действительности, часть данных XML будет недоступна.

Если одно из этих предположений окажется ложным, часть или все данные XML не появятся на странице. Страница проверки на валидность, представленная здесь, демонстрирует, как вы можете проверить, содержит ли связанный XML-документ ошибки. Вы можете включить подобную проверку в создаваемые вами страницы и отображать соответствующее сообщение, если в документе будут найдены ошибки. Страница проверки на валидность также показывает, как сценарий может узнать, загружен ли полностью и обработан XML-документ на тот момент, когда сценарий пытается обратиться к его данным. Хотя в целях упрощения в предыдущих примерах эти действия были опущены, вы можете использовать их при создании полноценных HTML-страниц.

В Листинге 9.10 представлена страница проверки на валидность.

Листинг 9.10. Validity Test.htm (html, txt)

HTML-страница содержит сценарий, который выполняется, когда браузер первый раз открывает окно страницы:

<SCRIPT LANGUAGE="JavaScript" FOR="window" EVENT="ONLOAD"> /* код сценария … */ </SCRIPT>

Сначала сценарий получает узел Document:

Document = dsoTest.XMLDocument;

Затем он проверяет свойство readyState узла Document. Если значение свойства readyState равно 4, что указывает на то, что все данные XML загружены и обработаны, сценарий сразу же вызывает функцию DisplayError, которая отображает состояние документа на предмет ошибок. Если же значение свойства readyState не равно 4, сценарий присваивает функцию DisplayError свойству onreadystatechange узла Document, что приводит к вызову браузером функции DisplayError позднее, когда значение readyState изменится:

Оба этих свойства узла Document

if (Document.readyState == 4) DisplayError (); else Document.onreadystatechange = DisplayError;

Оба этих свойства узла Document описаны в таблице 9.3.

Если свойство readyState еще не приняло значение 4, то функция DisplayError немедленно завершает свою работу. (Она будет вызвана снова, когда в дальнейшем значение readyState станет равным 4.) Если функция продолжает работу, она отображает все свойства элементарного объекта parseError узла Document. Эти свойства полностью описывают состояние XML-документа на предмет ошибок:

function DisplayError () { if (Document.readyState != 4) return; message = "parseError.errorCode: " + Document.parseError.errorCode + "\n" + "parseError.filepos: " + Document.parseError.filepos + "\n" + "parseError.line: " + Document.parseError.line + "\n" + "parseError.linepos: " + Document.parseError.linepos + "\n" + "parseError.reason: " + Document.parseError.reason + "\n" + "parseError.srcText: " + Document.parseError.srcText + "\n" + "parseError.url: " + Document.parseError.url; alert (message); }

Если документ не содержит ошибок, значение parseError.errorCode устанавливается в нуль, а другие свойства также имеют нулевые или пустые значения. Если же в документе имеется ошибка, свойство parseError.errorCode содержит числовой код ошибки, а другие свойства описывают эту ошибку.

on_load_lecture()

Перейти к вопросам »

Если Вы заметили ошибку - сообщите нам.

Страницы:

« |

1

|

2

|

3

|

4

|

5

|

6

|

7

|

8

|

9

|

вопросы | »

|

для печати и PDA

Отображение переменного числа XML-элементов

Итак, вы теперь знаете, как отобразить XML-документ, имеющий известное число элементов. Если документ имеет неизвестное число элементов, использование DOM для отображения документа несколько усложняется.

Например, для XML-документа типа Inventory.xml (см. Листинг 8-1) или Inventory Big.xml (см. Листинг 8-3) вы обычно не знаете заранее, сколько элементов BOOK содержит документ. Если же количество элементов BOOK меняется, необходимо воспользоваться сценарием.

В Листинге 9.4 представлена HTML-страница, которая использует DOM для отображения документа Inventory.xml вне зависимости от того, сколько элементов BOOK в нем содержится. На рисунке 9.3 показано как будет выглядеть страница в Internet Explorer 5.

Рис. 9.3.

Листинг 9.4. DomDemo Variable.htm (html, txt)

Сценарий в рассматриваемом примере использует свойство length для определения количества элементов BOOK внутри корневого элемента. (Свойство length является членом группового объекта NodeList, предоставляемого свойством childNodes узла корневого элемента. См. таблицу 9.4.) В сценарии имеется цикл for, который выполняется для каждого элемента BOOK и включает код для отображения каждого из этих элементов:

for (i=0; i < Document.documentElement.childNodes.length; i++) { /* код для отображения элемента BOOK… */ }

Поскольку количество элементов BOOK неизвестно, страница не может использовать фиксированный набор элементов SPAN в разделе BODY для отображения данных (как это делалось в предыдущем примере из Листинга 9.3). Вместо этого для каждого элемента BOOK сценарий динамически генерирует весь блок HTML-разметки, необходимый для отображения элемента:

for (i=0; i < Document.documentElement.childNodes.length; i++) { HTMLCode += "Title: " + Document.documentElement.childNodes(i).childNodes(0).text + " " + "Author: " + Document.documentElement.childNodes(i).childNodes(1).text + " " + "Binding: " + Document.documentElement.childNodes(i).childNodes(2).text + " " + "Number of pages: " + "" + Document.documentElement.childNodes(i).childNodes(3).text + " " + "Price: " + Document.documentElement.childNodes(i).childNodes(4).text + ""; }

Сценарий хранит все эти блоки HTML-разметки в переменной HTMLCode. После цикла for, когда все блоки сгенерированы и загружены в HTMLCode, сценарий присваивает HTML-разметку свойству innerHTML элемента DIV раздела BODY страницы (этот элемент имеет ID DisplayDIV):

DisplayDIV.innerHTML=HTMLCode;

Элемент DIV затем сразу же получает HTML-разметку и отображает результаты, которые представлены на рисунке 9.3.

Чтобы убедиться, что страница работала независимо от количества элементов BOOK, которое содержится в XML-документе, вы можете отредактировать фрагмент данных на этой странице, чтобы он отображал документ Inventory Big.xml, который содержит в два раза больше элементов BOOK, чем документ Inventory.xml:

<XML ID="dsoInventory" SRC="Inventory Big.xml"></XML>

Перемещение внутри XML-документа

В следующем упражнении вы создадите HTML-страницу, которая содержит сценарий для перемещения внутри XML-документа среди узлов в иерархии DOM, начиная с корневого элемента Document. Для каждого узла сценарий отображает имя узла, тип и значение. Сценарий задает отступ для каждого блока информации в узле, чтобы показать его уровень в иерархии. Вы можете использовать эту страницу, чтобы отобразить узлы для любого XML-документа и лучше узнать, как DOM структурирует узлы для различных типов XML-документов и компонентов документа.

Проверка валидности XML-документа

В последнем разделе данной лекции приведена HTML-страница, которая открывает XML-документ и использует свойства DOM для выдачи сообщений относительно обнаруженных в нем ошибок. Если документ не имеет объявления типа документа, страница выдает сообщения только об ошибках корректности формы. Если же документ включает объявление типа документа, страница выдает сообщения, как об ошибках корректности формы, так и об ошибках валидности. Вы можете использовать эту страницу для тестирования любого XML-документа.

Создайте страницу для перемещения между узлами

Листинг 9.9. ShowNodes.htm (html, txt)

В начале сценарий передает узел Document функции DisplayNodes, которая возвращает отображаемую информацию данного узла и всех его дочерних узлов. Сценарий присваивает отображаемую информацию свойству innerText элемента DisplayDIV DIV в разделе BODY страницы, который затем отображает эту информацию:

DisplayDIV.innerText = DisplayNodes(Document, 0);

Второй параметр функции DisplayNodes задает уровень отступа, используемого при отображении информации узла.

Функция DisplayNodes имеет следующую форму записи:

function DisplayNodes (Node, IndentLevel)

Функция выполняет следующие основные действия:

Она сохраняет соответствующее количество символов пробелов в переменной Indent, которая используется для создания отступа в начале каждой строки текста узла. Количество символов пробелов определяется значением параметра IndentLevel, передаваемого функции DisplayNodes:

/* создание отступа для данного уровня: */ Indent = ""; IndentDelta = " "; for (i=0; i < IndentLevel; ++i); Indent += IndentDelta;

Она сохраняет отображаемую информацию для текущего узла – т. е. узла, передаваемого функции DisplayNodes через параметр Node (изначально, узел Document):

/* отображение свойств текущего узла: */ DisplayString += Indent + "nodeName: " + Node.nodeName + "\n" + Indent + "nodeTypeType: " + Node.nodeType + "\n" + Indent + "nodeTypeString: " + Node.nodeTypeString + "\n" + Indent + "nodeValue: " + Node.nodeValue + "\n\n";

Подсказка. Если вы хотите увидеть дополнительные свойства для каждого узла, то можете добавить их в представленный выше фрагмент кода. Вы можете использовать любые общие свойства узла, приведенные в таблице 9.2. Однако не следует использовать специальные свойства, характерные для определенного узла (они приведены в таблице 9.3 для узлов Document), поскольку они применимы не для всех типов узлов.

Структура DOM

В DOM программные объекты, представляющие XML-документ, называются узлами. Когда Internet Explorer 5 обрабатывает связанный XML-документ и сохраняет его в DOM, он создает узел для каждого из основных компонентов XML-документов, таких как элементы, атрибуты и инструкции по обработке.

DOM использует различные типы узлов для представления различных типов компонентов XML. Например, элемент хранится в узле Element, а атрибут – в узле Attribute. В таблице 9.1 представлены наиболее важные типы узлов.

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

Document	Корневой узел иерархии документа (т. е. он представляет весь XML-документ)	#document	null
Element	Элемент	Имя типа элемента (например, BOOK)	null (любые символьные данные, содержащиеся в элементе, находятся в одном или нескольких дочерних узлах Text)
Text	Текст, принадлежащий элементу, атрибуту или примитиву, которые представлены родителем этого узла	#text	Текст родительского XML-компонента
Attribute	Атрибут (а также другие пары имя-значение, такие как имя и значение в инструкции по обработке)	Имя атрибута (например, Binding)	Значение атрибута (например, hardcover)
Processing-Instruction	Инструкция по обработке (объявление XML или пользовательская инструкция по обработке)	Предназначение инструкции по обработке (например, xml)	Полное содержимое инструкции по обработке, за исключением предназначения (например, version="1.0")
Comment	Комментарий	#comment	Весь текст внутри ограничителей комментария
CDATASection	Раздел CDATA	#cdata-section	Содержимое раздела CDATA
DocumentType	Объявление типа документа	Имя корневого элемента, содержащееся в объявлении DOCTYPE (например, INVENTORY)	null
Entity	Объявление примитива в DTD	Имя примитива (например, image)	null (значение примитива содержится в дочернем узле Text)
Notation	Объявление нотации в DTD	Имя нотации (например, BMP)	null (системный литерал нотации содержится в дочернем узле Attribute с именем SYSTEM)

Attributes	Множество NamedNodeMap всех дочерних узлов-атрибутов данного узла	AttributeNode = Element.attributes.getNamedItem ("Binding");
childNodes	Множество NodeList всех дочерних узлов, не являющихся атрибутами, данного узла	FirstNode = Element.childNodes (0);
dataType	Тип данных этого узла (применительно только к определенным типам узлов Attribute)	AttributeType = Attribute.dataType;
firstChild	Первый дочерний узел данного узла, не являющийся атрибутом	FirstChildNode = Element.firstChild;
lastChild	Последний дочерний узел данного узла, не являющийся атрибутом	LastChildNode = Element.lastChild;
nextSibling	Следующий узел на том же уровне данного узла	NextElement = Element.nextSibling;
nodeName	Имя данного узла	ElementName = Element.nodeName;
nodeType	Цифровой код, указывающий на тип данного узла	NodeTupeCode = Node.nodeType;
nodeTypeString	Строка, содержащая тип данного узла, строчными буквами (например, "element" или "attribute")	NodeTypeString = Node.nodeTypeString;
nodeValue	Значение данного узла (или null, если он не содержит значения)	AttributeValue = Attribute.nodeValue;
ownerDocument	Корневой узел Document документа, содержащего данный узел	Document = Node.ownerDocument;
parentNode	Узел, для которого данный узел является дочерним (не действует для узла Attribute)	ParentElement = Element.parentNode;
previousSibling	Предыдущий узел на том же уровне данного узла	PreviousElement = Element.previousSibling;
text	Все текстовое содержимое данного узла и все подчиненные узлы Element	AllCharacterData = Element.text;
xml	Все содержимое XML данного узла и все его подчиненные узлы	XMLContent = Element.xml;

Связывание XML-документа с HTML-страницей

Чтобы получить доступ к XML-документу с использованием DOM, вы должны связать XML-документ с HTML-страницей. Самый простой способ – сделать это через фрагмент данных. Напомним, что фрагмент данных создается через HTML-элемент с именем XML. Например, следующий элемент BODY HTML-страницы содержит фрагмент данных, который связывает XML-документ, хранящийся в файле Book.xml:

Подробнее о фрагментах данных рассказано в разделе "Шаг первый: установка связи XML-документа с HTML-страницей" в лекции 8.

Идентификатор ID, который вы назначаете фрагменту данных, указывает на DSO документа (см. лекцию 8). Вы можете использовать составляющую XMLDocument DSO для доступа к DOM, как показано в следующей строке кода сценария:

Document = dsoBook.XMLDocument;

Член XMLDocument содержит корневой объект DOM, известный как узел Документ (Document node). Вы можете использовать узел Документ для доступа к другим объектам DOM.

Так, создание фрагмента данных на HTML-странице предписывает Internet Explorer 5 создать как DSO (представленный непосредственно через ID фрагмента данных), так и DOM (доступ к которой осуществляется через член XMLDocument DSO).

Подсказка. Если вы хотите иметь доступ к нескольким XML-документам с HTML-страницы, вы можете поместить фрагмент данных для каждого из них. Кроме того, вы можете включить несколько фрагментов данных для одного XML-документа. (Последний прием может оказаться полезным для поддержки нескольких различных версий данных XML, если ваша страница модифицирует содержимое данных DOM, накопленных в памяти. В этой лекции, однако, эти приемы модификации данных DOM не рассматриваются.)

Доступ к атрибутам XML

XSL трактует атрибут, принадлежащий элементу в XML-документе, как дочерний элемент. Однако для ссылки на атрибут в образце XSL вы должны предварить имя атрибута символом @, что указывает на то, что имя относится к атрибуту, а не к элементу.

Например, фильтр в следующем начальном теге выделяет все элементы BOOK с атрибутом InStock, имеющем значение "yes". Другими словами, он выбирает только книги, которые имеются в наличии:

<xsl:for-each select="INVENTORY/BOOK[@InStock='yes']">

Вы можете использовать XSL-элемент value-of для извлечения значений атрибута точно так же, как вы это делаете для извлечения текстового содержимого элемента. Например, следующий элемент value-of получает значение атрибута Born, принадлежащего элементу AUTHOR:

<xsl:value-of select="AUTHOR/@Born"/>

Таблица стилей, представленная в Листинге 10.8, демонстрирует технику доступа к атрибутам, принадлежащим элементам в XML-документе. Эта таблица стилей связана с XML-документом из Листинга 10.9 и отображает все имеющиеся в наличии книги из каталога.

Листинг 10.8. XslDemo06.xsl (html, txt)

Листинг 10.9. XslDemo06.xml (html, txt)

Каждый элемент BOOK в XML-документе содержит атрибут InStock, имеющий значение "yes" или "no", указывающий наличие или отсутствие книги в хранилище. Каждый элемент AUTHOR имеет атрибут Born, содержащий год рождения автора.

Вместо отображения значения атрибута InStock таблица стилей использует атрибут в условии фильтрации с целью избежать отображения элементов BOOK для книг, которых нет в наличии:

<xsl:for-each select="INVENTORY/BOOK[@InStock='yes']">  </xsl:for-each>

Таблица стилей отображает каждый элемент BOOK в виде HTML-таблицы, а не через список элементов SPAN, как в предыдущих примерах. Она отображает значение атрибута Born после значения элемента AUTHOR, используя XSL-элемент value-of. Следующие элементы создают ячейку таблицы для отображения этих значений:

Фильтрация

Значение, которое присваивается атрибутам match или select, представляет собой образец, соответствующий одному или нескольким элементам в XML-документе. (Атрибут match используется для элемента template, а атрибут select – для элементов value-of, for-each и apply-templates.) Образцы, с которыми вы имели дело до сих пор, содержали только оператор пути, который задавал имя элемента и, возможно, одного или нескольких вложенных элементов. Вы можете ограничить количество элементов, отвечающих шаблону, введя фильтр – выражение, заключенное в квадратные скобки ([]) и следующее непосредственно оператором пути. Например, образец, присвоенный следующему атрибуту match, указывает, что соответствующий элемент должен носить имя BOOK, и кроме того (это определяется фильтром), должен иметь дочерний элемент BINDING, который содержит текст "trade paperback":

<xsl:template match="BOOK[BINDING='trade paperback']">

Если в фильтр включено только имя элемента, то соответствующий элемент должен иметь дочерний элемент с указанным именем. Например, следующий образец отвечает любому элементу ITEM, имеющему дочерний элемент с именем CD, независимо от содержимого элемента CD:

match="ITEM[CD]"

Следующий образец отвечает любому элементу SHIRT, имеющему дочерний элемент COLOR, содержащий текст "red":

match="SHIRT[COLOR='red']"

А следующий образец, наоборот, отвечает любому элементу SHIRT, имеющему дочерний элемент COLOR, который не содержит текст "red":

select="SHIRT[COLOR='red']"Примечание. Если элемент имеет более одного дочернего элемента с именем, указанным в условии фильтрации, оператор сравнения применяется только к первому дочернему элементу. Например, если элемент SHIRT имеет два дочерних элемента COLOR, образец "SHIRT[COLOR='red']" будет отвечать элементу, только если первый элемент COLOR содержит слово "red".

Фильтрация и сортировка данных XML

В последующих двух разделах вы познакомитесь с основами применения XSL-таблиц стилей для фильтрации и сортировки данных XML. После этого вам будут представлены примеры таблиц стилей, демонстрирующие методики фильтрации и сортировки.

Использование нескольких шаблонов

Другой способ отображения повторяющихся XML-элементов состоит в создании отдельного шаблона для каждого элемента с последующим вызовом этого шаблона с использованием XSL-элемента apply-templates. Пример использования подобной методики приведен в XSL-таблице стилей, представленной в Листинге 10.5. Эта таблица стилей предназначена для связывания с XML-документом из Листинга 10.4, XslDemo.xml; установить эту связь вы можете путем модификации инструкции xml-stylesheet в документе следующим образом:

<?xml-stylesheet type="text/xsl" href="XslDemo03.xsl"?>

<?xml version="1.0"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl"> <xsl:template match="/"> <H2>Book Inventory</H2> <xsl:apply-templates select="INVENTORY/BOOK" /> </xsl:template>

<xsl:template match="BOOK"> Title: <xsl:value-of select="TITLE"/> Author: <xsl:value-of select="AUTHOR"/> Binding type: <xsl:value-of select="BINDING"/> Number of pages: <xsl:value-of select="PAGES"/> Price: <xsl:value-of select="PRICE"/> </xsl:template> </xsl:stylesheet>

Листинг 10.5. XslDemo03.xsl (html, txt)

Рассматриваемая в примере таблица стилей содержит два шаблона. Один шаблон содержит инструкции для отображения всего документа (путем установки match="/", указывающей на корневую часть документа). Все XSL-таблицы стилей требуют наличия такого шаблона. Другой шаблон содержит инструкции для отображения элемента BOOK (шаблон с установкой match="BOOK"). Сначала браузер обрабатывает шаблон, соответствующий корневой части элемента:

Использование одного шаблона XSL

В отличие от CSS, содержащей правила, XSL-таблица стилей включает один или несколько шаблонов, каждый из которых содержит информацию для отображения в определенной ветви элементов в XML-документе. В этом разделе вы узнаете, как создать простую XSL-таблицу стилей, которая включает только один шаблон. Этот шаблон содержит информацию для отображения всего документа.

В Листинге 10.1 представлен первый пример XSL-таблицы стилей. Эта таблица стилей связана с XML-документом, представленным в Листинге 10.2.

<?xml version="1.0"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl"> <xsl:template match="/"> <H2>Book Description</H2> Author: <xsl:value-of select="BOOK/AUTHOR"/> Title: <xsl:value-of select="BOOK/TITLE"/> Price: <xsl:value-of select="BOOK/PRICE"/> Binding type: <xsl:value-of select="BOOK/BINDING"/> Number of pages: <xsl:value-of select="BOOK/PAGES"/> </xsl:template> </xsl:stylesheet>

Листинг 10.1. XslDemo01.xsl (html, txt)

<?xml version="1.0"?>

<?xml-stylesheet type="text/xsl" href="XslDemo01.xsl"?>

<BOOK> <TITLE>Moby-Dick</TITLE> <AUTHOR> <FIRSTNAME>Herman</FIRSTNAME> <LASTNAME>Melville</LASTNAME> </AUTHOR> <BINDING>hardcover</BINDING> <PAGES>724</PAGES> <PRICE>$9.95</PRICE> </BOOK>

Листинг 10.2. XslDemo01.xml (html, txt)

На рисунке 10.1 показано как Internet Explorer 5 отображает XML-документ в соответствии с инструкциями из таблицы стилей.

Каждая XSL-таблица стилей должна иметь элемент Документ, представленный ниже. (Напомним, что элемент Документ, известный как корневой элемент, является XML-элементом верхнего уровня, который содержит все остальные элементы.)

Основы использования XSL-таблиц стилей

Существуют два основных шага для отображения XML-документа при использовании XSL-таблицы стилей.

Здесь XSLFilePath представляет собой заключенный в кавычки URL, указывающий местонахождение файла таблицы стилей. Вы можете использовать полный URL, например:

<?xml-stylesheet type="text/xsl" href="http:/www.my_domain.com/Inventory.xsl"?>

Чаще используют неполный URL, который задает местонахождение относительно месторасположения XML-документа, содержащего инструкцию по обработке xml-stylesheet, например:

<?xml-stylesheet type="text/xsl" href="Inventory.xsl"?>

(Относительный URL встречается чаще, поскольку вы обычно храните файл таблицы стилей в той же папке, где хранится XML-документ, либо в одной из вложенных в нее папок.)

Подсказка. Хотя вы и можете связать XSL-таблицу стилей с использованием полного URL, таблица стилей при этом должна размещаться на том же домене, что и XML-документ, с которым вы ее связываете. Например, если домен http://mspress.microsoft.com/ содержит XML-документ, то и XSL-таблица стилей должна размещаться на том же домене.

Обычно инструкция по обработке xml-stylesheet добавляется в пролог XML-документа вслед за объявлением XML, как вы увидите в примере XML-документа, рассматриваемого в следующем разделе (см. Листинг 10.2). Более подробная информация об инструкциях по обработке и описании мест в документе, куда они могут быть корректно помещены, содержится в разделе "Использование инструкций по обработке" в лекции 4.

Отображение переменного числа элементов

В примере, рассмотренном в предыдущем разделе (см. Листинг 10.2), XML-документ содержал только один элемент BOOK. В случае, если документ содержит несколько элементов BOOK, методика, с которой вы познакомились в предыдущем разделе, способна отобразить только один из элементов. Возьмем, для примера, XML-документ, содержащий следующий элемент Документ:

<INVENTORY> <BOOK> <TITLE>The Adventures of Huckleberry Finn</TITLE> <AUTHOR> <FIRSTNAME>Mark</FIRSTNAME> <LASTNAME>Twain</LASTNAME> </AUTHOR> <BINDING>mass market paperback</BINDING> <PAGES>298</PAGES> <PRICE>$5.49</PRICE> </BOOK> <BOOK> <TITLE>The Adventures of Tom Sawyer</TITLE> <AUTHOR> <FIRSTNAME>Mark</FIRSTNAME> <LASTNAME>Twain</LASTNAME> </AUTHOR> <BINDING>mass market paperback</BINDING> <PAGES>205</PAGES> <PRICE>$4.75</PRICE> </BOOK> <BOOK> <TITLE>The Ambassadors</TITLE> <AUTHOR> <FIRSTNAME>Henry</FIRSTNAME> <LASTNAME>James</LASTNAME> </AUTHOR> <BINDING>mass market paperback</BINDING> <PAGES>305</PAGES> <PRICE>$5.95</PRICE> </BOOK> </INVENTORY>

Предположим, что таблица стилей, используемая для отображения этого документа, содержит следующий шаблон:

<xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl"> <xsl:template match="/"> <H2>Book Description</H2> Author: <xsl:value-of select="INVENTORY/BOOK/AUTHOR"/> Title: <xsl:value-of select="INVENTORY/BOOK/TITLE"/> Price: <xsl:value-of select="INVENTORY/BOOK/PRICE"/> Binding type: <xsl:value-of select="INVENTORY/BOOK/BINDING"/> Number of pages: <xsl:value-of select="INVENTORY/BOOK/PAGES"/> </xsl:template> </xsl:stylesheet>

Пример таблицы стилей, осуществляющей фильтрацию и сортировку

В этом разделе приведено два примера XSL-таблиц стилей, представленных в Листингах 10.6 и 10.7. Каждый из них осуществляет фильтрацию и сортировку элементов BOOK, подлежащих отображению.

<?xml version="1.0"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl"> <xsl:template match="/"> <H2>Book Inventory</H2> <xsl:for-each select="INVENTORY/BOOK[BINDING='trade paperback']" order-by="+AUTHOR/LASTNAME; +AUTHOR/FIRSTNAME"> Author: <xsl:value-of select="AUTHOR"/> Title: <xsl:value-of select="TITLE"/> Binding type: <xsl:value-of select="BINDING"/> Number of pages: <xsl:value-of select="PAGES"/> Price: <xsl:value-of select="PRICE"/> </xsl:for-each> </xsl:template> </xsl:stylesheet>

Листинг 10.6. Xsldemo04.xsl (html, txt)

<?xml version="1.0"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl"> <xsl:template match="/"> <H2>Book Inventory</H2> <xsl:apply-templates select="INVENTORY/BOOK" order-by="+AUTHOR/LASTNAME; +AUTHOR/FIRSTNAME"/> </xsl:template>

<xsl:template match="BOOK[BINDING='trade paperback']"> Author: <xsl:value-of select="AUTHOR"/> Title: <xsl:value-of select="TITLE"/> Binding type: <xsl:value-of select="BINDING"/> Number of pages: <xsl:value-of select="PAGES"/> Price: <xsl:value-of select="PRICE"/> </xsl:template> </xsl:stylesheet>

Сортировка

В этой лекции вы уже познакомились с двумя элементами, которые вы можете использовать для обработки повторяющихся элементов: for-each и apply-templates. Вы можете использовать атрибут order-by для этих элементов, чтобы управлять порядком, в котором браузер обрабатывает элементы, тем самым осуществляя сортировку данных XML.

Вы можете назначать атрибуту order-by один или несколько образцов, разделяя их точкой с запятой. Браузер будет сортировать элементы с использованием образцов в том порядке, в котором они перечислены. Для указания направления сортировки (по возрастанию или по убыванию) следует предварить образец префиксом + или – .

Например, атрибут order-by, установленный для следующего элемента for-each, предписывает браузеру сортировать элементы BOOK по фамилиям авторов в порядке возрастания, а также осуществлять сортировку для одинаковых фамилий по именам, также по возрастанию:

<xsl:for-each select="INVENTORY/BOOK" order-by="+AUTHOR/LASTNAME; +AUTHOR/FIRSTNAME">

В другом примере следующая установка order-by осуществляет сортировку элементов BOOK по названиям книг по убыванию:

<xsl:apply-templates select="INVENTORY/BOOK" order-by="-TITLE">

Оператор пути, который вы присваиваете атрибуту order-by, действует относительно образца, назначенного атрибуту select. Так, в данном примере установка order-by="-TITLE" указывает на элемент TITLE внутри элемента BOOK, вложенного в элемент INVENTORY.