Глава 9 Именованные шаблоны, параметры и переменные

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

Если задать шаблону имя, его можно вызывать по этому имени при помощи элемента

. Шаблон применяется при вызове, поэтому вместо того чтобы полагаться на обработку таблицы стилей, принятую в процессоре XSLT по умолчанию, вы можете явно задать, когда и какой шаблон нужно применять. Например, несколько шаблонов могут выбирать один и тот же набор узлов, и вам нужно выбрать из них один или несколько шаблонов, которые будут применены. Именованные шаблоны похожи на режимы, но дают вам больше возможностей управления.

При вызове шаблона можно настроить его работу при помощи параметров. Например, вам может понадобиться, чтобы текст в создаваемых шаблоном текстовых узлах был на определенном языке — таком как английский, немецкий или французский — и вы можете создать новый параметр с именем 

language
(язык). При вызове именованного шаблона, заданного для обработки этого параметра, вы можете установить язык в «
en
», «
de
» или «
fr
» и затем вызвать шаблон при помощи элемента
. В самом именованном шаблоне используемый им параметр 
language
объявляется при помощи элемента
. После объявления параметра к его значению можно свободно обращаться как 
$language
и использовать его в выражениях XPath. В этой главе мы рассмотрим многочисленные примеры работы с параметрами.

Переменные во многом похожи на параметры, с тем лишь отличием, что они по-другому создаются. Параметры, как правило, используются в именованных шаблонах, в то время как переменные применяются более широко, в выражениях XPath любого вида. Как и в языках программирования, в переменных XSLT можно хранить значения и обращаться к ним позже. Но есть одна важная особенность: за исключением особых обстоятельств, вы не можете изменять значение, хранимое в переменной. (В связи с этим некоторые авторы, пишущие об XSLT, считают неправильным называть их переменными.)

Переменные удобны для хранения значений, создание которых занимает длительное время, но в таблице стилей они часто используются. Вместо того, чтобы каждый раз заново создавать эти значения, сохраните их в переменной и ссылайтесь на ее значение. Как и в случае с параметрами, для получения значения переменной добавьте префикс «$». Например, для переменной с именем 

sandwich
получить ее значение можно при помощи 
$sandwich
. Как и в параметрах, в переменных можно хранить данные всех четырех типов данных XPath. Переменные также имеет смысл применять для хранения значений, которые позже в шаблоне будут изменены. Например, «.» обычно ссылается на контекстный узел шаблона, но внутри элемента
«.» ссылается на текущий обрабатываемый в элементе узел, а не на контекстный узел всего шаблона. Для того чтобы обратиться к контекстному узлу, перед входом в цикл
сохраните его в переменной 
contextnode
и затем в теле цикла используйте это значение как 
$contextnode
.

Кроме четырех типов данных XPath мы также будем использовать тип данных, поддерживаемый в XSLT 1.0, но не в XSLT 1.1 — фрагменты результирующего дерева, которые создаются элементами

или
. Фрагменты результирующего дерева могут быть удобны в определенных случаях, как вы увидите далее в этой главе.

Наконец, в этой главе мы также рассмотрим элемент

. Впервые он нам встретился в главе 4, теперь мы изучим его более подробно.

Для введения вполне достаточно; давайте перейдем к работе, и начнем мы с переменных.

Элемент : создание переменных

Для создания переменных в XSLT служит элемент

, обладающий следующими атрибутами:

• 

name
(обязательный). Имя переменной, устанавливается в QName;

• 

select
(необязательный). Выражение XPath, задающее значение переменной. Если опустить этот атрибут, значение переменной будет определяться содержимым
.

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

select
.

Для создания переменной присвойте ее имя атрибуту name элемента

, а значение переменной атрибуту 
select
, как в следующем примере, в котором я создаю переменную 
number_books
и сохраняю в ней значение 255: 

.

.

.

Получить значение переменной можно, добавив к ее имени префикс $:

There are 

 books in my library

Заметьте, что если вы присваиваете переменной литерал — как, например, присваивание значения «turkey» (индейка) переменной 

sandwich
(бутерброд), — литерал необходимо заключить в кавычки, причем они должны отличаться от кавычек, в которые заключены значения атрибутов:

В XSLT 1.0 нет необходимости в атрибуте select — данные можно заключить внутри самого элемента

:

turkey

Формально, однако, при пропуске атрибута 

select
в элементах
или
и задании этим элементам содержимого вы создаете фрагмент результирующего дерева, который больше не допускается в XSLT 1.1.

Стоит отметить, что имя переменной может включать префикс, как, например, 

