Простір імен в XML 1.1 (Друге видання)

1.1 Примітка до позначень та використання

У тих місцях, де зустрічаються ВИДІЛЕНІ, ключові слова ПОВИНЕН, НЕ ПОВИНЕН, НЕОБХІДНО, СЛІД, НЕ СЛІД, ЙМОВІРНЕ у цьому документі повинні тлумачитися, як описано в [Ключові слова].

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

У сценаріях цього документа абревіатура NSC, що означає "Обмеження простору імен" ("Namespace Constraint"), це одне з правил, якому ПОВИННІ слідувати документи відповідні до цієї специфікації.

2.1 Основні поняття

[Визначення: Простір імен XML ідентифікується посиланням IRI [RFC3987]; імена елементів та атрибутів можуть бути поміщені в простір імен XML за допомогою механізмів, описаних в цій специфікації.]

[Визначення: Розширене ім'я це пара, що складається з назви простору імен та локального ім'я.] [Визначення: Для ім'я N в просторі імен визначеному за допомогою IRI як I, Назвою простору імен буде I. Для ім'я N яка не перебуває у просторі імен, назва простору імен буде не визначено.] [Визначення: У кожному з випадків локальним ім'ям буде N.] Саме це поєднання з універсально керованих IRI простору імен з локальними іменами лексики, є ефективним у запобіганні конфліктів імен.

IRI посилання можуть містити символи не допустимі в іменах, і дуже часто занадто довгі, тому розширені імена не використовуються безпосередньо для назви елементів та атрибутів в XML-документах. Замість цього використовуються повні імена. [Визначення: Повне ім'я це ім'я суб'єкта в інтерпретації простора імен.] У документах, що відповідають цій специфікації, імена елементів та атрибутів відображаються як повні імена. Синтаксично, вони являють собою префіксні імена або безпрефіксні імена. Опис синтаксису на підставі атрибутів забезпечує зв'язок префіксів простору імен та зв'язок простору імен за замовчуванням, що застосовується до безпрефіксних імен елементів; ці описи знаходяться в області видимості елементами, на яких вони з'являються, так що різні прив'язки можуть застосовуватися в різних частинах документа. Процесори відповідні даній специфікації, ПОВИННІ розпізнати і діяти на підставі цих описів і префіксів.

2.2 Використання IRI як назви простору імен

Порожній рядок, хоча це й законне посилання IRI, не може бути використаний як ім'я простору імен.

Використання відносних посилань IRI, включаючи посилання того ж документа, в оголошеннях просторів імен, є застарілим.

2.3 Порівняння посилань IRI

IRI посилання, ідентифікуючи простори імен, порівнюють при визначенні, ім'я на приналежність до даного простору імен та, чи відносяться два ім'я до одного й того ж простору імен. [Визначення: Два посилання IRI розглядаються як рядки, і вони вважаються ідентичними тільки в тому випадку, якщо ці рядки ідентичні, тобто, вони мають однакову послідовність символів.] Порівняння відбувається з урахуванням регістру символів, й без виконаного або виконаного %-маскування.

Наслідком цього є те, що IRI посилання, які не є ідентичними в цьому сенсі, можуть бути віднесені до одного і того ж ресурсу. Приклади включають в себе посилання IRI, які відрізняються тільки регістром, %-маскуванням або коли посилання існують в зовнішніх об'єктах, які мають різні базові URI (але майте на увазі, що відносні IRI є застарілими, як назви простору імен).

У декларації простору імен, посилання IRI є нормованим значенням атрибуту, тому заміна символу XML й посилання на об'єкти були вже зроблені раніше, перед всіма порівняннями.

Приклади:

Посилання IRI, подані нижче, всі різні для ідентифікації просторів імен, оскільки вони відрізняються регістром:

• http://www.example.org/wine

• http://www.Example.org/wine

• http://www.example.org/Wine

IRI посилання, представлені нижче, також всі різні для ідентифікації просторів імен:

• http://www.example.org/rosé

• http://www.example.org/ros%c3%a9

• http://www.example.org/ros%c3%A9

• http://www.example.org/ros%C3%a9

• http://www.example.org/ros%C3%A9

Як і цей приклад:

• http://www.example.org/~wilbur

• http://www.example.org/%7ewilbur

• http://www.example.org/%7Ewilbur

Якщо об'єкт з ім'ям eacute був визначений як é, то нижче, при оголошенні просторів імен, початок міток містять обов'язковий префікс p на теж саме посилання IRI, http://example.org/rosé.

• <p:foo xmlns:p="http://example.org/rosé">

• <p:foo xmlns:p="http://example.org/ros&#xe9;">

• <p:foo xmlns:p="http://example.org/ros&#xE9;">

• <p:foo xmlns:p="http://example.org/ros&#233;">

• <p:foo xmlns:p="http://example.org/ros&eacute;">

Через ризик плутанини між IRI, які будуть еквівалентні при разіменуванні, використання %-маскованих символів в іменах простору імен настійно не рекомендується.

6.1 Область дій простору імен

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

Така декларація простору імен поширюється на всі імена елементів та атрибутів у своїй області дій, чиї префікси відповідають тому, який зазначений у декларації.

Розширене ім'я яке відповідає префіксному елементу або імені атрибута має посилання IRI, в якій префікс пов'язан, як його назва простору імен, а локальна частина, як його локальне ім'я.

<?xml version="1.1"?>

<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.1"?>
<!-- обидва префікса простору імен доступні звідусіль -->
<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.1"?>
<x xmlns:n1="http://www.w3.org">
    <n1:a/>               <!-- вірно, префікс n1 пов'язаний з http://www.w3.org -->
    <x xmlns:n1="">
        <n1:a/>           <!-- невірно, префікс n1, тут, ні з чим не пов'язаний -->
	<x xmlns:n1="http://www.w3.org">
            <n1:a/>       <!-- вірно, префікс n1 знову визначений -->
        </x>
    </x>
</x>

6.2 Простір імен за замовчуванням

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

Декларація простору імен за замовчуванням відноситься до всіх імен елементів без префікса в межах своєї області. Декларації просторів імен за замовчуванням не відносяться безпосередньо до імен атрибутів; інтерпретації атрибутів без префікса визначаються елементом, в якому вони виникають.

Якщо існує декларація простору імен за замовчуванням в області дій, тоді розширене ім'я, відповідного імені елемента без префікса, має IRI з простору імен за замовчуванням як назви простору імен. Якщо не існує декларації простору імен за замовчуванням в області дій, в такому випадку, значення для назви простору імен буде відсутній. Значення назви простору імен для назви атрибута без префікса, завжди буде відсутнє. У всіх випадках, локальне ім'я це локальна частина області (яке, звичайно ж, як і саме ім'я без префікса).

<?xml version="1.1"?>
<!-- елементи в просторі імен 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.1"?>
<!-- типи елемента без префікса з простору імен "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.1"?>
<!-- початковим простором імен за замовчуванням, є "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.1'?>
<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>

6.3 Унікальність атрибутів

У документах XML відповідних до даної специфікації, немає тега, що містить два атрибути, які:

1. мають однакові імена, або

2. мають повні імена з однаковою локальною частиною та з префіксами пов'язаними с іменами простору імен, які ідентичні.

Це обмеження рівнозначно тому, що немає елемента який має два атрибути з однаковим розширеним ім'ям.

Наприклад, кожен з bad тегів порожнього елементу невірний, в наступних тегах:

<!-- 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>