Глава 8 Работа с функциями XSLT и XPath

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

id
, 
generate-id
, 
position
, 
count
и т.д). В этой главе мы рассмотрим их все.

Некоторые функции входят в XSLT, некоторые пришли из XPath. И XSLT, и XPath обновляются до версии 2.0, и в конце главы я приведу список новых, готовящихся к выпуску функций. (Пока что никаких новых функций версии 2.0 еще не опубликовано.)

В XSLT встроены следующие функции:

• 

element-available()
;

• 

function-available()
;

• 

current()
;

• 

document()
;

• 

key()
;

• 

format-number()
;

• 

generate-id()
;

• 

system-property()
;

• 

unparsed-entity-uri()
.

Вы также можете пользоваться многими функциями XPath. Я сгруппирую их по типам данных XPath, с которыми они работают. Существует четыре типа данных: наборы узлов, строки, числа и логические значения. С наборами узлов работают следующие функции XPath:

• 

count()
;

• 

id()
;

• 

last()
;

• 

local-name()
;

• 

name()
;

• 

namespace-uri()
;

• 

position()
.

Следующие функции XPath работают со строками:

• 

concat()
;

• 

contains()
;

• 

normalize-space()
;

• 

starts-with()
;

• 

string()
;

• 

string-length()
;

• 

substring()
;

• 

substring-after()
;

• 

substring-before()
;

• 

translate()
.

Для работы с числами служат следующие функции XPath:

• 

ceiling()
;

• 

floor()
;

• 

number()
;

• 

round()
;

• 

sum()
.

И эти функции XPath работают с логическими значениями:

• 

boolean()
;

• 

false()
;

• 

lang()
;

• 

not()
;

• 

true()
.

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

Функции XSLT

В следующем списке перечислены встроенные в XSLT функции:

• 

current()
. Возвращает текущий (current) узел — но не контекстный узел. Текущий узел — это узел, используемый в данный момент в таких циклах, как
. Функцию current нельзя применять в образцах;

• 

document()
. Позволяет считывать несколько документов;

• 

element-available()
. Показывает, доступен ли элемент расширения;

• 

format-number()
. Форматирует числа при выводе;

• 

function-available()
. Показывает, доступна ли функция расширения;

• 

generate-id()
. Указывает процессору XSLT присвоить идентификатор узлу и возвратить его. При повторном применении generate-id к тому же узлу функция возвращает присвоенный ранее идентификатор;

• 

key()
. Позволяет осуществлять поиск по ключу;

• 

system-property()
. Позволяет проверить три системных свойства: 
xsl:version
(версия XSLT, поддерживаемая процессором XSLT), 
xsl:vendor
(производитель процессора XSLT) и 
xsl:vendor-url
(URL производителя процессора XSLT);

• 

unparsed-entity-uri()
. Предоставляет доступ к неразобранным сущностям, объявленным в DTD или схеме, через URI.

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

current()

Функция 

current
возвращает текущий (current) — не контекстный (context) — узел. Контекстный узел шаблона — это узел в выбранном наборе узлов, к которому применяется шаблон. Текущий узел, с другой стороны, это используемый в данный момент узел в таких циклах, как
. Функция возвращает текущий узел как набор узлов с одним узлом:

node-set current()

Обратите внимание: 

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

Следующий пример, в котором я выбираю элементы

при помощи шаблона (листинг 8.1), демонстрирует работу функции 
current
. Внутрь шаблона я поместил элемент
, и шаблон применяется только в том случае, если выбранный шаблоном контекстный узел в то же время является и текущим узлом в очередной итерации в элементе
.

Листинг 8.1. Применение функции current

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

 

 

  .

  .

  .

   
   
    
    
    
    
   
   
    

     

     Name
     Mass
     Radius
     Day

Результат применения этой таблицы стилей будет точно таким же, как если бы элемента

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

document()

Функция 

document
особенно полезна, потому что с ее помощью можно читать несколько документов и обрабатывать их содержимое. Функция 
document
применяется следующим образом:

node-set document(uri, base-uri?)

Функция принимает параметр 

uri
, который может представлять собой URI читаемого документа или набор узлов, чьи строковые значения задают идентификаторы URI. Второй, необязательный параметр 
base-uri
представляет собой набор узлов, базовый URI которого используется для вычисления всех относительных URI, могущих находиться в параметре 
uri
.

В следующем примере (листинг 8.2) я обрабатываю в процессоре XSLT один документ, 

planets1.xml
, и также считываю и обрабатываю второй документ, 
planets2.xml
. Вот 
planets1.xml
.

Листинг 8.2. planets1.xml

Вот 

planets2.xml
— в элементе
содержится одна планета (листинг 8.3).

