Технология XSLT
Шрифт:
Пример
Иногда в процессе отладки преобразования бывает полезно выводить сообщения о том, какой элемент обрабатывается в данный момент.
Листинг 8.5. Входящий документ
<a><b><c><d/></c></b></a>
Листинг 8.6. Преобразование
<xsl:stylesheet
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="*">
<element name="{name}">
<xsl:message>
<xsl:text>Processing element </xsl:text>
<xsl:value-of select="name"/>
<xsl:if test="parent::*">
<xsl:text> which has a parent element </xsl:text>
<xsl:value-of select="name(..)"/>
</xsl:if>
<xsl:text>.</xsl:text>
</xsl:message>
<xsl:apply-templates/>
</element>
</xsl:template>
</xsl:stylesheet>
Листинг 8.7.
Выходящий документ
<element name="a">
<element name="b">
<element name="c">
<element name="d"/>
</element>
</element>
</element>
Листинг 8.8. Сообщения процессора
Processing element a.
Processing element b which has a parent element a.
Processing element с which has a parent element b.
Processing element d which has a parent element c.
Атрибут
terminate
указывает на то, должен ли процессор прекратить дальнейшую обработку документа или нет. Значением этого атрибута по умолчанию является "no"
, что означает, что процессор должен просто вывести сообщения и продолжать дальнейшее выполнение шаблона. Если же в xsl:message
указано terminate="yes"
, то процессор, выведя сообщение, прервет обработку. Этот прием может использоваться, например, для того, чтобы проверять входящие документы на соответствие определенной схеме. Пример
При помощи
xsl:message
мы можем запретить обработку документов, которые не имеют в корне элемент с именем "html"
в любом регистре символов. Листинг 8.9. Шаблон преобразования
<xsl:template match="/">
<xsl:if test="translate(name(*),'html','HTML')!='HTML'">
<xsl:message terminate="yes">
<xsl:text>Document has no root HTML element.</xsl:text>
</xsl:message>
</xsl:if>
</xsl:template>
Если мы будем обрабатывать документ вида
<hTmL>
<body/>
</hTmL>
обработка не будет прервана, в то время как преобразование документа
<ht-ml>
<body/>
</ht-ml>
будет прервано сообщением:
Document has no root HTML element:
Processing terminated using xsl:message
Сортировка
При
преобразовании документа элементамиxsl:for-each
и xsl:apply-templates
, выбранные узлы по умолчанию обрабатываются в порядке просмотра документа, который зависит от выражения, использованного в атрибуте select
этих элементов. XSLT позволяет изменять этот порядок посредством использования механизма сортировки. Элементы
xsl:for-each
и xsl:apply-templates
могут содержать один или несколько элементов xsl:sort
, которые позволяют предварительно сортировать обрабатываемое множество узлов. Элемент xsl:sort
Синтаксис этого элемента определяется в XSLT как:
<xsl:sort
select = "выражение"
lang = "язык"
data-type = "text" | "number" | "имя"
order = "ascending" | "descending"
case-order = "upper-first" | "lower-first" />
В случае если
xsl:for-each
и xsl:apply-templates
содержат элементы xsl:sort
, обработка множества узлов должна производиться не в порядке просмотра документа, а в порядке, который определяется ключами, вычисленными при помощи xsl:sort
. Первый элемент xsl:sort
, присутствующий в родительском элементе, определяет первичный ключ сортировки, второй элемент — вторичный ключ, и так далее. Элемент
xsl:sort
обладает атрибутом select
, значением которого является выражение, называемое также ключевым выражением. Это выражение вычисляется для каждого узла обрабатываемого множества, преобразуется в строку и затем используется как значение ключа при сортировке. По умолчанию значением этого атрибута является "."
, что означает, что в качестве значения ключа для каждого узла используется его строковое значение. После этих вычислений узлы обрабатываемого множества сортируются по полученным строковым значениям своих ключей и обрабатываются в новом порядке. Если ключи некоторых узлов совпадают, они могут быть в дальнейшем отсортированы вторичными и так далее ключами.
Элемент
xsl:sort
может иметь следующие необязательные атрибуты, которые указывают некоторые параметры сортировки. □ Атрибут
order
определяет порядок, в котором узлы должны сортироваться по своим ключам. Этот атрибут может принимать только два значения — "ascending"
, указывающее на восходящий порядок сортировки, и "descending"
, указывающее на нисходящий порядок. Значением по умолчанию является "ascending"
, то есть восходящий порядок. □ Атрибут
lang
определяет язык ключей сортировки. Дело в том, что в разных языках символы алфавита могут иметь различный порядок, что, соответственно, должно учитываться при сортировке. Атрибут lang
в XSLT может иметь те же самые значения, что и атрибут xml:lang
(например: "en"
, "en-us"
, "ru"
и т.д.). Если значение этого атрибута не определено, процессор может либо определять язык исходя из параметров системы, либо сортировать строки исходя из порядка кодов символов Unicode.
Поделиться с друзьями: