Книга: Технология XSLT
Элемент xsl:message
Разделы на этой странице:
Элемент xsl:message
Синтаксис этого элемента дан ниже:
<xsl:message
terminate="yes" | "no">
<!-- Содержимое: шаблон -->
</xsl:message>
Элемент xsl:message указывает процессору на то, что он должен вывести сообщение, которое является результатом обработки шаблона, содержащегося в этом элементе. Механизм вывода сообщения зависит от реализации того или иного процессора и может быть различным — от вывода текста сообщения на экран до вызова внешнего модуля для обработки сообщения.
Пример
Иногда в процессе отладки преобразования бывает полезно выводить сообщения о том, какой элемент обрабатывается в данный момент.
Листинг 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
Оглавление книги
- Глава 12 Документы XSL-FO
- Элементы , и
- XSLT как язык
- Элемент
- Создание свободно позиционируемых элементов
- 6.4. Рабочий лист Excel и его структурные элементы
- Использование отдельных процессоров XSLT
- Письма с элементами графики и вложениями
- Элемент STYLE
- 4.4. Логические элементы и синтез логических схем
- 4.7 Структурные элементы SAN
- Добавление, изменение и удаление элементов списка