Листинг 8.3. planets2.xml

 Mercury

 .0553

 58.65

 1516

 .983

 43.4

А вот таблица стилей 

planets.xml
, которую я применяю к 
planets1.xml
. Таблица стилей содержит шаблон, выбирающий элемент
в 
planets1.xml
, и в этом шаблоне я считываю 
planets2.xml
при помощи
и функции 
document
(листинг 8.4).

Листинг 8.4. Применение функции document

 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
     

     
     

  

 

 


 

 

  

   

   

   

 

 

 .

 .

 .

Эта таблица стилей обрабатывает данные в 

planets1.xml
и также считывает и обрабатывает 
planets2.xml
; вот полный результат — как видите, данные для 
planets2.xml
добавились нужным образом:

 

 </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

Функция 

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

element-available()

Функция 

element-available()
используются для определения доступности определенного элемента расширения. Ее применяют следующим образом:

boolean element-available(element-name)

Функция принимает имя искомого элемента и, если элемент доступен, возвращает истину, если недоступен — ложь.

Мы уже встречались с этой функцией в главе 5. В примере 

element-available
той главы я проверял наличие элемента
таким образом:

 

  

 

 

  Sorry, can't do math today.

format-number()

Как можно догадаться по имени, функция 

format-number()
служит для форматирования чисел с преобразованием их в строки. Она применяется так:

string format-number(number, format, name?)

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

number
, которое нужно отформатировать, строка форматирования 
format
и необязательный параметр-строка 
name
. Строка name — это имя 
QName
, задающее формат так, как он создается элементом
(который будет рассмотрен в конце этой главы).

Форматирующая строка 

format
должна соответствовать соглашениям класса Java 
DecimalFormat
.

КЛАСС JAVA DECIMALFORMAT

На момент написания книги документация для класса Java DecimalFormat находится в Интернете по адресу: http://java.sun.com/products/jdk/1.1/docs/api/java.text.DecimalFormat.html.

Форматирующая строка (format string) состоит из следующих частей:

• 

format-string:= subpattern (;subpattern)?

• 

subpattern:= prefix? integer (.fraction)?suffix?

• 

