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.
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.
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å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.
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".
<?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".
Dette XML-skema tilføjer følgende attribut:
xmlns:xsd="http://www.w3.org/2001/XMLSchemaDet 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>
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>
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>