Книга: XSLT

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

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

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

Создание нескольких результирующих документов настолько распространенная задача, что практически все процессоры XSLT позволяют вам это сделать, даже в XSLT 1.0, где отсутствуют необходимые для этого средства. Процессоры XSLT добавляют для этого новые элементы расширения. Например, Xalan предоставляет элемент <write>, позволяющий написать новый результирующий документ. Для работы с этим элементом нужно создать новый префикс пространства имен — здесь я использую «xalan» — которое Xalan использует для элемента, «com.lotus.xsl.extensions.Redirect», и указать, что этот новый префикс является префиксом элемента расширения:

<?xml version="1.0"?>
<xsl:stylesheet version="1.1"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:xalan="com.lotus.xsl.extensions.Redirect"
 extension-element-prefixes="xalan">
 .
 .
 .

Теперь при помощи атрибута file элемента <xalan:write> можно записать новый файл:

<?xml version="1.0"?>
<xsl:stylesheet version="1.1"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:xalan="com.lotus.xsl.extensions.Redirect"
 extension-element-prefixes="xalan">
 .
 .
 .
 <xalan:write file="newdoc.txt">
  <xsl:text>Here's some text.</xsl:text>
 </xalan:write>

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

<?xml version="1.0"?>
<xsl:stylesheet version="1.1"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:saxon="http://icl.com/saxon"
 extension-element-prefixes="saxon">
 .
 .
 .
 <saxon:output file="newdoc.txt">
  <xsl:text>Here's some text.</xsl:text>
 </saxon:output>

To же можно сделать и в XT; в этом случае используйте пространство имен <http://www.jclark.com/xt» с элементом <document> и атрибут href для задания имени нового файла:

<?xml version="1.0"?>
<xsl:stylesheet version="1.1"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 xmlns:xt="http://www.jclark.com/xt"
 extension-element-prefixes="xt">
 .
 .
 .
 <xt:document href="newdoc.txt">
  <xsl:text>Here's some text.</xsl:text>
 </xt:document>

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

• 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> вывода. Устанавливается в строковое значение;

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

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

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

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

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

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

<HTML>
 <HEAD>
  <TITLE>
   Two Frames
  </TITLE>
 </HEAD>
 <FRAMESET cols="50%, 50%">
  <FRAME src="frame1.html"/>
  <xsl:document href="frame1.html">
   <HTML>
    <HEAD>
     <TITLE>
      Frame 1
     </TITLE>
    </HEAD>
    <BODY>
     <H1>This is frame 1.</H1>
    </BODY>
   </HTML>
  </xsl:document>
  .
  .
  .

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

<HTML>
 <HEAD>
  <TITLE>
   Two Frames
  </TITLE>
 </HEAD>
 <FRAMESET cols="50%, 50%">
  <FRAME src="frame1.html"/>
  <xsl:document href="frame1.html">
   <HTML>
    <HEAD>
     <TITLE>
      Frame 1
     </TITLE>
    </HEAD>
    <BODY>
     <H1>This is frame 1.</H1>
    </BODY>
   </HTML>
  </xsl:document>
  <FRAME src=" frame2.html"/>
  <xsl:document href="frame2.html">
   <HTML>
    <HEAD>
     <TITLE>
      Frame 2
     </TITLE>
    </HEAD>
    <BODY>
     <H1>This is frame 2.</H1>
    </BODY>
   </HTML>
  </xsl:document>
 </FRAMESET>
</HTML>

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

На момент написания книги в одном процессоре XSLT элемент <xsl:document> был реализован: это Saxon версии 6.2.1 и старше, в котором свой элемент <saxon:output> был изменен на <xsl:document>. Но пока это единственный известный мне процессор XSLT, поддерживающий этот элемент.

Оглавление книги