mozilla

Revision 108504 of Namespaces

  • Revision slug: Namespaces
  • Revision title: Namespaces
  • Revision id: 108504
  • Created:
  • Creator: ericjung
  • Is current revision? No
  • Comment migration from http://kb.mozillazine.org/index.php?title=XML_namespaces&action=edit&oldid=15596

Revision Content

XML namespaces provide a way to distinguish duplicate element and attribute names. Duplicates element and attribute names can occur when an XML document contains elements and attributes from two or more different XML schemas (or DTDs). To quote Wikipedia: "In general, a namespace is an abstract container providing context for the items ... it holds and allows disambiguation of items having the same name."

If you are familiar with C++ namespaces, Java packages, perl packages, or Python module importing, you are already familiar with the namespace concept.

An XML namespace is identified by an unique name (called a URI, not a URL, even though it can look like a URL). An URI is any string, although most people choose a URL-based URI because URLs are an easy way to hope for uniqueness. Although there's nothing preventing someone else from using the namespace http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul, it's fairly unlikely anyone would choose that accidentally. Even if they did accidentally choose it, they may not define the same elements as XUL anyway (e.g., <textbox/>) in their schema/DTD.

Any element type or attribute name in an XML namespace can be uniquely identified by its XML namespace and its "local name". Together, these two items define a qualified name, or QName.

For example, <xul:textbox/> uses a namespace named "xul" and a local name "textbox". This distinguishes it from, for example, <foobar:textbox/> which might occur in the same document. The xul and foobar namespaces must be defined at the top of the XML document in which they are used, like so:

 <foobar:some-element 
     xmlns:xul="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
     xmlns:ihoss="the-foobar-namespace">
   <xul:textbox id="foo" value="bar"/>
   <foobar:textbox favorite-food="pancakes"/>
 </foobar:some-element>

Notice I've mixed two <textboxes/> in the same document. The only way to distinguish that they have different meanings is with namespaces.

There's only one other thing to know: "default namespace". Every XML document can have one "default namespace", and this is used with XUL documents all the time. In XUL documents, you'll usually see this:

 <window
     id="foo"
     '''xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"'''>
   ...
   ...
 </window>

and in XHTML documents, you'll see this:

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

There is a very subtle difference here than before. Before I wrote xmlns:xul="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" but here the :xul piece is omitted. This signifies to the XML parser that http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul is the default namespace for the document, and that any element or attribute without a namespace (i.e., no prefix and colon) belongs to the default namespace. That's why we can write the shorthand <textbox/> instead of <xul:textbox/> all the time (although the latter is just as correct when not using http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul as the default namespace). So, in other words, a default namespace permits a kind of short-hand to be used throughout the document.

Revision Source

<p>
</p><p><b>XML namespaces</b> provide a way to distinguish duplicate element and attribute names. Duplicates element and attribute names can occur when an XML document contains elements and attributes from two or more different XML schemas (or DTDs). To quote <a class="external" href="http://en.wikipedia.org/wiki/Namespace">Wikipedia</a>: "In general, a namespace is an abstract container providing context for the items ... it holds and allows disambiguation of items having the same name."
</p><p>If you are familiar with C++ namespaces, Java packages, perl packages, or Python module importing, you are already familiar with the namespace concept.
</p><p>An XML namespace is identified by an unique name (called a URI, not a URL, even though it can look like a URL). An URI is any string, although most people choose a URL-based URI because URLs are an easy way to <i>hope</i> for uniqueness. Although there's nothing preventing someone else from using the namespace <code>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</code>, it's fairly unlikely anyone would choose that accidentally. Even if they did accidentally choose it, they may not define the same elements as XUL anyway (e.g., <code>&lt;textbox/&gt;</code>) in their schema/DTD.
</p><p>Any element type or attribute name in an XML namespace can be uniquely identified by its XML namespace and its "local name". Together, these two items define a <i>qualified name</i>, or <a class="external" href="http://www.w3.org/TR/REC-xml-names/#dt-qualname">QName</a>.
</p><p>For example, <code>&lt;xul:textbox/&gt;</code> uses a namespace named "xul" and a local name "textbox". This distinguishes it from, for example, <code>&lt;foobar:textbox/&gt;</code> which might occur in the same document. The <b>xul</b> and <b>foobar</b> namespaces must be defined at the top of the XML document in which they are used, like so:
</p>
<pre> &lt;foobar:some-element 
     xmlns:xul="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
     xmlns:ihoss="the-foobar-namespace"&gt;
   &lt;xul:textbox id="foo" value="bar"/&gt;
   &lt;foobar:textbox favorite-food="pancakes"/&gt;
 &lt;/foobar:some-element&gt;
</pre>
<p>Notice I've mixed two <code>&lt;textboxes/&gt;</code> in the same document. The only way to distinguish that they have different meanings is with namespaces.
</p><p>There's only one other thing to know: "default namespace". Every XML document can have one "default namespace", and this is used with XUL documents all the time. In XUL documents, you'll usually see this: 
</p>
<pre> &lt;window
     id="foo"
     '''xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"'''&gt;
   ...
   ...
 &lt;/window&gt;
</pre>
<p>and in XHTML documents, you'll see this:
</p>
<pre> &lt;html '''xmlns="http://www.w3.org/1999/xhtml"'''&gt;
   ...
   ...
 &lt;/html&gt;
</pre>
<p>There is a very subtle difference here than before. Before I wrote <code>xmlns<b>:xul</b>="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"</code> but here the <b>:xul</b> piece is omitted. This signifies to the XML parser that <code>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</code> is the <b>default namespace</b> for the document, and that any element or attribute without a namespace (i.e., no prefix and colon) belongs to the default namespace. That's why we can write the shorthand <code>&lt;textbox/&gt;</code> instead of <code>&lt;xul:textbox/&gt;</code> all the time (although the latter is just as correct when not using <code>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</code> as the default namespace). So, in other words, a default namespace permits a kind of short-hand to be used throughout the document.
</p>
Revert to this revision