version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
Node '
' found
times.
Листинг 11.6. Выходящий документNode 'foo' found 5 times.
Node 'bar' found 7 times.
Именованный шаблон как функция
Сложно переоценить возможности механизмов расширений языка XSLT. Они позволяют сочетать простоту и гибкость обработки XML-документов при помощи элементов XSLT и выражений XPath. Практически любая функция, которая отсутствует в XSLT, может быть написана на подходящем языке программирования и подключена к процессору.
Но как уже отмечалось ранее, функции расширения ограничивают переносимость преобразований. Во-первых, функции расширения одного процессора совсем необязательно будут присутствовать в другом процессоре — скорее наоборот. Во-вторых, не приходится надеяться, что пользовательские модули, написанные на одном языке или с использованием одного интерфейса, смогут использоваться любым процессором. Поэтому часто перед разработчиком стоит проблема решить определенную задачу, используя только стандартные функции и элементы XSLT.
В этом разделе мы рассмотрим возможность использования именованных шаблонов в качестве функций, которые принимают на вход несколько параметров и возвращают некоторое вычисленное значение.
Использование именованных шаблонов как функций обуславливается следующими тезисами.
□ Именованный шаблон можно вызывать вне зависимости от того, какая часть документа обрабатывается в данный момент.
□ Именованному шаблону можно передавать параметры.
□ Результат выполнения именованного шаблона можно присваивать переменной.
Вызов именованного шаблона выполняется элементом
xsl:call-template
, в атрибуте name
которого указывается имя вызываемого шаблона. Такой вызов не зависит от того, какая часть документа обрабатывается в данный момент и может производиться по необходимости.Параметры именованному шаблону передаются точно так же, как и обычному — при помощи элементов
xsl:with-param
, которые могут быть включены в вызывающий элемент xsl:call-template
. Примером вызова именованного шаблона с параметрами может быть конструкция вида
которая вызывает шаблон с именем
foo
и передает ему параметр x
со значением, равным 1
и параметр y
со значением, равным 2
.Вызов именованного шаблона может также производиться при инициализации переменной — внутри элемента xsl:variable. В этом случае с переменной связывается результирующий фрагмент дерева, возвращаемый именованным шаблоном.
ПримерВ качестве примера приведем простой шаблон, который вычисляет квадрат переданного ему параметра
x
:
Для того чтобы присвоить переменной
у
квадрат числа 6
мы можем записать следующее:
Обратим внимание, что значение переменной
y
будет иметь вовсе не численный тип. Несмотря на то, что элемент
выведет строку "
36
", переменная у содержит не число, а дерево, и 36
лишь является результатом конвертации в строку при выполнении xsl:value-of
.Для того чтобы присвоить переменной результат выполнения именованного шаблона в виде булевого значения, строки или числа, следует воспользоваться промежуточной переменной для явного преобразования типов.
ПримерПосле выполнения действий
переменные
sqr-string
и sqr-number
будут содержать строковое и численное значение результата вычисления соответственно.Немного сложнее обстоит дело с булевым типом. При приведении дерева к булевому типу результатом всегда будет "истина", поэтому такое преобразование необходимо выполнить в два шага: сначала преобразовать дерево в число, только затем число в булевый тип.
ПримерВ следующем преобразовании шаблон с именем
less-than
сравнивает значения параметров x
и y
. Переменной less-than
присваивается булевое значение результата сравнения.Листинг 11.7. Вычисление булевого значения функции
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
ПримерПростым примером шаблона-функции может быть шаблон, который форматирует дату в нужном виде, например 7 августа 93 года как "
07-Aug-1993
".В качестве параметров этот шаблон будет принимать численные значения дня, месяца и года. Год, имеющий значение меньшее 25, мы будем считать принадлежащим новому тысячелетию.