XML-navneområder

Et XML-navneområde er en samling af navne, som er identificeret ved en URI-reference, og som bruges i XML-dokumenter som elementtyper og attributnavne.

XML-navneområder er defineret af en W3C-anbefaling fra 16. august 2006 ved navn Namespaces in XML (Navneområder i XML). XML-kodenavne skal være globale entydige og af performance-årsager helst også korte. For at løse denne konflikt definerer W3C-navneområdeanbefalingen attributten xmlns, som kan ændre et hvilket som helst XML-element. Hvis det findes i et element, identificerer det navneområdet for dette element.

xmlns-attributten har følgende syntaks:

xmlns:præfiks=navneområde

hvor navneområde er en entydig URI (f.eks. www.ibm.com), og hvorpræfiks repræsenterer navneområdet og angiver en pointer til det.

I den følgende kundeelementdefinition,defineres et kontonavneområde for at kunne skelne elementkoderne fra dem, der vises i kunderecords, der er oprettet af andre virksomhedsprogrammer.

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

Definitionen af navneområdet i første linje tildeler navneområdet http://www.my.com/acct-REV10 til præfikset. Præfikset bruges til elementnavne for at tilknytte dem til navneområdet. Et andet program, f.eks. et leveringssystem, kan tildele sine kundeelementer et andet navneområde:

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

Et program, som behandler begge datastrukturer, vil nu være i stand til at behandle data fra de to programmer forskelligt. Der er et standardnavneområde. Det angives, hvis der ikke er tildelt et lokalt navn i navneområdedefinitionen:

<acct:kunde xmlns="http://www.my.com/acct-REV10" xmlns:acct="http://www.my.com/acct-REV10 ">
<navn>Virksomhed</name>
<ordre acct:ref="5566"/>
<status>faktura</status>
</kunde>

I dette eksempel er alle koder i kundejournalen kvalificeret til at være placeret i navneområdet http://www.my.com/acct-REV10. Der kræves intet explicit præfiks, fordi standardnavneområdet anvendes. Bemærk, at standardnavneområdet gælder for alle attributdefinitioner.

XML-skemaer og navneområder

I følgende XML-skema er standardnavneområdet for skemaet defineret som standardnavneområdet for XML-skemaer: http://www.w3.org/2001/XMLSchema. Der er også et skemaspecifikt navneområde: 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>
 <!--elementdefinitioner oversprunget -->
</schema>  

Hvis det foregående XML-skema gemmes somC:\temp\TestSchema.xsd, er følgende et eksempel på en XML-fil, som valideres i forhold til skemaet:

<?xml version="1.0"?>
<x:adresseListe xmlns:x="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:schemaLocation="http://www.ibm.com file:///C:/temp/TestSskema.xsd">
 xsi:schemaLocation="http://www.ibm.com file:///C:/temp/TestSkema.xsd">
<x:adresse>
 <x:gade>x:Vangerupgade</x:gade>
  <x:zipCode>69115</x:zipCode>
 <x:city>x:Tystrup</x:city>
 </x:adresse>
    <x:adresse>
<x:gade>x:Bygade</x:gade>
<x:zipCode>9998</x:zipCode>
     <x:by>x:Hankilstrup</x:city>
 </x:adresse>
</x:adresseListe> 

Målnavneområde

Målnavneområdet identificerer det navneområde, hvor tilknytningen mellem elementet og dets navn findes. I tilfælde af erklæringer afgør denne tilknytning navneområdet for de elementer i XML-filer, som passer til skemaet. En XML-fil, som importerer et skema, skal henvise til sit målnavneområdet i attributten schemaLocation. Eventuelle uoverensstemmelser mellem målet og de faktiske navneområde for et element rapporteres som skemavalideringsfejl. I vores eksempel er målnavneområdet http://www.ibm.com. Det defineres i XML-skemafilen og henvises til to gange i XML-filen. Eventuelle uoverensstemmelser mellem disse tre forekomster af navneområdet medfører valideringsfejl.

Følgende eksempler viser, hvordan målnavneområder og præfiks for navneområder fungerer i XML-skemaer og deres tilhørende XML-forekomstdokumenter.

Eksempel 1 - Et skema med både standard- og målnavneområde og ikke-kvalificerede lokale elementer

XML-skema:

<?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="AdresseType">
<sequence>
<element name="navn" type="string"></element>
</sequence>
</complexType>
<element name="MinAddresse" type="x:AdresseType"></element>
</schema> 