prefix:= [#x0..#xFFFD] - specialCharacters

• 

suffix:= [#x0..#xFFFD] - specialCharacters

• 

integer:= '#'* '0'* '0'

• 

fraction:= '0'* '#'*

Далее показаны специальные символы (

specialCharacters
), которые можно использовать в подчиненных образцах, 
subpattern
(эти символы можно изменить при помощи элемента
, который будет рассмотрен в конце этой главы):

• 

0
— на этом месте всегда должна стоять цифра;

• 

#
— цифра, если только это не избыточный лидирующий или завершающий ноль;

• 

.
— разделитель десятичной части;

• 

,
— разделитель групп разрядов;

• 

;
— разделяет форматы;

• 

-
— знак минуса;

• 

%
— умножить на 100 и показать как проценты;

• 

‰
— умножить на 1000 и показать в тысячных частях;

• 

Е
— разделяет мантиссу и экспоненциальную часть;

• 

¤
— символ валюты (#xA4);

• 

'
— заключает в кавычки специальные символы.

Следующий пример (листинг 8.5) демонстрирует работу функции. Я форматирую значения из 

planets.xml
, отображаемые в таблице HTML.

Листинг 8.5. Форматирование чисел

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

 

  .

  .

  .

Вот результат, в котором выведены отформатированные числа:

 

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

 

 

 

  The Formatted Planets Table

 

  
   
   
   
   
   
   
  
   
   
   
   
   
  
   
   
   
   
   
  
   
   
   
   
   
 

     

     Name
     Mass
     Radius
     Day
     

     

     Mercury
     0.055 (Earth = 1)
     1.516 miles
     58.65 days
     

     

     Venus
     0.815 (Earth = 1)
     3.716 miles
     116.75 days
     

     

     Earth
     1 (Earth = 1)
     2.107 miles
     1 days

Этот результирующий документ показан на рис. 8.1. (MSXML3 и Saxon отбрасывают лидирующие нули, поэтому 0.055 выводится как .055 и т.д.)

Рис. 8.1. Форматирование чисел при помощи XSLT


Следующие примеры демонстрируют способы применения форматирующих строк. Заметьте, что при помощи точки с запятой (;) можно отделять образцы для положительных и отрицательных чисел.

Число Форматирующая строка Результат
4567 #,### 4,567
4567.8 ####.# 4567.8
4567.8 #,##0.00 4,567.80
456.789 #,##0.00 456.79
4567890 #,##0.00 4,567,890.00
4567 ###0.0### 4567.0
.00045 ##0.0### 0.0005
.45 #00% 45%
-4.56 #.00;(#.00) (4.56)
-45 #,##0.00 -45

function-available()

При помощи функции XSLT 1.0 

function-available
можно проверить наличие функции расширения:

boolean function-available(function-name)

Функция принимает в качестве параметра имя искомой функции и, если функция доступна, возвращает истину, если нет — ложь.

Следующий пример мы уже рассматривали в главе 5. В этом случае я хочу выполнить ряд математических операций при помощи функции расширения 

starpowder:calculate
, и если она отсутствует, вывести в результирующий документ текст «Sorry, can't do math today.» (Извините, сегодня математические вычисления не работают.). Можно, конечно, также прекратить обработку и вывести сообщение об ошибке при помощи элемента
:

 

  

 

 

  Sorry, can't do math today.

generate-id()

Функция 

generate-id
дает указание процессору XSLT присвоить узлу идентификатор (который возвращается как строка). Функция применяется следующим образом:

string generate-id(node)

Функции следует передать набор узлов, содержащий только узел, которому нужен идентификатор (все узлы после первого игнорируются); функция возвращает уникальный идентификатор для этого узла. Если передать функции снова этот же узел, она вернет тот же идентификатор. Заметьте, что идентификаторы различаются в зависимости от процессора XSLT.

Следующий пример взят из главы 6, но сейчас я собираюсь добавить в 

planets.html
оглавление, составленное из гиперссылок. Для создания оглавления я прохожу в цикле по всем планетам при помощи элемента
. На каждом шаге цикла для текущей планеты я создаю гиперссылку и создаю атрибут 
HREF
со значением, равным уникальному идентификатору, при помощи шаблона значений атрибута:

 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

   

   

    

    

   

    

   

   .

   .

   .

Этот код добавляет каждой планете идентификатор и создает нужные гиперссылки. Я могу создать закладки гиперссылки в HTML-таблице данных планет, установив по очереди атрибут

закладки в идентификатор для каждого элемента
так, чтобы он стал гиперссылкой-назначением:

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

 

 

  .

  .

  .

  

 


 

 

  

    

  

  

  

   

 

 


 

 

  

 

 

 .

 .

 .

Вот и все; сейчас я создал гиперссылки с атрибутом 

HREF
, значение которого равно идентификатору элемента
; при помощи же этого идентификатора я сделал каждый элемент
назначением гиперссылки.

Когда пользователь щелкает на гиперссылку в оглавлении, браузер прокручивает данные до соответствующей записи планеты в HTML-таблице. Вот как выглядит результирующий документ при использовании процессора Xalan: 

 

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

 

 

 

  The Planets Table

 

 

  Mercury

 

  

  

  Venus

 

  

 

  Earth

  

  

  
   
   
   
   
   
   
  
    
   
    
   
   
  
   
   
   
   
  
   
   
   
   
   
  
  

     

     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

key()

Функция 

key
служит для поиска узлов с определенным значением по именованному ключу, ее следует применять следующим образом:

node-set key(name, value)

Функции передаются имя ключа 

name
в виде строки и требуемое значение ключа 
value
, которое нужно найти. Функция возвращает набор узлов из найденных узлов.

Ключи создаются при помощи элемента

. Мы уже видели следующий пример в главе 4 — здесь я при помощи ключей выбираю планеты, чей атрибут 
COLOR
установлен в «
BLUE
»:

 .

 .

 .

 

 Earth

  "(Earth = 1)">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">

 

 

  

  .

  .

  .

   
    
    
     
    
     
    
    
   

     

     Name
     Mass
     Radius
     Day
     

     
     

   

 

 

 .

 .

 .

И вот результат — как видите, единственной планетой, удовлетворившей образцу, была Земля:

 <НЕАD>

 </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

system-property()

Функция 

system-property
возвращает значение нескольких системных свойств в виде строк; вот как ей следует пользоваться:

string system-property(property)

Можно проверять следующие возможные значения системного свойства 

property
:

• 

xsl:version
. Возвращает версию XSLT;

• 

xsl:vendor
. Возвращает строку, идентифицирующую производителя процессора XSLT;

• 

xsl:vendor-url
. Возвращает URL производителя процессора XSLT.

Вот пример — версию XSLT можно проверить, вызвав 

system-property('xsl:version')
;

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

 .

 .

 .

 

  

 

 .

 .

 .

Проверка версии XSLT может понадобиться, если вы хотите воспользоваться возможностями, которые появились в последних версиях.

unparsed-entity-uri()

Функция 

unparsed-entity-uri()
предоставляет доступ к объявлениям неразобранных сущностей в DTD или схеме исходного документа. Неразобранная сущность (unparsed entity) — это обычно двоичные данные, такие как файл с рисунком. Функция применяется следующим образом:

string unparsed-entity-uri(name)

В функцию передается имя name неразобранной сущности, и функция возвращает для нее идентификатор. В следующем примере (листинг 8.6) я добавил в 

planets.xml
DTD и объявил три неразобранных сущности, соответствующих рисункам планет — 
image1
, 
image2
и 
image3
, — и обратился к ним, добавив в каждый элемент
атрибут 
IMAGE
.

Листинг 8.6. planets.xml с неразобранными сущностями

]>

 

 Mercury

  .0553

 58.65

 1516

 .983

 43.4

 

 

  Venus

  .815

 116.75

 3716

 .943

  66.8

 

 

 Earth

 1

 1

 2107

 1

  128.4

 

 .

 .

 .

Заметьте, что некоторые процессоры XSLT не могут осуществлять выборку по ID, потому что они не читают объявления DTD и схему XML. Это одна из задач, которые призван решить XSLT 2.0 — сделать доступной информацию об идентификаторах.

last()

Функция 

last
возвращает число узлов в наборе узлов, поэтому ее значение равно позиции последнего узла. Она применяется следующим образом:

number last()

Следующий пример из главы 5 последовательно выводит в результирующий документ имена планет. Однако я хочу, чтобы выводилось не просто «The first three planets are: Mercury Venus Earth» (первые три планеты: Меркурий Венера Земля), a «The first three planets are: Mercury, Venus, and Earth.» Необходимые знаки пунктуации можно добавить, определяя элемент, с которым мы работаем, при помощи функции position и проверяя позицию при помощи

:

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

 

 

 

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

   

   The first three planets are:

   

   

 

 


 

 

 , 

 and 

 .

Вот результат:

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

 

  The first three planets are: Mercury, Venus, and Earth.

local-name()

Функция 

local-name
возвращает локальное (неполное) имя узла. Функция применяется следующим образом:

string local-name(node-set?)

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

В следующем примере я создаю новые элементы при помощи

и определяю имена контекстных узлов при помощи 
local-name
:

 

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

name()

Функция 

name
аналогична 
local-name
, за тем исключением, что она возвращает полностью определенное имя узла. Вот как следует применять эту функцию:

string name(node-set?)

namespace-uri()

Функция 

namespace-uri
возвращает строку, содержащую URI пространства имен в расширенном имени узла. Как правило, это URI в объявлении пространства имен, установленное при помощи атрибутов 
xmlns
или 
xmlns:prefix
. Функция применяется следующим образом (заметьте, что эту функцию можно применять только к элементам или атрибутам, результатом обработки остальных узлов будет пустая строка):

string namespace-uri(node-set?)

Например, в 

planets.xml
я могу добавить пространство имен «star» (звезда):

 href="planets.xsl"?>

 

  

  Mercury

   .0553

   58.65

   1516

   .983

  43.4

 

  

  Venus

  .815

  116.75

   3716

   .943

  66.8

 

  .

  .

  .

И я могу найти URI этого пространства имен в таблице стилей при помощи 

namespace-uri
:

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

 xmlns:star="http://www.starpowder.com">

 

  

 

 .

 .

 .

Вот результат:

http://starpowder.com

position()

Функция 

position
возвращает позицию контекстного узла:

number position()

С этой функцией мы встречались на протяжении всей книги. Такой пример вы уже видели раньше в этой главе, в нем для создания предложения «The first three planets are: Mercury, Venus, and Earth.» используются функции 

last
и 
position
:

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

 

 

 

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

   

   The first three planets are:

   

   

 

 


 

 

 , 

 and 

 .

Полученный результат:

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

 

  The first three planets are: Mercury, Venus, and Earth.

Функции XPath для работы со строками

В XSLT доступны следующие функции XPath для работы со строками:

• 

concat(string string1, string string2,...)
. Возвращает конкатенацию (объединение) всех переданных ей строк;

• 

contains(string string1, string string2)
. Возвращает истину, если первая строка содержит (contains) вторую строку;

• 

normalize-space(string string1)
. Возвращает строку 
string1
(или контекстный узел, если строки 
string1
нет) после отбрасывания лидирующих и завершающих символов-разделителей и замены нескольких последовательных разделителей на один пробел;

• 

starts-with(string string1, string string2)
. Возвращает истину, если первая строка начинается (starts with) со второй подстроки;

• 

string(object)
. Преобразует объект в строку;

• 

string-length(string string1)
. Возвращает количество символов в строке 
string1
;

• 

substring(string string1, number offset, number length)
. Возвращает 
length
символов из строки, начиная со смещения 
offset
;

• 

substring-after(string string1, string string2)
. Возвращает часть строки 
string1
после первого вхождения 
string2
;

• 

substring-before(string string1, string string2)
. Возвращает часть строки 
string1
вплоть до первого вхождения строки 
string2
;

• 

translate(string string1, string string2, string string3)
. Возвращает строку 
string1
, в которой все вхождения символов в строке 
string2
заменены на соответствующие символы в строке 
string3
;

В последующих разделах я рассмотрю каждую из этих функций.

concat()

Функция 

concat
объединяет вместе все переданные ей строки и возвращает полученную строку:

concat(string string1, string string2, ...)

В качестве примера рассмотрите разработанный ранее вариант таблицы стилей 

planets.xsl
, отображающей значения элементов и значения атрибутов 
UNITS
, в котором шаблоны применяются следующим образом:

Такой код отображает строковое значение, контекстный узел, пробел и строковое значение атрибута UNITS. Но код можно значительно сократить при помощи функции 

concat
(листинг 8.8).

Листинг 8.8. Применение функции concat

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

 

 

   .

  .

  .

contains()

Функция 

contains
проверяет, содержится ли одна строка внутри другой; если это так, функция возвращает истину, если нет — ложь. Функция применяется следующим образом:

boolean contains(container-string, contained-string)

Следующий пример взят из главы 7; в этом случае я хочу осуществить поиск слова «miles» во всех атрибутах, и если оно будет найдено, добавить в результирующий документ текст «You should switch to kilometers.» (Нужно перевести в километры.):

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

 

 

  .

  .

  .

  

 


 

 

  

  

   

   

   

 

 


 

 

  

 

 

 .

 .

 .

 

 

  

 

 


 

 

  

  You should switch to kilometers.

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

 

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

 

 

 

  The Planets Table

 

  
  
   
   
   
   
   
   
  
   
  
   
   
   
  
  
   
   
   
   
   
   
  
   
   
   
   
   
  
  

     

     Name
     Mass
     Radius
     Day
     Distance
     

     

     Mercury
     .0553 (Earth = 1)
     1516 You should switch to kilometers.
     58.65 days
     43.4 You should switch to kilometers.
     

     

     Venus
     .815 (Earth = 1)
     3716 You should switch to kilometers.
     116.75 days
     66.8 You should switch to kilometers.
     

     

     Earth
     1 (Earth = 1)
     2107 You should switch to kilometers.
     1 days
     128.4 You should switch to kilometers.

normalize-space()

Функция 

normalize-space
удаляет лидирующие и завершающие символы-разделители и сжимает все внутренние идущие подряд разделители в один пробел, возвращая полученную строку. Функция применяется следующим образом:

string normalize-space(string?)

В следующем примере я добавил дополнительные пробелы в атрибут 

UNITS
элемента
Меркурия:

 

  Mercury

  .0553

 58.65

 1516

 .983

 43.4

 

 .

 .

 .

Функция 

normalize-space
поможет удалить лишние пробелы в таблице стилей:

 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

 

  
   
   
   
   
   
   
  
   
   
   
   
   
  .
  .
  .

     

      starts-with()
     

     
Как можно догадаться по имени (начинается с), функция 
starts-with
 проверяет, начинается ли одна строка с другой.

     
boolean starts-with(string-to-examine, possible-start-string)

     
В этом примере из главы 4 при помощи 
starts-with
 выбираются текстовые узлы, текст в которых начинается с «Е», для того чтобы выбрать Earth (Землю). Затем в описание Земли добавляется текст «(the World)» (мир), и получается «Earth (the World)»:

     

     

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

     
 

     
 

     
   

     
   .

     
   .

     
   .

     
  

     
  

     
 

     

     
 

     
 
  
   
  
   
 
 


     
 

     
  (the World)

     
 

     

     
 

     
 

     
  

     
 

     
 

     
 

     

     
 

     
 

     
  

     
 

     
 

     

     
Вот результат — заметьте, что подпись для Земли теперь выглядит как «Earth (the World)»:

     

     
 

     
 </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
     

     
     
     
    
    

     
     
     
     
     

     
     
   
   
   
   
   
  
  .
  .
  .
  
   
   
   
   
   
 

     

     Name
     Mass
     Radius
     Day
     

     
     
     
     

     Earth (the World
     1 (Earth = 1)
     2107 miles
     1 days

string()

Функция 

string
просто преобразует переданный ей объект в строку. Функция применяется следующим образом:

string string(object?)

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

в 
planets.xml
по три элемента
и хотите использовать в качестве фактического названия планеты только первый элемент
:

 

  Mercury

  Venus

  Earth

  .0553

 58.65

 1516

 .983

 43.4

 

 

  Venus

 Earth

 Mercury

  Planet of Love.

 .815

 116.75

 3716

 .943

 66.8

 

 

  Earth

  Mercury

  Venus

  The planet you're standing on.

 1

 1

 2107

 1

  128.4

Предположим теперь, что вам нужно выбрать определенную планету, например, Венеру (Venus). Такая проверка не пройдет, потому что 

NAME
вернет набор узлов из всех дочерних элементов
контекстного узла, а так как у каждой планеты есть элемент
со значением «Venus», такое условие всегда будет истиной:

Для того чтобы проверить первый элемент

в каждом элементе
, можно воспользоваться функцией 
string
, поскольку она возвращает не набор узлов, а строку:

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

 

 

  .

  .

  .

  

 


 

 

  

   

   

   

   

   

 

 


 

 

  

 

 

 .

 .

 .

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

контекстного узла, проще воспользоваться 
NAME[1]
.

string-length()

Как можно предположить, функция 

string-length
возвращает длину (length) переданной ей строки. Функция применяется таким образом:

number string-length(string?)

В следующем примере я определяю длину названия каждой планеты при помощи 

string-length
:

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

 

 

   

   </code></pre></p>
     <p><pre><code>   Length of Planet Names</code></pre></p>
     <p><pre><code>   

   

   

   

   Length of Planet Names

   

   

  

 

 


 

   is

 

 characters long.

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

 

 </code></pre></p>
     <p><pre><code>  Length of Planet Names</code></pre></p>
     <p><pre><code> 

 

 

 

  Length of Planet Names

 

  Mercury is 7 characters long.

 

  Venus is 5 characters long.

 

  Earth is 5 characters long.

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

Рис. 8.2. Определение длины строк в XSLT

substring()

Функция 

substring
возвращает подстроку переданной ей строки. Функция применяется следующим образом:

string substring(source-string, start-position, number-of-characters?)

Функция принимает параметры 

source-string
(исходная строка), 
start-position
(начальная позиция) и необязательный параметр 
number-of-characters
(количество символов). Функция возвращает подстроку исходной строки с начальной позиции и до указанного количества символов или до конца строки, если это количество не задано.

Функция 

substring
— одна из трех функций, оперирующих с подстроками: 
substring-before
, возвращающая строку перед найденной подстрокой, сама 
substring
, возвращающая заданную подстроку, и 
substring-after
, возвращающая строку после найденной подстроки. В следующем примере (листинг 8.9) задействованы все три функции: в этом случае я разбил название планеты Меркурий (Mercury) на три подстроки — «Mer», «c» и «ury» — и затем объединил их снова. Вот как это можно сделать при помощи трех рассматриваемых функций (дополнительная информация о 
substring-before
и 
substring-after
приведена в следующих двух разделах).

Листинг 8.9. Применение функций substring-before, substring и substring-after

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

 

 

   

   </code></pre></p>
     <p><pre><code>   Planetary Information</code></pre></p>
     <p><pre><code>   

   

   

   

   Planetary Information

   

   

  

 

 


 

 

   The first planet is

   .

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

 

 </code></pre></p>
     <p><pre><code>  Planetary Information</code></pre></p>
     <p><pre><code> 

 

 

 

  Planetary Information

 

  The first planet is Mercury.

substring-after()

Функция 

substring-after
возвращает подстроку, которая следует за найденной строкой. В эту функцию передается строка, подстрока, которую нужно найти внутри строки, — и функция возвращает подстроку, расположенную после совпадающей части строки, если она была найдена; иначе функция возвращает пустую строку. Функция применяется следующим образом:

string substring-after(string, string-to-match)

substring-before()

В функцию 

substring-before
передается строка, подстрока, которую нужно найти внутри строки, и функция возвращает подстроку, расположенную перед совпадающей частью строки, если она была найдена; иначе функция возвращает пустую строку. Функция применяется следующим образом:

string substring-before(string, string-to-match)

В разделе 

substring()
приведен пример применения функций 
substring-before
, 
substring
и 
substring-after
.

translate()

Функция 

translate
служит для перевода или замены определенных символов. (Эта функция во многом похожа на операцию tr в Perl, если вы знакомы с операциями.) В функцию передаются две строки: одна задает список символов поиска, вторая задает список символов, которыми нужно заменить найденные символы. Функция применяется следующим образом:

string translate(string, from-characters, to-characters)

Например, если третий символ из 

from-characters
будет найден в 
string
, то третий символ из 
to-characters
заменит его в результирующей строке. В следующем примере такая функция 
translate

translate("steve-starpowder.com", "-", "@")

возвратит результирующую строку «steve@starpowder.com».

В этом примере я просто привожу строку к нижнему регистру:

translate("XSLT", "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")

Функции XPath для работы с числами

В XPath имеются следующие функции для работы с числами:

• 

ceiling()
. Возвращает наименьшее целое, большее переданного функции числа,

• 

floor()
. Возвращает наибольшее целое, меньшее переданного функции числа;

• 

number()
. Приводит переданный ей параметр к числу;

• 

round()
. Округляет переданное функции число до ближайшего целого;

• 

sum()
. Возвращает сумму переданных функции чисел.

В следующих разделах мы рассмотрим примеры применения каждой из этих функций.

ceiling()

Функция 

ceiling
возвращает наименьшее целое, которое все еще больше переданного функции числа, то есть она возвращает следующее большее целое. Функция применяется следующим образом:

number ceiling(number)

Например, выражение

ceiling(3.1415926535)

возвращает 4.

floor()

Функция 

floor
— парная к функции 
ceiling
. Она возвращает наибольшее целое, которое все еще меньше переданного ей числа. Другими словами, функция возвращает предыдущее целое. Функция применяется следующим образом:

number floor(number)

В этом примере я при помощи 

floor
преобразую длительность дней планет в целые числа:

 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
     

     

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

     

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

     

     Earth
     1 (Earth = 1)
     2107 miles
     1 days

number()

Функция 

number
приводит свой аргумент к числу. Функция применяется следующим образом:

number number(object?)

В этом примере я передаю 

number
строку:

number("456.7")

Это выражение возвращает число 456.7. Если вы попытаетесь преобразовать что-то, что 

number
не сможет перевести в число, функция вернет значение XPath 
NaN
(Not a Number, не число). 
NaN
— корректное значение, которое можно проверять в выражениях Xpath.

round()

Функция 

round
округляет переданное ей значение. Функция применяется следующим образом:

number round(number)

Например, 

round(3.1415926535)
возвращает 3, 
round(4.5)
возвращает 5 и 
round(-1.5)
возвращает -1.

sum()

Функция 

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

number sum(node-set)

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

planets.xml
:

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

 

 

 

   

   The average planetary mass is

Логические функции XPath

XPath также поддерживает следующий набор логических функций:

• 

boolean()
. Приводит аргумент к логическому значению;

• 

false()
. Возвращает false (ложь);

• 

lang()
. Проверяет, совпадает ли язык, установленный в атрибуте 
xml:lang
, с языком, переданным в функцию;

• 

not()
. Инвертирует значение true\false аргумента;

• 

true()
. Возвращает true (истина).

boolean()

Функция 

boolean
преобразует аргумент в логическое значение. Функция применяется следующим образом:

boolean boolean(object)

Ниже показано, как функция работает с различными типами XPath:

• 

number
. Если число равно нулю, результатом будет ложь; иначе результат — истина. NaN всегда возвращает ложь;

• 

string
. Если строка не пуста, результат — истина, иначе — ложь;

• 

boolean
. Значение не изменяется;

• 

nodeset
. Пустой набор узлов дает ложь, не пустой — истину;

• Фрагмент результирующего дерева в XSLT 1.0 всегда дает истину.

false()

Функция 

false
возвращает ложь. Она применяется следующим образом:

boolean false()

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

false
. (С переменными вы познакомитесь в главе 9.)

lang()

Функция 

lang
проверяет, совпадает ли язык контекстного узла (определенный в атрибуте 
xml:lang
) с переданным ей языком. Функция применяется следующим образом:

boolean lang(string)

Функции нужно передать строку, определяющую язык в спецификации XML, как, например, «en» для английского, «de» для немецкого и «jp» для японского.

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

xml:lang
в 
planets.xml
в значение, соответствующее английскому языку:

 

  Mercury

 .0553

 58.65

 1516

 .983

 43.4

 

 .

 .

 .

Теперь я удостоверяюсь, что исходный документ на самом деле написан на английском, перед тем как применять к нему шаблоны:

 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

not()

Функция 

not
инвертирует логическое значение аргумента. При передаче аргумента с логическим значением true она возвращает false; при передаче аргумента со значением false функция возвращает true. Функция применяется следующим образом:

boolean not(boolean)

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

COLOR
и 
POPULATED
. Для этого я применяю предикат выбора «
[@COLOR and (@POPULATED]
». Для того, чтобы убрать другие элементы (чтобы правила по умолчанию не включали их текст в результирующий документ), я использую предикат «
[not(@COLOR) or not(@POPULATED)]
»:

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

 

 

  .

  .

  .

Вот результат:

 

 </code></pre></p>
     <p><pre><code>  Colorful, Populated Planets</code></pre></p>
     <p><pre><code> 

 

 

 

  Colorful, Populated Planets

 

  
   
   
   
   
   
  
  
   
   
   
   
  
 

     

     Name
     Mass
     Radius
     Day
     

     

     Earth
     1 (Earth = 1)
     2107 miles
     1 days

true()

Функция 

true
возвращает значение true. Она применяется следующим образом:

boolean true()

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

true
. (С переменными вы познакомитесь в главе 9.)

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

Перед тем как закончить обсуждение функций XSLT и XPath, я хочу рассмотреть специальный элемент XSLT,

, единственное предназначение которого заключается в работе только с одной функцией 
format-number
. В частности, при помощи этого элемента определяются символы и идентификаторы, которые будет использовать 
format-number
. У этого элемента несколько атрибутов:

• 

name
(необязательный). Имя десятичного формата. Принимает значение типа 
QName
. Если формат не задан, используется десятичный формат по умолчанию;

• 

decimal-separator
(необязательный). Определяет символ, разделяющий целую и дробную части числа. По умолчанию «.». Устанавливается в символ;

• 

grouping-separator
(необязательный). Определяет символ, разделяющий группы разрядов. По умолчанию «,».Устанавливается в символ;

• 

infinity
(необязательный). Задает строку, обозначающую положительную бесконечность. По умолчанию «Infinity» (бесконечность). Устанавливается в строку;

• 

minus-sign
(необязательный). Определяет символ, представляющий знак минуса. По умолчанию «-». Устанавливается в символ;

• 

NaN
(необязательный). Определяет строку, представляющую значение «Not a Number» (не число). По умолчанию «NaN». Устанавливается в строку;

• 

percent
(необязательный). Определяет символ, представляющий знак процента. По умолчанию «%». Устанавливается в символ;

• 

per-mille
(необязательный). Определяет символ, представляющий знак промилле, то есть тысячных долей. По умолчанию «‰». Устанавливается в символ;

• 

zero-digit
(необязательный). Определяет символ для использования в форматирующих строках для указания лидирующего или завершающего нуля. По умолчанию «0». Устанавливается в символ;

• 

digit
(необязательный). Определяет символ для использования в форматирующих строках для указания цифры. По умолчанию «0». Устанавливается в символ;

• 

pattern-separator
(необязательный). Определяет символ, разделяющий образцы для положительных и отрицательных чисел. По умолчанию «;». Устанавливается в символ.

Этот элемент — верхнего уровня, и он всегда пуст. При помощи этого элемента можно устанавливать форматирующие символы для функции 

format-number
. Элемент 
xsl:decimal-format
, у которого не установлен 
атрибут
name, становится десятичным форматом по умолчанию. Наличие более одного элемента 
xsl:decimal-format
по умолчанию или нескольких элементов 
xsl:decimal-format
с одним и тем же именем является ошибкой. В следующем примере я форматирую числа в 
planets.xml
при помощи европейского формата числа, а именно — я использую запятую вместо десятичной точки для разделения целой и дробной частей, и точку вместо запятой для разделения групп разрядов. Для этого мне нужно только задать новое форматирование при помощи
и затем применить его в 
format-number
:

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

 

 

 

   

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

   

   

   

   The Formatted Planets Table

   

   
    
    
    
    
    
    
   
   

    

    Name
    Mass
    Radius
    Day

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

 

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

 

 

 

  The Formatted Planets Table

 

  
   
   
   
   
   
  
  
   
   
   
   
   
  
   
   
   
   
   
  
   
   
   
   
   
  

    

    Name
    Mass
    Radius
    Day
    

    

    Mercury
    0,055 (Earth = 1)
    1,516 miles
    58,65 days
    

    

    Venus
    0,815 (Earth = 1)
    3,716 miles
    116,75 days
    

    

    Earth
    1 (Earth = 1)
    2,107 miles
    1 days

Этот документ показан на рис. 8.3.

Рис. 8.3. Задание десятичных форматов


Вот и все — теперь вы можете задавать параметры форматирования для функции 

format-number
.

Новые функции в XSLT 2.0 и XPath 2.0

В XSLT 2.0 и XPath 2.0 планируется включить весьма много функций. В частности, для XSLT 2.0 внесены в план следующие положения:

• должны быть включены функции, которые могут работать с 

QName
, для того, чтобы можно было применить объявления пространств имен из области видимости;

• должны быть добавлены функции форматирования даты для поддержки схемы XML;

• должна быть включена функция для преобразования относительных идентификаторов URI в абсолютные;

• должны быть включены функции, упрощающие группировку. В XSLT 2.0 должно быть возможно группировать узлы на основе их строковых значений.

В XPath 2.0 в отношении функций планируются следующие изменения:

• должен быть расширен набор агрегирующих функций — например, включены функции минимума и максимума;

• для наборов узлов должны быть реализованы функции пересечения и разности;

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

• должны быть включены агрегирующие функции для работы с коллекциями такими как наборы узлов;

• должны быть определены функции для работы со стандартными типами схемы XML.

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

ТЕЛЕГРАМ

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

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

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

Поиск книг

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

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

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

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

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

Детективы

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

Фантастика

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

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

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

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

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

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

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

Фантастика

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

Топ фб2 книги