URI, которые передаются функции document, могут быть как абсолютными, так и относительными, например document('doc.xml') возвратит корень документа doc.xml, находящегося в том же каталоге, что и само преобразование.
Функция document позволяет менять "точку отсчета" относительных URI. Если в качестве второго аргумента функции document передано множество узлов, то относительные идентификаторы ресурсов будут отсчитываться от базового адреса первого (в порядке просмотра документа) узла этого множества.
Базовым URI узла дерева является:
□ если элемент или инструкция по обработке принадлежит внешней сущности, базовым URI соответствующего узла будет URI внешней сущности;
□ иначе базовым URI является URI документа;
□ базовым URI текстового узла, узла атрибута, комментария или пространства имен является базовый URI родительского элемента.
Поясним вышесказанное на примерах.
Конструкция
<xsclass="underline" copy-of select="document('doc.xml')"/>
копирует в выходящий документ doc.xml, находящийся в одном каталоге вместе с преобразованием.
Несмотря на то, что в следующем определении xsclass="underline" for-each меняет контекст, document('doc.xml') все равно возвращает корень документа doc.xml, находящегося в одном с преобразованием каталоге:
<xsclass="underline" for-each select="document('a/data.xml')">
<xsclass="underline" copy-of select="document('doc.xml')"/>
</xsclass="underline" for-each>
В следующей конструкции document('doc.xml', /) копирует документ a/doc.xml, поскольку в качестве базового URI используется URI корня документа a/data.xml:
<xsclass="underline" for-each select="document('a/data.xml')">
<xsclass="underline" copy-of select="document('doc.xml', /)"/>
</xsclass="underline" for-each>
Того же самого эффекта можно достичь следующим образом:
<xsclass="underline" copy-of select="document('doc.xml', document('a/data.xml'))"/>
В следующей конструкции за базовый URI опять принимается URI самого преобразования (вернее, его корневого узла):
<xsclass="underline" copy-of select="document('doc.xml', document(''))"/>
Протестируем теперь все это вместе в одном преобразовании.
<xsclass="underline" stylesheet
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsclass="underline" template match="/">
<xsclass="underline" copy-of select="document('doc.xml')"/>
<xsclass="underline" for-each select="document('a/data.xml')">
<xsclass="underline" copy-of select="document('doc.xml')"/>
</xsclass="underline" for-each>
<xsclass="underline" for-each select="document('a/data.xml')">
<xsclass="underline" copy-of select="document('doc.xml', /)"/>
</xsclass="underline" for-each>
<xsclass="underline" copy-of select="document('doc.xml', document('a/data.xml'))"/>
<xsclass="underline" for-each select="document('a/data.xml')">
<xsclass="underline" copy-of select="document('doc.xml', document(''))"/>
</xsclass="underline" for-each>
</xsclass="underline" template>
</xsclass="underline" stylesheet>
<doc>doc.xml</doc>
<doc>a/doc.xml</doc>
<doc>doc.xml</doc>
<doc>doc.xml</doc>
<doc>a/doc.xml</doc>
<doc>a/doc.xml</doc>
<doc>doc.xml</doc>
Вызов document(node-set, node-set)
Если функции document передаются два множества узлов, то вычисление результата можно описать примерно следующим образом:
□ каждый из узлов первого аргумента преобразуется в строковый вид;
□ для каждого из полученных значений выполняется вызов типа document(string, node-set);
□ результирующие множества объединяются.
Иными словами, document(node-set, node-set) работает через document(string, node-set) точно так же, как document(node-set) работает через document(string). Разница лишь в том, что в первом случае базовый URI будет изменен.
Другие дополнительные функции XSLT
Функция current
Выражение для этой функции имеет вид:
node-set current()
Функция current возвращает множество, состоящее из текущего узла преобразования.
Мы часто использовали термины текущий узел и узел контекста как синонимы: действительно, в большинстве случаев между ними нет никакой разницы, текущий узел преобразования совпадает с узлом контекста вычисления выражений. Однако бывают ситуации, когда они являются двумя различными узлами.
Представим себе, что нам нужно выбрать элементы item со значением атрибута source, равным значению этого атрибута текущего узла. Очевидно, путь выборки будет выглядеть как item[предикат], где предикат определяет условие равенства атрибутов текущего и выбираемого. Но как записать это условие? Предикат будет вычисляться в контексте проверяемого элемента item, значит, все относительные пути выборки типа @source или ./@source или self::item/@source будут отсчитываться именно от проверяемого элемента. В этом случае узел контекста и текущий узел преобразования — не одно и то же.
Для того чтобы обратиться в предикате именно к текущему узлу, следует использовать функцию current:
item[@source=current()/@source]
Это выражение выберет все дочерние элементы item текущего узла, значение атрибута source которых будет таким же, как и у него.
Функция unparsed-entity-uri
Выражение для этой функции следующее:
string unparsed-entity-uri(string)
Функция unparsed-entity-uri возвращает уникальный идентификатор ресурса, который соответствует неразбираемой внешней сущности, имя которой передано как аргумент.
Описывая синтаксис XML, мы приводили пример документа, который использовал неразбираемые внешние сущности.
<!DOCTYPE menu [
<!ELEMENT menu (menuitem*)>
<!ELEMENT menuitem EMPTY>
<!ATTLIST menuitem
image ENTITY #REQUIRED
title CDATA #REQUIRED
href CDATA #REQUIRED>
<!NOTATION gif SYSTEM "gif-viewer.exe">
<!NOTATION jpg SYSTEM "jpg-viewer.exe">