Перейти к содержанию

xsl:message

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

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

Синтаксис

<xsl:message
    terminate = "yes | no">
    <!-- Content: template -->
</xsl:message>

Атрибуты:

terminate
необязательный атрибут, указывает на то, должен ли процессор прекратить дальнейшую обработку документа или нет. Значением этого атрибута по умолчанию является "no", что означает, что процессор должен просто вывести сообщения и продолжать дальнейшее выполнение шаблона. Если же в xsl:message указано terminate="yes", то процессор, выведя сообщение, прервет обработку. Этот прием может использоваться, например, для того, чтобы проверять входящие документы на соответствие определенной схеме.

Описание и примеры

Пример 1

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

Листинг 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 c which has a parent element b.
Processing element d which has a parent element c.

Атрибут terminate указывает на то, должен ли процессор прекратить дальнейшую обработку документа или нет. Значением этого атрибута по умолчанию является "no", что означает, что процессор должен просто вывести сообщения и продолжать дальнейшее выполнение шаблона. Если же в xsl:message указано terminate="yes", то процессор, выведя сообщение, прервет обработку. Этот прием может использоваться, например, для того, чтобы проверять входящие документы на соответствие определенной схеме.

Пример 2

При помощи 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

Ссылки