Пространство имен XML является набором имен, обозначаемых с помощью ссылки URI, используемых в документах XML в качестве типов элементов и имен атрибутов.
Атрибут xmlns используется со следующим синтаксисом:
xmlns:префикс=пространство_имен
где пространство_имен является уникальным URI (например, www.ibm.com) и префикс представляет пространство имен и задает указатель на него.
В следующем определении элемента заказчика задается соответствующее пространство имен для различия тега элемента от тегов, появляющихся в записях заказчиков, созданных другими бизнес-приложениями.
<acct:customer xmlns:acct="http://www.my.com/acct-REV10"> <acct:name>Corporation</acct:name> <acct:order acct:ref="5566"/> <acct:status>invoice</acct:status> </acct:customer>
Определение пространства имен в первой строке присваивает префиксу пространство имен http://www.my.com/acct-REV10. Префикс используется для имен элементов, таких как name, для прикрепления их к пространству имен. Например, второе приложение - система выполнения, может присвоить к своим элементам заказчиков другие пространства имен:
<ful:customer xmlns:ful="http://www.your.com/ful"> <ful:name>Corporation</ful:name> <ful:order ful:ref="A98756"/> <ful:status>shipped</ful:status> </ful:customer>
Обрабатывающее оба типа данных приложение теперь сможет работать с данными учета и выполнения по отдельности. Существует пространство имен по умолчанию. Оно задается если локальное имя в определении пространства имен не присвоено:
<acct:customer xmlns="http://www.my.com/acct-REV10" xmlns:acct="http://www.my.com/acct-REV10 "> <name>Corporation</name> <order acct:ref="5566"/> <status>invoice</status> </customer>
В этом примере все теги в записи заказчика уточнены пространством имен http://www.my.com/acct-REV10. Явно задавать префикс нет необходимости, так как используется пространство имен оп умолчанию. Обратите внимание, что пространство имен по умолчанию применяется ко всем определениям атрибутов.
В следующей схеме XML пространство имен по умолчанию определено как стандартное пространство имен схемы XML http://www.w3.org/2001/XMLSchem. Существует также специфическое пространство имен http://www.ibm.com.
<?xml version="1.0"?> <schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.ibm.com" xmlns:TestSchema="http://www.ibm.com"> <simpleType name="ZipCodeType"> <restriction base="integer"> <minInclusive value="10000"/> <maxInclusive value="99999"/> </restriction> </simpleType> <!--element definitions skipped --> </schema>
Предположим, что предыдущая схема XML сохранена в C:\temp\TestSchema.xsd, примером файла XML, допустимым для схемы, является:
<?xml version="1.0"?>
<x:addressList xmlns:x="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com file:///C:/temp/TestSchema.xsd">
xsi:schemaLocation="http://www.ibm.com file:///C:/temp/TestSchema.xsd">
<x:address>
<x:street>x:Vangerowstrasse</x:street>
<x:zipCode>69115</x:zipCode>
<x:city>x:Heidelberg</x:city>
</x:address>
<x:address>
<x:street>x:Bernal Road</x:street>
<x:zipCode>90375</x:zipCode>
<x:city>x:San Jose</x:city>
</x:address>
</x:addressList>
Целевое пространство имен служит для идентификации пространства имен при наличии связи между элементом и ее именем. При объявлении эта связь определяет пространство имен элементов в файлах XML, соответствующих схеме. Файл XML, импортирующий схему, должен ссылаться на ее целевое пространство имен в атрибуте schemaLocation. Любые несовпадения между целевым и фактическим пространством имен элемента отображаются в виде ошибок проверки схемы. В нашем примере целевым пространством имен является http://www.ibm.com; оно задается в файле схемы XML и указывается дважды в файле XML. Несовпадения между этими тремя элементами пространства имен ведут к возникновению ошибок проверки.
В следующем примере показаны принципы работы префиксов пространств имен и целевых пространств имен в схемах XML и документах их соответствующих элементов XML.
Схема XML:
<?xml version="1.0"?> <schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.ibm.com" xmlns:x="http://www.ibm.com"> <complexType name="AddressType"> <sequence> <element name="name" type="string"></element> </sequence> </complexType> <element name="MyAddress" type="x:AddressType"></element> </schema>
Допустимый документ экземпляра XML, созданный из этой схемы, может выглядеть следующим образом. Локальные элементы и атрибуты являются простыми.
<?xml version="1.0"?> <x:MyAddress xmlns:x="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com x.xsd "> <name>Peter Smith</name> </x:MyAddress>
Когда локальные элементы (такие как элемент "name") и атрибуты не уточнены в файле XML, тогда уточнен только корневой элемент. Таким образом, в этом примере префикс пространства имен "x" присвоен корневому элементу "MyAddress", связывая его с пространством имен "http://www.ibm.com", но префикс "x" не присвоен локальному элементу "name".
<?xml version="1.0"?> <schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.ibm.com" xmlns:x="http://www.ibm.com" elementFormDefault="qualified"> <complexType name="AddressType"> <sequence> <element name="name" type="string"></element> </sequence> </complexType> <element name="MyAddress" type="x:AddressType"></element> </schema>
Допустимый документ экземпляра XML, созданный из этой схемы, может выглядеть следующим образом. Локальные элементы и атрибуты уточнены, потому что атрибут elementFormDefault установлен в схеме XML.
<?xml version="1.0"?> <x:MyAddress xmlns:x="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com x.xsd "> <x:name>Peter Smith</x:name> </x:MyAddress>
В данном примере префикс "x" пространства имен присвоен корневому элементу "MyAddress" и локальному элементу "name", связанному с пространством имен "http://www.ibm.com".
Эта схема XML добавляет данный атрибут:
xmlns:xsd="http://www.w3.org/2001/XMLSchemaЭто означает, что каждая из конструкций языка схемы XML требует уточнения с помощью префикса "xsd". Например, xsd:complexType и xsd:string
. Заметьте, что для объявления и использования можно выбрать любые другие префиксы, например, "xs" или "foobar".
Этот префикс можно указать на странице параметров схемы XML. Дополнительные сведения приведены в описании связанных задач.
Все определенные пользователем типы принадлежат к пространству имен http://www.ibm.com, как определено атрибутом targetNamespace, и имеют префикс "x", как определено атрибутом xmlns:x.
<?xml version="1.0"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.ibm.com" xmlns:x="http://www.ibm.com"> <xsd:complexType name="AddressType"> <xsd:sequence> <xsd:element name="name" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:element name="MyAddress" type="x:AddressType"></xsd:element> </xsd:schema>
Допустимый документ экземпляра XML, созданный из этой схемы, может выглядеть следующим образом. Локальные элементы и атрибуты являются простыми. Семантика спецификации аналогична описанной в примере 1.
<?xml version="1.0"?> <x:MyAddress xmlns:x="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://www.ibm.com x.xsd "> <name>Peter Smith</name> </x:MyAddress>
Эта схема XML не имеет собственного целевого пространства. В этом случае настоятельно рекомендуется явно уточнять все конструкции схемы XML префиксом, таким как "xsd". Ссылки на определения и объявления из этой схемы, такие как AddressType, не уточнены пространством имен, так как не существует префикса пространства имен.
<?xml version="1.0"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <xsd:complexType name="AddressType"> <xsd:sequence> <xsd:element name="name" type="xsd:string"></xsd:element> <xsd:element name="name" type="xsd:string"></xsd:element> <xsd:element name="name" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:element name="MyAddress" type="AddressType"></xsd:element> </xsd:schema>
Допустимый документ экземпляра XML, созданный из этой схемы, может выглядеть следующим образом. Все элементы не уточнены.
<?xml version="1.0"?> <MyAddress xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="x.xsd"> <name>name</name> </MyAddress>
Это схема XML, с пространством имен по умолчанию, использующимся в качестве целевого. Здесь пространство имен также указывается без префикса.
<?xml version="1.0"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.ibm.com" xmlns="http://www.ibm.com"> <xsd:complexType name="AddressType"> <xsd:sequence> <xsd:element name="name" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:element name="MyAddress" type="AddressType"></xsd:element> </xsd:schema>
Допустимый документ экземпляра XML, созданный из этой схемы, может выглядеть следующим образом:
<?xml version="1.0" encoding="UTF-8"?> <MyAddress xmlns="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com NewXMLSchema.xsd"> <name>name</name> </MyAddress>