Простір імен у XML 1.0 (третє видання)

1 Мотивація та Резюме

Ми припускаємо, що застосування розширюваної мови розмітки (XML), де один документ XML може містити елементи й атрибути (так званий "словник розмітки"), які визначені і використовуються декількома програмними модулями. Причина виникнення для цього є модульність: якщо такий словник розмітки існує, який в свою чергу добре розуміє і для якого є корисне програмне забезпечення, в такому разі, цю розмітку краще використовувати повторно, ніж її винаходити для нової обробки.

Такі документи, які містять декілька словників розмітки, створюють проблеми розпізнавання і колізії. Програмні модулі повинні бути в змозі розпізнавати елементи та атрибути, які призначені для обробки, навіть в умовах "колізій", що виникають при використанні того ж імені або атрибуту розміткою, яка призначена для іншого програмного пакета.

Ці міркування накладають вимоги, щоб конструкції документа мали імена побудовані таким чином, щоб уникнути зіткнень між іменами з різних словників розмітки. У даній специфікації описується механізм простору імен XML, який вирішує це завдання шляхом призначення розширених імен до елементів та атрибутів.

2 Простори імен XML

3 Оголошення Просторів імен

[Визначення: Простір імен (або точніше, обов'язковий простір імен) оголошується за допомогою сімейства зарезервованих атрибутів. Таке ім'я атрибуту повинно бути або xmlns або починатись з xmlns:. Ці атрибути, як будь-які інші атрибути XML, можуть бути представлені безпосередньо або за замовчуванням. ]

Імена атрибутів для оголошення простору імен

Нормалізоване значення атрибуту ПОВИННО бути або посиланням URI — ім'я простору імен яке визначає простір імен — або пустим рядком. Для того щоб ім'я простору імен, слугувало за прямим своїм призначенням, йому СЛІД мати характеристики унікальності та постійності. Це не основна мета, яка буде безпосередньо використовуватися для пошуку схеми (якщо, така схема існує). Uniform Resource Names [RFC2141] це приклад синтаксису, який було розроблено для розуміння вказаних цілей. Однак, слід зазначити що, щоб досягти аналогічних цілей, можна керувати таким самим чином звичайними URL.

[Визначення: Якщо ім'я атрибуту відповідає PrefixedAttName, тоді NCName дає префікс простору імен, який використовується для зв'язування імен елементів та атрибутів, з вказаним в значенні атрибуту ім'ям простору імен в межах елементу, де це оголошення було подано. ]

[Визначення: Якщо ім'я атрибуту відповідає DefaultAttName, тоді ім'я простору імен у значенні атрибуту в області бачення елементу, де це оголошення було подано, стає простором імен за замовчуванням.] Простори імен за замовчуванням та перевизначення оголошень обговорюються у 6 Застосування простору імен до елементів та атрибутів.

Приклад оголошення простору імен, який пов'язує edi (префікс простору імен) із ім'ям простору імен http://ecommerce.example.org/schema:

<x xmlns:edi='http://ecommerce.example.org/schema'>
  <!-- префікс "edi"  пов'язан з http://ecommerce.example.org/schema
       для елемента "x" та його вмісту -->
</x>

Хоча самі вони не зарезервовані, недоцільно використовувати імена префіксів, LocalPart яких починається з літер x, m, l, у будь-яких комбінаціях регістру, оскільки ці імена будуть зарезервовані, якщо використовувати їх без префікса.

4 Повні імена

У документах XML, які відповідають даній специфікації, деякі імена (конструкції, які відповідають нетермінальному Name) ПОВИННІ бути передані як повні імена, визначаються наступним чином:

Повне ім'я

The Prefix визначає з частини повного ім'я префікс простору імен, і ПОВИНЕН бути пов'язаний з посиланням URI простору імен зазначеної в оголошенні простору імен. [Визначення: LocalPart визначає локальну частину повного ім'я.]

Відзначте, що префікс використовується тільки в якості заповнювача для імені простору імен. Програмам СЛІД використовувати ім'я простору імен, а не префікс, при побудові імен, область дії яких виходить за межі первісного документа.

5 Використання повних імен

У документах XML, які відповідають даній специфікації, імена елементів вказані як повні імена, а саме:

Імена елементів

Приклад використання повного ім'я, що виступає в якості імені елементу:

  <!-- Простір імен елементу 'price' є http://ecommerce.example.org/schema -->
  <edi:price xmlns:edi='http://ecommerce.example.org/schema' units='Euro'>32.18</edi:price>

Атрибути або оголошують простір імен, або їх імена зазначені, як повні імена:

Атрибут

Приклад використання повного ім'я, в якості імені атрибута:

<x xmlns:edi='http://ecommerce.example.org/schema'>
  <!-- Простір імен атрибуту 'taxClass' є http://ecommerce.example.org/schema -->
  <lineItem edi:taxClass="exempt">Baby food</lineItem>
</x>

Це обмеження може призвести до операційних труднощів, у разі, де атрибут оголошення простору імен забезпечено, не безпосередньо у об'єкті документу XML, а за допомогою атрибуту за замовчуванням, який було оголошено у зовнішньому об'єкті. Такі оголошення не можуть бути зчитаними програмним забезпеченням, яке ґрунтується на неперевіряючому процесорі XML. Багато програм XML, імовірно, в тому числі чутливих до простору імен, не в стані вимагати перевіряючих процесорів. Якщо вимагається коректна робота з такими програмами, оголошення простору імен ПОВИННО бути забезпечене безпосередньо, або через атрибути за замовчуванням, які оголошені у внутрішній підмножині DTD.

Назви елементів та назви атрибутів також наведені в якості повних імен, коли вони оголошуються у DTD:

Повні Імена у Оголошеннях

Зверніть увагу, що перевірка, яку засновано на DTD, не є простором імен у наступному сенсі: DTD обмежує елементи та атрибути, які можуть з'явитися у документі в якості своїх імен, що не інтерпретуються, а не за парами (назва простору імен, локальне ім'я). Щоб перевірити документ, який використовує простори імен у відношенні до DTD, необхідно, щоб префікси, використані в DTD, були такі ж, як і в документі. Однак, DTD може опосередковано обмежувати простори імен, що використовуються у діючому документі, шляхом надання #FIXED значень для атрибутів, які оголошують простори імен.

6 Застосування просторів імен для елементів та атрибутів

<?xml version="1.0"?>

<html:html xmlns:html='http://www.w3.org/1999/xhtml'>

  <html:head><html:title>Frobnostication</html:title></html:head>
  <html:body><html:p>Moved to 
    <html:a href='http://frob.example.com'>here.</html:a></html:p></html:body>
</html:html>

<?xml version="1.0"?>
<!-- обидва префікса простору імен доступні звідусіль -->
<bk:book xmlns:bk='urn:loc.gov:books'
         xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <bk:title>Cheaper by the Dozen</bk:title>
    <isbn:number>1568491379</isbn:number>
</bk:book>

<?xml version="1.0"?>
<!-- елементи в просторі імен HTML, в цьому випадку за замовчуванням -->
<html xmlns='http://www.w3.org/1999/xhtml'>
  <head><title>Frobnostication</title></head>
  <body><p>Moved to 
    <a href='http://frob.example.com'>here</a>.</p></body>
</html>

<?xml version="1.0"?>
<!-- типи елемента без префікса з простору імен "books" -->
<book xmlns='urn:loc.gov:books'
      xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <title>Cheaper by the Dozen</title>
    <isbn:number>1568491379</isbn:number>
</book>

<?xml version="1.0"?>
<!-- початковим простором імен за замовчуванням, є "books" -->
<book xmlns='urn:loc.gov:books'
      xmlns:isbn='urn:ISBN:0-395-36341-6'>
    <title>Cheaper by the Dozen</title>
    <isbn:number>1568491379</isbn:number>
    <notes>
      <!--  для деяких коментарів, зробимо простір імен HTML, за замовчуванням -->
      <p xmlns='http://www.w3.org/1999/xhtml'>
          This is a <i>funny</i> book!
      </p>
    </notes>
</book>

<?xml version='1.0'?>
<Beers>
  <!-- всередині таблиць, простором імен за замовчуванням використовується HTML -->
  <table xmlns='http://www.w3.org/1999/xhtml'>
   <th><td>Name</td><td>Origin</td><td>Description</td></th>
   <tr> 
     <!-- всередині елементів таблиці, немає простору імен за замовчуванням -->
     <td><brandName xmlns="">Huntsman</brandName></td>
     <td><origin xmlns="">Bath, UK</origin></td>
     <td>
       <details xmlns=""><class>Bitter</class><hop>Fuggles</hop>
         <pro>Wonderful hop, light alcohol, good summer beer</pro>
         <con>Fragile; excessive variance pub to pub</con>
         </details>
        </td>
      </tr>
    </table>
  </Beers>

<!-- http://www.w3.org пов'язано з n1 та n2 -->
<x xmlns:n1="http://www.w3.org" 
   xmlns:n2="http://www.w3.org" >
  <bad a="1"     a="2" />
  <bad n1:a="1"  n2:a="2" />
</x>

<!-- http://www.w3.org пов'язано з n1 та є простором за замовчуванням -->
<x xmlns:n1="http://www.w3.org" 
   xmlns="http://www.w3.org" >
  <good a="1"     b="2" />
  <good a="1"     n1:a="2" />
</x>

7 Відповідність документів

Ця специфікація відноситься до документів XML 1.0. Щоб відповідати даній специфікації, документ ПОВИНЕН бути правильно сформований у відповідності до специфікації XML 1.0 [XML].

У документах XML, які відповідають цій специфікації, імена елементів та атрибутів ПОВИННІ відповідати конструкції для QName та ПОВИННІ задовольняти "Обмеженням простору імен". Щоб відповідати конструкції XML для Name, усі інші лексеми у документі які НЕОБХІДНІ для забезпечення коректності XML 1.0, ПОВИННІ відповідати конструкції цієї специфікації для NCName.

[Визначення: Документ стає коректно-сформованим, по відношенню до простору імен якщо він відповідає даній специфікації. ]

З цього випливає, що в коректно-сформованому, по відношенню до простору імен, документі:

• Усі імена елементів та атрибутів містять у собі одну двокрапку, або не містять її взагалі;

• Імена сутностей, інструкції з обробки цілей або імена позначень, не містять жодної двокрапки.

Окрім того, коректно-сформований документ, по відношенню до простору імен, також може бути дійсним.

[Визначення: коректно-сформований документ, по відношенню до простору імен, буде валідним, якщо він валідний у відповідності до специфікації XML 1.0, та усі лексеми, окрім імен елементів та атрибутів які НЕОБХІДНІ, для забезпечення коректності XML 1.0, відповідають конструкції цієї специфікації для NCName, щоб відповідати конструкції XML для Name. ]

З цього випливає, що у дійсному документі, по відношенню до простору імен:

• Жоден з атрибутів із оголошеним типом ID, IDREF(S), ENTITY(IES), або NOTATION не містить двокрапок.

8 Відповідність процесорів

Для того, щоб відповідати цій специфікації, процесор ПОВИНЕН повідомляти про порушення у коректно-сформованому просторі імен, за винятком, коли немає НЕОБХІДНОСТІ перевіряти, чи є назви просторів імен - посиланнями URI [RFC3986].

[Визначення: Процесор перевірки коректності XML, який відповідає до цієї специфікації, є перевіркою коректності простору імен, якщо він, окрім того, сповіщає про порушення коректності простору імен. ]