Et gyldigt XML-forekomstdokument oprettet fra dette skema ser sådan ud. Lokale elementer og attributter er ukvalificerede.

<?xml version="1.0"?>
<x:MinAdresse xmlns:x="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com x.xsd ">
<navn>Peter Jensen</navn>
</x:MinAdresse> 

Når lokale elementer (såsom elementet "name") og attributter er ukvalificerede i en XML-fil, er kun rodelementet kvalificeret. I dette eksempel er navneområdepræfikset "x" således tildelt til rodelementet "MyAddress", hvorved det tilknyttes til navneområdet "http://www.ibm.com", men præfikset "x" er ikke tildelt til det lokale element "name".

Eksempel 2 - Et skema med både standard- og målnavneområde og kvalificerede lokale elementer

<?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="AdresseType">
<sequence>
<element name="navn" type="string"></element>
</sequence>
</complexType>
<element name="MinAdresse" type="x:AdresseType"></element>
 </schema>  

Et gyldigt XML-forekomstdokument oprettet fra dette skema ser sådan ud. Lokale elementer og attributter er kvalificerede. Det skyldes, at attributten elementFormDefault er angivet til "qualified" i XML-skemaet.

<?xml version="1.0"?>
  <x:MinAdresse xmlns:x="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.ibm.com x.xsd ">
<x:navn>Peter Jensen</x:navn>
 </x:Min Adresse>

I dette eksempel er navneområdepræfikset "x" tildelt til både rodelementet "MyAddress" og det lokale element "name" og tilknytter dem til navneområdet "http://www.ibm.com".

Eksempel 3 - Skema med målnavneområde og eksplicit definition af xmlns:xsd

Dette XML-skema tilføjer følgende attribut:

xmlns:xsd="http://www.w3.org/2001/XMLSchema

Det betyder, at hver af de konstruktioner, som er defineret af XML-skemasproget, skal kvalificeres med præfikset "xsd". Eksempel: xsd:complexType og xsd:string

. Bemærk, at du kan vælge et hvilket som helst andet præfiks, f.eks. "xs" eller "foobar", i erklæringen og brugen.

Du kan angive dette præfiks på siden med indstillinger for XML-skemaet. Der er flere oplysninger under de relaterede opgaver.

Alle brugerdefinerede typer tilhører navneområdet http://www.ibm.com, som det er defineret af attributten targetNamespace, og præfikset er "x" som defineret af attributten 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>

Et gyldigt XML-forekomstdokument oprettet fra dette skema ser sådan ud. Lokale elementer og attributter er ukvalificerede. Semantikken for kvalifikationer den samme som i Eksempel 1.

<?xml version="1.0"?>
 <x:MinAddresse 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 Jensen</name>
 </x:MinAdresse>

Eksempel 4 - Skema med ikke-erklæret målnavneområde, som eksplicit definerer xmlns:xsd

Dette XML-skema har ikke selv noget målnavneområde. I dette tilfælde anbefales det kraftigt at kvalificere alle XML-skemakonstruktioner eksplicit med et præfiks som f.eks. "xsd". Der refereres til definitionerne og erklæringerne fra dette skema, f.eks. AddressType, uden navneområdekvalificering, da der ikke er noget navneområdepræfiks.

<?xml version="1.0"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:complexType name="AdresseType">
<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="MinAdresse" type="AdresseType"></xsd:element>
</xsd:schema> 

Et gyldigt XML-forekomstdokument oprettet fra dette skema ser sådan ud. Alle elementer er ukvalificerede.

<?xml version="1.0"?>
<MinAdresse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="x.xsd">
<navn>navn</navn>
</MinAdresse>

Eksempel 5 - Et skema, hvor målnavneområdet er standardnavneområdet

Dette er et XML-skema, hvor målnavneområdet er standardnavneområdet. Navneområdet har heller ikke noget navneområdepræfiks.

<?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="AdresseType">
<xsd:sequence>
<xsd:element name="navn" type="xsd:string"></xsd:element>
</xsd:sequence>
</xsd:complexType>
 <xsd:element name="MinAdresse" type="AdresseType"></xsd:element>
 </xsd:schema> 

Et gyldigt XML-forekomstdokument oprettet fra dette skema ser sådan ud:

<?xml version="1.0" encoding="UTF-8"?>
<MinAdresse xmlns="http://www.ibm.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com NewXMLSchema.xsd">
<navn>navn</navn>
 </MinAdresse>  
Relaterede opgaver
Redigér indstillinger for XML-skemafil