star:PLANET
, который должен соответствовать активному пространству имен. Сравнения осуществляются не сравнением префиксов, а проверкой фактического URI префикса — поэтому 
star:PLANET
может быть тем же самым, что и 
nebula:PLANET
, если пространства имен 
star
и 
nebula
соответствуют одному и тому же URI.

Область видимости переменной

Элемент

можно использовать как элемент верхнего уровня или внутри тела шаблона для создания переменных. Переменные, созданные в элементах
высокого уровня, обладают глобальной областью видимости, созданные в телах шаблона — локальной. Область видимости переменной определяет, в какой части таблицы стилей вы можете ее использовать.

Областью видимости глобальной переменной является вся таблица стилей, подразумевая и импортированные или включенные таблицы стилей. Это означает, что переменная доступна в любом месте таблицы стилей, если только она не будет перекрыта локальной переменной с тем же именем. Можно даже обращаться к глобальной переменной до ее объявления. Однако нельзя создавать циклические ссылки (то есть если вы объявили 

a
через 
b
, нельзя объявлять 
b
через 
а
).

Область видимости локальной переменной ограничена следующими за ней братьями или потомками последующих братьев. В частности это значит, что если вы объявили переменную внутри таких элементов, как

,
или
, она не будет доступна вне этих элементов.

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

movie
(кинокартина):

.

.

.

Это элемент верхнего уровня, поэтому 

movie
— глобальная переменная. Даже внутри шаблонов movie будет сохранять свое начальное значение, если не будет локальной переменной с таким же именем:

 

 .

 .

 .

Однако если вы объявите локальную переменную movie, в шаблоне эта версия перекроет глобальную переменную:

 

 

 

 .

 .

 .

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

 

 

 

 

 .

 .

 .

За пределами шаблона локальная переменная невидима, и 

movie
содержит глобальное значение:

 

 

 

 

.

.

.

Глобальные переменные тоже нельзя объявлять повторно:

Несмотря на все эти ограничения, вы можете менять значение переменной на каждом шаге цикла

, как мы увидим в следующем разделе.

Работа с переменными

Давайте рассмотрим примеры применения переменных. В следующем примере (листинг 9.1) я присваиваю переменной 

copyright
сообщение об авторских правах и затем с ее помощью добавляю атрибут 
copyright
во все элементы 
planets.xml
.

Листинг 9.1. Применение переменной

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

Вот результирующий документ, дополненный атрибутами copyright

 

  Mercury

 .0553

 58.65

 1516

 .983

 43.4

 

 

  Venus

 .815

 116.75

 3716

 .943

 66.8

 

 .

 .

 .

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

planets.xml
в новый документ, в котором для каждой планеты будет один элемент. Каждый из этих новых элементов будет содержать два элемента
, содержащих планеты-братья текущей планеты — например, братьями Земли будут Венера и Меркурий:

 

  Venus

 

 

  Earth

 

 

  Mercury

 

 

  Earth

 

 

  Mercury

 

 

  Venus

Для примера я поочередно выбираю каждый элемент

и прохожу в цикле
по всем планетам, создавая элементы
для всех планет, не являющихся контекстным узлом. Однако откуда мне известно внутри элемента
, какая из планет является контекстным узлом, выбранным шаблоном? Внутри элемента
«.» ссылается на текущий узел, с которым работает
, но не на контекстный узел шаблона. Проблему можно решить, если сохранить контекстный узел в переменной, которую я назвал 
contextnode
:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

  

   

   

   .

   .

   .

Теперь для проверки в цикле

того, что текущий элемент не является контекстным узлом, я могу обратиться к контекстному узлу шаблона как 
$contextnode
(листинг 9.2).

Листинг 9.2. Хранение в переменной информации, зависимой от контекста

xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

Теперь наша проблема решена.

Если у элемента

есть тело, он создает переменную, чье значение является фрагментом результирующего дерева. В следующем примере при помощи фрагмента результирующего дерева я задаю значение по умолчанию для атрибута 
COLOR
(цвет), если значение для него уже не задано. Значение по умолчанию я устанавливаю в «
blue
» (голубой):

 

  

  

 

  blue

