будет доступна при обработке, она будет использована процессором для создания атрибутов элемента
line
. В противном случае, процессор прервет выполнение преобразования и выведет указанное в элементе
xsl:message
сообщение.
Нельзя
не согласиться с тем, что приведенный выше способ не отличается элегантностью. Реализовывать свой вариант для каждого существующего процессора может быть довольно трудоемкой задачей — но такова уж плата за возможности расширений.
Функция расширения nodeset
Одной из самых полезных функций расширения, которая, как правило, уже штатно реализована во многих процессорах (то есть, не требует дополнительного программирования) является функция
nodeset
. Эта функция позволяет в обход прямого запрета спецификации конвертировать результирующий фрагмент дерева во множество узлов.
Предположим, что мы создаем в переменной
rtf
результирующий фрагмент дерева следующего вида:
<xsl:variable name="rtf">
<item>1</item>
<item>2</item>
<item>3</item>
</xsl:variable>
При попытке вычислить выражение вида
$rtf/item[2]
процессор в соответствии со спецификацией должен вывести ошибку, поскольку в этом фильтрующем выражении (см. продукцию
[XP20] FilterExpr
) переменная
rtf
должна содержать множество узлов, а не фрагмент дерева.
Текущая спецификация языка XPath совершенно явно говорит о том, что ни один тип данных не может быть преобразован во множество узлов. Функция
nodeset
действует в обход этого запрещения: она принимает на вход результирующий фрагмент дерева и возвращает множество, состоящее из корневого узла этого фрагмента.
В разных процессорах эта функция имеет различный синтаксис: она может носить имя
nodeset
или
node-set
, или
nodeSet
, однако семантика ее во всех случаях одинакова:
nodeset nodeset(result-tree-fragment)
Функция принимает на вход единственный аргумент, являющийся фрагментом дерева и возвращает множество узлов, состоящее из его корня.
Пример
Предположим, что мы обрабатываем входящий документ, содержащий трехбуквенные коды языков.
Листинг 10.10. Входящий документ
<items>
<item>ENG</item>
<item>FRE</item>
<item>GER</item>
<item>GRE</item>
<item>ITA</item>
<item>NOR</item>
<item>POR</item>
<item>SPA</item>
</items>
Фрагмент
шаблона, обрабатывающий этот список, может выглядеть следующим образом:
<select name="language">
<xsl:for-each select="items/item">
<option>
<xsl:value-of select="."/>
</option>
</xsl:for-each>
</select>
Если в преобразовании нам понадобится доопределить входящий список кодами
RUS
и
UKR
, не исправляя входящий документ, можно поступить следующим образом:
□ создать в переменной фрагмент дерева, содержащий элементы
item
входящего документа плюс элементы
item
, доопределяющие этот список;
□ преобразовать дерево в список узлов;
□ обрабатывать список узлов точно так же, как мы бы обрабатывали сам входящий документ.
Преобразование, реализующее эти три шага, приведено ниже.
Листинг 10.11. Преобразование
<xsl:stylesheet
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xalan="http://xml.apache.org/xalan"
exclude-result-prefixes="xalan">
<xsl:template match="items">
<!--
| Создаем переменную tree, содержащую элементы item
| входящего документа а также два дополнительных элемента
+-->
<xsl:variable name="tree">
<xsl:copy-of select="item"/>
<item>RUS</item>
<item>UKR</item>
</xsl:variable>
<!--
| Конвертируем переменную tree во множество узлов,