XInclude

XML Inclusions (XInclude) — рекомендация Консорциума Всемирной паутины, которая описывает механизм включений в XML-документы текстовых файлов или других XML-документов (а также их частей).

Общие сведения

Версия 1.0 спецификации XInclude описывает пространство имён http://www.w3.org/2001/XInclude и два XML-элемента внутри этого пространства имён: include и fallback.

Элемент include определяет включение:

<source lang="xml">

 <include xmlns="http://www.w3.org/2001/XInclude" href="included_document.xml"/>

</source>

Можно также включить текстовый файл:

<source lang="xml">

 <include xmlns="http://www.w3.org/2001/XInclude" href="my_text.txt" parse="text"/>

</source>

Элемент fallback позволяет задать алтенативное содержимое для случаев, когда ресурс, указанный в include, недоступен. Возможно использование элементов include внутри fallback, например:

<source lang="xml">

   <xi:include href="contents.xml">
     <xi:fallback>
       <xi:include href="alternative_contents.xml">
         <xi:fallback>ошибка: оба ресурса недоступны</xi:fallback>
       </xi:include>
     </xi:fallback>
   </xi:include>

</source>

Семантика XInclude отличается от XLink тем, что XInclude описывает включение (слияние) документов, подобно #include препроцессора языка Си, в то время как XLink определяет ссылку из одного документа на другой.

Механизм XInclude обрабатывается на низком уровне (обычно отдельным XInclude-процессором), но не на уровне синтаксического анализатора XML.

Пример использования XInclude

Исходный документ:

<source lang="xml">

 <?xml version='1.0' encoding="UTF-8"?>
 <document xmlns:xi="http://www.w3.org/2001/XInclude">

Текст моего документа

   <xi:include href="copyright.xml"/>
 </document>

</source>

Если copyright.xml содержит следующие строки:

<source lang="xml">

 <?xml version='1.0' encoding="UTF-8"?>
 <copyright>Все права защищены © 2001-2010</copyright>

</source>

то после обработки исходного документа процессором XInclude результатом является следующий документ:

<source lang="xml">

 <?xml version='1.0' encoding="UTF-8"?>
 <document xmlns:xi="http://www.w3.org/2001/XInclude">

Текст моего документа

   <copyright>Все права защищены © 2001-2010</copyright>
 </document>

</source>

См. также

• XLink, XPointer — языки описания ссылок XML
• XPath — язык адресации XML

Ссылки

• Спецификация XInclude (англ.)