Строковое значение фрагмента результирующего дерева (то есть либо значение атрибута 

COLOR
, либо значение по умолчанию, «
blue
») присваивается переменной 
COLOR
. Теперь в выражениях XPath можно обращаться к значению этой переменной, 
$COLOR
, а не к значению атрибута (
@COLOR
, гарантированно получая при этом значение цвета, даже если у соответствующего элемента отсутствует атрибут 
COLOR
.

Вот еще один пример фрагмента результирующего дерева. В этом случае я сохраняю элемент буквального результата в переменной 

START_HTML
:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

 

   </b></code></pre></p>
     <p><pre><code><b>   My page</b></code></pre></p>
     <p><pre><code><b>   

 

 

 .

 .

 .

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

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

 

   </code></pre></p>
     <p><pre><code>   My page</code></pre></p>
     <p><pre><code>   

 

 


 

  

  

  

   
Welcome to my page

И вот результат:

 

 </code></pre></p>
     <p><pre><code>  My page</code></pre></p>
     <p><pre><code> 

 

 

  
Welcome to my page

Однако поскольку теперь фрагменты результирующего дерева не допускаются в XSLT 1.1, этот пример работать не будет. Как же тогда сохранить весь элемент буквального результата одновременно с возможностью простого вызова? Вы можете создать именованный шаблон.

Элемент : применение именованных шаблонов

У элемента

есть атрибут 
name
, задающий имя шаблона. Предположим, у меня есть элемент буквального результата, состоящий из двух элементов

и двух элементов
HTML, при помощи которого я создаю в документах HTML вертикальный разделитель:



Тогда я могу создать шаблон с именем «separator» (разделитель), использующий этот элемент буквального результата:

Это именованный шаблон — для его создания нужно только присвоить имя атрибуту name элемента

.

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

, обладающий только одним атрибутом:

• 

name
(обязательный). Имя вызываемого шаблона, устанавливается в 
QName
.

Следующий пример демонстрирует применение нашего шаблона «separator», для чего мне нужно было только вызвать его в соответствующих местах:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

   

   </code></pre></p>
    <p><pre><code>   The Planets Table 

   

   

    

    The Planets Table

   

   

    
    
    
     
     
     
    
    
    

    

    Name
    Mass
    Radius
    Day

Вот результат. Обратите внимание: элементы


и
были вставлены так, как требовалось:

 

 </code></pre></p>
    <p><pre><code>  The Planets Table</code></pre></p>
    <p><pre><code> 

 

 

 

  The Planets Table

 

  

 

 

 

  
   
   
   
   
   
   
  
   
   
   
   
   
  
   
   
   
   
   
  
   
   
   
   
   
  

    

    Name
    Mass
    Radius
    Day
    

    

    Mercury
    .0553 (Earth = 1)
    1516 miles
    58.65 days
    

    

    Venus
    .815 (Earth = 1)
    3716 miles
    116.75 days
    

    

    Earth
    1 (Earth = 1)
    2107 miles
    1 days

Результирующий документ показан на рис. 9.1.

Рис. 9.1. Вызов именованного шаблона


Таким образом, вы можете обращаться к элементу буквального результата по имени, легко помещая его в результирующий документ. Но это слишком статично — элемент буквального результата всегда один и тот же. Впрочем, как можно заметить, вызов именованного шаблона во многом похож на вызов подпрограммы в языке программирования. Так же, как вы передаете данные в подпрограмму, вы можете передать данные в именованные шаблоны при помощи параметров.

Элементы и : создание параметров

Параметры во многом похожи на переменные — за тем исключением, что они обычно используются вместе с именованными шаблонами. Параметры позволяют вам передать в шаблон какие-то значения. Параметры создаются элементом

, обладающим двумя атрибутами:

• 

name
(обязательный). Имя переменной, устанавливается в QName;

• 

select
(необязательный). Значение параметра по умолчанию. Устанавливается в выражение XPath.

Аналогично

, этот элемент может либо быть элементом высокого уровня, либо применяться внутри тела шаблона. Параметры, созданные элементами
, являются глобальными, а созданные внутри шаблонов — локальными. При создании параметра внутри тела шаблона, элемент
должен быть расположен перед какими-либо другими дочерними элементами. Элемент может также содержать необязательное тело шаблона, создающее фрагмент результирующего дерева — в XSLT 1.1 это уже не разрешено. Если элемент содержит тело, атрибут 
select
использовать нельзя.

После объявления параметра при помощи

к его значению можно обращаться в шаблоне таким же способом, как и к значению переменной, — добавляя к имени префикс «$».

Когда вы вызываете именованный шаблон при помощи

или применяете шаблоны с использованием
, вы можете задать значение используемых в шаблоне параметров с помощью элемента
. Если самому параметру при объявлении было присвоено значение атрибутом 
select
элемента
, это значение выступает в качестве значения параметра по умолчанию. Значение по умолчанию будет перекрыто, если вы зададите новое значение параметра при помощи элемента
. У элемента
два атрибута:

• 

name
(обязательный). Имя переменной; устанавливается в QName;

• 

select
(необязательный). Выражение XPath, задающее значение параметра. Если опустить этот атрибут, значение переменной будет определяться содержимым
.

Элемент может также содержать необязательное тело шаблона, создающее фрагмент результирующего дерева, но в XSLT 1.1 это уже не разрешено.

В следующем примере (листинг 9.3) я создаю именованный шаблон с именем «COLORS» (цвета), добавляющий цвет в данные планет в результирующем HTML-документе. Этот именованный шаблон использует единственный параметр, 

COLOR
, который устанавливается в требуемый цвет. В примере я устанавливаю параметр 
COLOR
в разные цвета для разных планет, используя
и вызывая шаблон «COLORS». Вот как это реализуется на практике.

Листинг 9.3. Применение параметров таблиц стилей

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

  .

  .

  .

  

 


 

  

  

   

   

  

 

   

   

  

 

  

  

   

  

  

 

 .

 .

 .

Данная таблица вызывает шаблон «COLORS» с разными значениями параметра COLOR. Я могу воспользоваться этими цветами при форматировании данных планет. Заметьте, что я объявил параметр COLOR при помощи

в самом начале шаблона «COLORS»:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

  .

  .

  .

  

 


 

 

  

   

  

 

  

  

   

  

 

  

  

   

   

 

 


  

 

  

   

  

   

   

  

   

   

  

   

   

  

 

 


 

 

  

 

 

 .

 .

 .

И вот результат:

 

  </code></pre></p>
     <p><pre><code>  The Colorful Planets Table</code></pre></p>
     <p><pre><code>  

 

 

 

  The Colorful Planets Table

 

  
   
   
  
  
  
  
  
   
  
   
   
  
  
   
   
  
  
  
  
   
  
   
  
  
 

     

     Name
     Mass
     Radius
     Day
     

     

     Mercury
     .0553 (Earth = 1)
     1516 miles
     58.65 days
     

     

     Venus
     .815 (Earth = 1)
     3716 miles
     116.75 days
     

     

     Earth
     1 (Earth = 1)
     2107 miles
     1 days

Этот результирующий документ показан на рис. 9.2 (пусть даже в черно-белом исполнении).

Рис. 9.2. Вызов именованного шаблона с параметрами


В следующем примере я использую параметры для локализации используемого в шаблоне языка. Я создаю новый шаблон 

localize
с параметром 
language
. Если language установлен в «
en
», означая английский, результирующий документ будет озаглавлен «Planets»; если 
language
установлен в «
de
», немецкий, результирующий документ будет озаглавлен «Planeten», а если в «
fr
», французский, результирующий документ будет озаглавлен «Planetes».

Здесь я вызываю шаблон 

localize
, установив 
language
в «fr»:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

   

   </code></pre></p>
     <p><pre><code><b>   <xsl:call-template name="localize"></b></code></pre></p>
     <p><pre><code><b>    <xsl:with-param name="language" select="'fr'"/></b></code></pre></p>
     <p><pre><code><b>    </xsl:call-template></b></code></pre></p>
     <p><pre><code>   

   

   

    

   

     

    

   .

   .

   .

А вот как выглядит параметризованный шаблон «COLORS». Заметьте, что я объявляю параметр 

COLOR
в шаблоне при помощи элемента
(и заметьте, что в HTML 4.01 символьный элемент для «е» в «Planetes», который я и использую — это 
è
):

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

  

   </code></pre></p>
     <p><pre><code>   <xsl:call-template name="localize"></code></pre></p>
     <p><pre><code>    <xsl:with-param name="language" select="'fr'"/></code></pre></p>
     <p><pre><code>    </xsl:call-template></code></pre></p>
     <p><pre><code>   

   

   

   

   

    

    

   

   
    
    
    
    
    
    
   
   

     

     Name
     Mass
     Radius
     Day
     

     
     

   

 

 


 

 

 

  Planets

 

  

  Planeten

  

  

  Planètes

 

 

 .

 .

 .

Вот результирующий локализованный документ:

 

  Planètes

 

 

  
Planètes

  
  
   
   
   
   
   
  .
  .
  .
Этот документ показан на рис. 9.3.
Рис. 9.3. Вызов именованного шаблона с параметрами для установки языков

Вызов шаблона во многом похож на вызов функции, что обсуждалось в главе 8, и способность передавать данные через параметры усиливает сходство. Но в отсутствие оператора присваивания, как в языках программирования, кажется, что нельзя присвоить переменной значение, возвращаемое именованным шаблоном, впрочем, поразмыслив, это можно сделать. С шаблонами можно и еще в одном случае поступить так же, как с функциями, — осуществить рекурсивный вызов.

     

      Рекурсивный вызов шаблонов
     

     
Эта тема предназначена, главным образом, для программистов, поскольку здесь я буду пользоваться XSLT как языком программирования. В частности, я реализую вызов именованным шаблоном самого себя, то есть рекурсивный вызов. Классический пример рекурсии — вычисление факториала: например, факториал 6, что записывается как 
6!
, равен 
6*5*4*3*2*1
, или 
720
.

     
При реализации рекурсии в настоящем языке программирования создается функция — например, 
factorial
, которая вызывается со значением 6: 
factorial(6)
. Факториал 6 вычисляется как 
6 * factorial(5)
, поэтому функции нужно лишь умножить на 6 результат вызова самой себя со значением 5, то есть 
factorial(5)
. 

     
Далее, 
factorial(5)
 — это 
5*factorial(4)
, поэтому функция снова вызывает сама себя, чтобы вычислить значение 
factorial(4)
. Этот процесс продолжается до вычисления 
factorial(1)
, а мы знаем, что 1! — это просто 1, поэтому 
factorial(1)
 возвращает 1. С этого момента управление последовательно возвращается на все предыдущие этапы, в результате чего будет вычислено выражение 
1*2*3*4*5*6
, или 
720
, что составляет 
6!
.

     
Кажется, что в таком языке стилей, как XSLT, реализовать подобное невозможно. Тем не менее, это можно сделать, по крайней мере, в XSLT 1.0. Основная идея состоит в том, что значение, возвращаемое шаблоном, можно сохранять в переменной, если шаблон вызывается внутри элемента 
, в котором объявляется эта переменная. Пусть, например, у нас есть именованный шаблон 
factorial
, и мы хотим вычислить 
6!
. Тогда шаблону можно передать значение 6 при помощи элемента 
 и присвоить строковое значение результата переменной 
result
, которое я затем показываю:

     

     

     
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

     
 

     
 

     
  

     
   

     
  

     
  

     
  6! = 

     
 

     
 .

     
 .

     
 .

     
Следующий пример демонстрирует, как можно реализовать шаблон 
factorial
, чтобы для вычисления факториала он вызывал сам себя. На языке программирования я мог бы написать рекурсивный вызов как 
n!=n*factorial(n-1)
, но у нас нет оператора присваивания; поэтому, когда я вычисляю 
factorial(n-1)
, я сохраняю это значение в новой переменной 
temp
 и на каждом шаге возвращаю значение 
n*$temp
:

     

     

     
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

     
 

     
  

     
  

     
    

     
   

     
 

     
  6! = 

     
 

     

     
 

     
 

     
 

     
  

     
   

     
  

     
  

     
   

     
   

     
    

     
   

     
  

     
  

     
  

     
  

     
 

     

     
Вот результирующий документ:

     

     
6! = 720

     
Как видите, это можно сделать, по крайней мере, в XSLT 1.0, в котором разрешены использованные здесь фрагменты результирующего дерева.

    

     

      Шаблон: значение по умолчанию
     

     
Как я говорил ранее, в случае задания параметру значения при объявлении, оно может быть перекрыто, если вы зададите другое значение в элементе 
. Но если другого значения не указывать, исходное значение выступит в роли значения по умолчанию.

     
Следующий пример видоизменяет рассмотренный ранее пример «COLORS». Шаблон имеет параметр 
COLOR
, но я могу вызвать шаблон, не устанавливая 
COLOR
 в какое-либо определенное значение:

     

     
 

     
  

     
  

     
 

     
 

     
 

     
  

     
  

     
 

     
 

     
 

     
  

     
  

     
 

     

     
В этом случае параметр 
COLOR
 принимает значение по умолчанию«
blue
» (голубой), заданное в элементе 
 в шаблоне «COLORS»:

     

     
 

     
  

     
  

     
 

     
 

     
 

     
  

     
  

     
  

     
 

     
 

     
  

     
 

     
 

     

     

     

     
 

     
 
  
  
  
  
 

     

      Как задавать значения шаблона в командной строке
     

     
Кроме возможностей, предоставляемых элементами 
 и 
, значение параметров таблицы стилей во многих процессорах XSLT можно также задавать в командной строке. Способ зависит от конкретного процессора.

     
Следующий пример показывает, как можно присвоить параметру 
param1
 значение 
value1
 в командной строке, используя процессор XSLT от Oracle в Windows. Заметьте, что при установке значений параметра в командной строке его все равно нужно объявлять в таблице стилей при помощи 
:

     
C:\>java oraclе.xml.parser.v2.oraxsl -p param1='value1' planets.xml planets.xsl output.xml

     
Вот как то же самое можно сделать при помощи Saxon:

     
C:\>saxon source.xml stylesheet.xsl param1=value1 > output.xml

     
при помощи Xalan:

     
C:\>java org.apache.xalan.xslt.Process -IN planets.xml -XSL planets.xsl -OUT output.xml -PARAM parma1 value1

     
и XT:

     
C:\XSL>java -Dcom jclark.xsl.sax parser=org.apache.xerces.parsers.SAXParser.com.jclark.xsl.sax.Driver planets.xml planets.xsl output.xml param1=value1

    

    

     Элемент : выбор по ключу 
    

    
Элемент 
 позволяет создать ключ и выбрать узлы по этому ключу. Он обладает следующими атрибутами:

    
• 
name
 (обязательный). Имя ключа, устанавливается в 
QName
;

    
• 
match
 (обязательный). Устанавливается в образец выбора для выбора узлов, к которым применяется ключ;

    
• 
use
 (обязательный). Устанавливается в выражение, определяющее значение ключа.

    
При помощи ключей можно легко распознавать элементы; конкретные ключи можно выбрать при помощи образца «key()». В главе 4 мы познакомились с ключами, имеющими одно значение. В следующем примере я использую ключи для выбора планет, у которых атрибут 
COLOR
 был установлен в «BLUE» — в данном случае это Земля:

    

    

    

    
 .

    
 .

    
 .

    
 

    
 Earth

    
 1

    
 1

    
 2107

    
 1

    
  128.4

    
 

    

    
Я создал ключ 
COLOR
, выбирающий элементы 
 путем проверки их атрибута 
COLOR
. Ключ выглядит следующим образом:

    

    

    
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

    
 

    
 .

    
 .

    
 .

    
После этого я применил образец «key()» для того, чтобы выбрать элементы 
, у которых атрибут 
COLOR
 установлен в «BLUE»:

    

    

    
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

    
 

    
 

    
 

    
   

    
   </code></pre></p>
    <p><pre><code>   The Planets Table</code></pre></p>
    <p><pre><code>   

    
   

    
   

    
   

    
   The Planets Table

    
   

    
   

     

     Name
     Mass
     Radius
     Day
     

     
     
     
     
     
     
     
     
    
    
    

     

     
  

     
  

     

     
  

     
  

     

     
  

     
  

     

     
  

     
  

     

     
    
    
   
   
    
    
    
    
    
    
   
   

    

    Name
    Mass
    Radius
    Day
    

    
    

   

 

 

 .

 .

 .

И вот результат — как видите, образцу удовлетворяет только Земля:

 

 </code></pre></p>
    <p><pre><code>  The Planets Table</code></pre></p>
    <p><pre><code> 

 

 

 

  The Planets Table

 

  
   
   
   
   
   
  
   
   
   
   
 

    

    Name
    Mass
    Radius
    Day
    

    

    Earth
    1 (Earth = 1)
    2107 miles
    1 days

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

COLOR
, «
UNKNOWN
» (неизвестен):

 

  Mercury

 .0553

 58.65

 1516

 .983

 43.4

 

 

 Venus

  .815

 116.75

 3716

 .943

 66.8

 

 

 Earth

 1

 1

 2107

 1

  128.4

Если создать теперь ключ 

COLOR
следующим образом:
и осуществить поиск по этому ключу по образцу «
key('COLOR', 'BLUE')
», то будут выбраны все три планеты:

 

 </code></pre></p>
    <p><pre><code>  The Planets Table</code></pre></p>
    <p><pre><code> 

 

 

 

  The Planets Table

 

  
   
   
   
   
   
   
  
   
   
   
   
   
  
   
   
   
   
   
  
   
   
   
   
   
 

    

    Name
    Mass
    Radius
    Day
    

    

    Mercury
    .0553 (Earth = 1)
    1516 miles
    58.65 days
    

    

    Venus
    .815 (Earth = 1)
    3716 miles
    116.75 days
    

    

    Earth
    1 (Earth = 1)
    2107 miles
    1 days

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

внутри элемента
. Но что, если каждый элемент
содержит более одного элемента
, как в этом примере:

 

  Mercury

  Sister Planet

  .0553

  58.65

  1516

  .983

 43.4

 

 

  Venus

 Sister Planet

  .815

  116.75

  3716

  .943

  66.8

 

 

  Earth

 1

  1

  2107

 1

  128.4

В этом случае каждый элемент

проверяется на совпадение с ключом. Предположим, например, что я хочу выбрать элементы
с текстом «Sister Planet». Вот таблица стилей:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 

 

 

   

   </code></pre></p>
    <p><pre><code>   The Planets Table</code></pre></p>
    <p><pre><code>   

   

   

   

   The Planets Table

   

   
    
    
    
    
    
    
   
   

    

    Name
    Mass
    Radius
    Day
    

    
    

   

 

 


 

 

  

   

   

   

 

 


 

  

  

 

 

 .

 .

 .

И вот результирующий документ:

 

 </code></pre></p>
    <p><pre><code>  The Planets Table</code></pre></p>
    <p><pre><code> 

 

 

 

  The Planets Table

 

  
   
   
   
   
   
  
  
   
   
   
   
   
  
   
   
   
   
  
  

    

    Name
    Mass
    Radius
    Day
    

    

    Mercury
    .0553 (Earth = 1)
    1516 miles
    58.65 days
    

    

    Venus
    .815 (Earth = 1)
    3716 miles
    116.75 days

Элемент : создание нескольких результирующих документов

Весьма часто во время преобразования требуется создать несколько результирующих документов. Например, вам может понадобиться создать отчет о прохождении преобразования или разделить входной документ на несколько результирующих документов (например, разбить рассказ на главы). Или же вам может быть нужно создать набор результирующих документов, которые будут использоваться (как при создании кадрового (frameset) документа HTML) совместно с двумя документами, отображаемыми во фреймах.

Создание нескольких результирующих документов настолько распространенная задача, что практически все процессоры XSLT позволяют вам это сделать, даже в XSLT 1.0, где отсутствуют необходимые для этого средства. Процессоры XSLT добавляют для этого новые элементы расширения. Например, Xalan предоставляет элемент

, позволяющий написать новый результирующий документ. Для работы с этим элементом нужно создать новый префикс пространства имен — здесь я использую «xalan» — которое Xalan использует для элемента, «com.lotus.xsl.extensions.Redirect», и указать, что этот новый префикс является префиксом элемента расширения:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

 xmlns:xalan="com.lotus.xsl.extensions.Redirect"

 extension-element-prefixes="xalan">

 .

 .

 .

Теперь при помощи атрибута 

file
элемента
можно записать новый файл:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

 xmlns:xalan="com.lotus.xsl.extensions.Redirect"

 extension-element-prefixes="xalan">

 .

 .

 .

 

  Here's some text.

В процессоре Saxon применяйте элемент

. Для этого элемента я использую префикс «saxon», который соответствует URI «http://icl.com/saxon»:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

 xmlns:saxon="http://icl.com/saxon"

 extension-element-prefixes="saxon">

 .

 .

 .

 

  Here's some text.

To же можно сделать и в XT; в этом случае используйте пространство имен и атрибут 

href
для задания имени нового файла:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

 xmlns:xt="http://www.jclark.com/xt"

 extension-element-prefixes="xt">

 .

 .

 .

 

  Here's some text.

Все это создало весьма запутанную ситуацию, поскольку каждый разрабатывал свои собственные решения. По этой причине в XSLT 1.1 для поддержки нескольких результирующих документов был представлен новый элемент,

, со следующими атрибутами:

• 

href
(обязательный). Показывает, где будет помещен новый документ. Устанавливается в абсолютный или относительный URI, без идентификатора фрагмента;

• 

method
(необязательный). Определяет метод вывода, используемый для создания результирующего документа. Устанавливается в «xml», «html», «text» или QName, не являющееся NCName;

• 

version
(необязательный). Определяет версию выходного документа. Устанавливается в NMTOKEN;

• 

encoding
(необязательный). Устанавливает кодировку выходного документа. Устанавливается в строку;

• 

omit-xml-declaration
(необязательный). Устанавливается в «yes» или «no», чтобы опустить объявление XML или не отпускать;

• 

cdata-section-elements
(необязательный). Задает имена тех элементов, чье содержимое нужно вывести как разделы CDATA. Устанавливается в список QName, разделенных символами-разделителями;

• 

doctype-public
(необязательный). Задает открытый идентификатор, который будет использован в объявлении
вывода. Устанавливается в строковое значение;

• 

doctype-system
(необязательный). Задает системный идентификатор, который будет использован в объявлении
вывода. Устанавливается в строковое значение;

• 

indent
(необязательный). Определяет, будет ли выходной документ выровнен для отображения структуры вложенности. Устанавливается в «yes» или «no»;

• 

media-type
(необязательный). Устанавливает тип MIME вывода. Устанавливается в строковое значение;

• 

standalone
(необязательный). Определяет, будет ли отдельное объявление включено в выходные данные, и если да, устанавливает его значение. Устанавливается в «yes» или «no».

Этот элемент содержит тело шаблона.

Следующий пример основан на упрощенной таблице стилей. В этом случае я создал в HTML-документе две рамки (frame), а также два HTML-документа для отображения в этих рамках (

frame1.html
и 
frame2.html
). Первую рамку и ее документ я создал следующим образом:

 

 </code></pre></p>
    <p><pre><code>  Two Frames</code></pre></p>
    <p><pre><code> 

 

 

 

  

  

  

   </b></code></pre></p>
    <p><pre><code><b>    Frame 1</b></code></pre></p>
    <p><pre><code><b>   

  

   

   
This is frame 1.

  

  

 

  .

  .

  .

Затем я могу создать вторую рамку и ее документ:

 

 </code></pre></p>
    <p><pre><code>  Two Frames</code></pre></p>
    <p><pre><code> 

 

 

  

  

   

   

    </code></pre></p>
    <p><pre><code>    Frame 1</code></pre></p>
    <p><pre><code>    

   

   

   
This is frame 1.

   

   

  

 

  

  

   

    </b></code></pre></p>
    <p><pre><code><b>    Frame 2</b></code></pre></p>
    <p><pre><code><b>    

   

   

    
This is frame 2.

Заметьте, однако, что этот пример работоспособен только в XSLT 1.1.

На момент написания книги в одном процессоре XSLT элемент

был реализован: это Saxon версии 6.2.1 и старше, в котором свой элемент
был изменен на
. Но пока это единственный известный мне процессор XSLT, поддерживающий этот элемент.

Элемент : генерация таблиц стилей

Одна из основных задач XSLT состоит в преобразовании одних таблиц стилей в другие, хотя на первый взгляд это может быть неочевидно. Например, вам может потребоваться обработать длинные правила, которые нужно настроить непосредственно перед обработкой документов. И, как вы знаете, первоначально XSLT был представлен прежде всего для облегчения создания таблиц стилей объектов форматирования.

Но это порождает проблему: если вы обрабатываете таблицу стилей, полную таких элементов, как

и
, которые вы хотите видеть в результирующем документе — поскольку результирующий документ сам является таблицей стилей — как XSLT сможет отличить эти элементы буквального результата от элементов XSLT, которые он должен обработать?

Тут на помощь приходит элемент

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

• 

stylesheet-prefix
(обязательный). Префикс пространства имен, используемый в таблице стилей. Устанавливается в NCName или «#default»;

• 

result-prefix
(обязательный). Префикс, URI которого вы хотите присвоить пространству имен в результирующем документе. Устанавливается в NCName или «#default».

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

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.1">

Заметьте, что здесь много элементов XSLT с префиксом «xsl», — значит, если вы попытаетесь создать их при помощи XSLT-преобразования, процессор XSLT попытается выполнить эти элементы. Чтобы избежать такой ситуации, я задал им новый префикс пространства имен, «xslt». Ниже показано, как это выглядит в таблице стилей, производящей предыдущую таблицу стилей (листинг 9.4). Заметьте, что нижеследующая таблица стилей просто выбирает корневой элемент исходного документа, чтобы она могла начать работать; она не использует исходный документ ни для каких других целей.

Листинг 9.4. Применение 

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

 xmlns:xslt="http://xslt">

 

  

   

   

    

   

     

    

   

  

 

 

 .

 .

 .

Здесь я использую пространство имен "http://xslt" для префикса "xslt", но я смогу изменить его в выходном документе на правильное пространство имен XSLT, "http://www.w3.org/1999/XSL/Transform", воспользовавшись элементом

:

 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

 xmlns:xslt="http://xslt">

Вот результат. Заметьте, что здесь все еще используется префикс пространства имен «

xslt
», но это пространство имен теперь соответствует правильному пространству имен XSLT:

 xmlns:xslt="http://www.w3.org/1999/XSL/Transform" version="1.1">

На этом глава завершается. В следующей главе мы рассмотрим, как работать с XSLT в коде.

ТЕЛЕГРАМ

Канал с обзорами, анонсами новинок и книжными подборками

Книжный Вестник

Бот для удобного поиска книг (если не нашлось на сайте)

Поиск книг

Свежие любовные романы в удобных форматах

Любовные романы

О психологии, саморазвитии и личностном росте

Саморазвитие

Детективы и триллеры, все новинки

Детективы

Фантастика и фэнтези, все новинки

Фантастика

Отборные классические книги

Классика
ВКОНТАКТЕ

Цитаты, афоризмы, стихи, книжные подборки, обсуждения и многое другое

Книжный Вестник
БИБЛИОТЕКИ

Библиотека с любовными романами, которая наверняка придётся по вкусу женской части аудитории

Любовные романы

Библиотека с фантастикой и фэнтези, а также смежных жанров

Фантастика

Самые популярные книги в формате фб2

Топ фб2 книги