XML namespace

The educational technology and digital learning wiki
Jump to navigation Jump to search

Definition

    1. Introduction

              1. Why namespaces ?

  1. Various XML vocabularies (languages/applications) can be mixed.

  1. But then we can run into naming conflicts, i.e. different vocabularies (DTDs) can use the same names for elements !
  2. Namespaces allow to fully/uniquely qualify XML element and attribute names to prevent from confusing two elements that have the same name but mean different things.

  1. Since DTDs are not mandatory for most W3C languages, the W3C requires namespace definitions within root elements, e.g. XHTML must have one:

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

Standards


  1. Namespaces are a W3C standard since Jan 1999
  2. that means that namespaces have been introduced after XML has been invented)

----

  1. http://www.w3.org/TR/REC-xml-names/


  1. Namespaces are identified with URIs (see " " [7] for details)

----

  1. http://www.rfc-editor.org/rfc/rfc3986.txt


  1. A URI is either a URL or a URN (http://www.rfc-editor.org/rfc/rfc2141.txt)
  2. Compound W3C documents

----

  1. http://www.w3.org/2004/CDF/


              1. Why XML namespaces - ambiguity of an element name

First XML fragment using title within a bibliography element:

<book>

<title>A true story</title>

<description>A real cool publication</description>

</book>

2nd XML fragment using title in a employees record:

<record>

<name>Miller</name> <title>Dr. </title>

<publications> ... </publications>

</record>

If these two XML fragments were added together, there would be a name conflict because both contain a <title> element with different meaning. But we can solve this like this:

<employees:record>

<employees:name>Miller</employees:name>

<employees:title>Dr. </employees:title>

<employees:publications>

<biblio:book>

<biblio:title>A true story</biblio:title>

<biblio:description>A real cool publication</biblio:description>

</biblio:book>

</employees:publications>

</employees:record>



Declaring namespaces


  1. Formally speaking, an XML namespace is simply a collection of names (elements and attributes) of a markup vocabulary that can be uniquely identified

Procedure:


  1. Create or identify a namespace identifier you wish to use:
    An XML namespace is identified by a unique URI reference, usually a URL

  1. The URL need not point to anything on the Internet. It is just used as a unique string, i.e. a name !
  2. However, most namespace identifiers actually point to a real web page that either provides an explanation or at least informations about the organization. This means that if you plan to create your own namespaces, you should use the name of any webpage over which you have control.

  1. Make a namespace declaration within the element that belongs to this namespace, i.e.
    map a prefix of your choice to a unique URI.

There are two major declaration variants (see examples on the next slides ....)

(1) declaring a namespace that will require insertion of prefixes


  1. <prefix:element xmlns:prefix="URI">

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

(2) declaring a default namespace (element + children belong to this namespace by default)

  1. <element xmlns="URI"> ....

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



Scoping


  1. "Scoping" here means "where does a declaration apply ?"
  2. The scope of an XML namespace declaration extends from the beginning of the start-tag in which it appears to the end of the corresponding end-tag, including all children
  3. Most frequently, namespaces are declared in the document root.

XHMTL fragment

<?xml version="1.0"?>

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

Example with 2 namespaces (both use URNs instead of URLs)

<?xml version="1.0"?>

<!-- both namespace prefixes are available throughout -->

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



Default namespaces


  1. If most elements in an XML document belonged to the same namespace, it would be ugly to prefix each element name.
  2. Instead define a default namespace that applies to all non-prefixed elements and attributes.

  1. <element xmlns="URI"> ....

  1. The default namespace applies to the element on which it was defined and all descendants of that element.
  2. But if a descendants has another default namespace defined on it, this new namespace definition overrides the previous one and becomes the default for that element and its descendants.
  3. Default the namespaces does not apply to attribute names ! This is a likely source of trouble for XSLT ...

              1. XHTML default namespace (typical XHTML file)

<?xml version="1.0"?>

<!-- elements are in the HTML namespace by default -->

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

              1. Default namespace for a book vocabulary plus a namespace for ISBN

<?xml version="1.0"?>

<!-- unprefixed element types are from "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>

              1. A larger example of namespace scoping

  1. It includes some XHTML whose namespace is declared within the "p" element

<?xml version="1.0"?>

<!-- initially, the default namespace is "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>

<!-- make HTML the default namespace for some commentary -->

<p xmlns=’http://www.w3.org/1999/xhtml’'''>

This is a <i>funny</i> book!

</p>

</notes>

</book>


              1. XSLT namespace

  1. XSLT instructions are prefixed with "xsl" here
  2. Output is namespace-less here (see the XSLT module for explanations ...)

<?xml version="1.0"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="page">

.....

<html> <head> <title> <xsl:value-of select="title"/> </title> </head>

<body bgcolor=" ffffff"> <xsl:apply-templates/> </body>

</html>

</xsl:template>

<xsl:template match="title">

<h1 align="center"> <xsl:apply-templates/> </h1>

</xsl:template>

<xsl:template match="content">

<p align="center"> <xsl:apply-templates/> </p>

</xsl:template>

<xsl:template match="comment">

<hr /> <xsl:apply-templates/>

</xsl:template>

</xsl:stylesheet>



Validation of composite documents


  1. Validating documents that contain different namespaces are called composite or compound documents and validation is not always easy since combined DTDs may not exist
  2. A validation standard for composite W3C vocabularies is currently under preparation ...
  3. Usually, combined documents are produced by server-side programs for delivery and they are just well-formed (not attached to DTDs or other schemas)
  4. You may write DTDs that validate compound documents.

              1. A DTD rule with an extra namespace

  1. In this example, the "a" element and the "description" attribute belongs to the default namespace, but the href and type attributes belong to the xlink namespace
  2. We declare the namespace in the root element, but also could have done it just for the "el" element...

The DTD (file link_list.dtd) - XML is on next slide ...

<!ELEMENT link_list (el+)>

<!ATTLIST link_list xmlns:xlink CDATA FIXED "http://www.w3.org/1999/xlink">

<!ELEMENT el ( PCDATA)>

<!ATTLIST el

description CDATA IMPLIED

xlink:href CDATA REQUIRED

xlink:type CDATA FIXED "simple"

>

An XML Example file (file link_list.xml)

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE link_list SYSTEM "link_list.dtd">

<?xml-stylesheet href="link_list.css" type="text/css" ?>

<link_list xmlns:xlink="http://www.w3.org/1999/xlink">

<el description="verified"

xlink:type="simple"

xlink:href="http://www.webster.ch/">Webster Geneva</el>

<el xlink:href="http://www.webster.edu/"

xlink:type="simple">Webster</el>

</link_list>

  1. Note: This file will not display clickable links in IE (since IE does not implement XLinks)
  2. See " " [24] for a workaround using XHTML tags

    1. Client-side XML languages and namespaces overview

  1. The W3C defines several Internet languages and for which namespace declarations are mandatory (even if you use them "standalone", i.e. not in composite documents)
  2. XSLT and XML Schema will be introduced at introductory level in a later module

Some W3C languages

Name Namespace URL Explanation
XSLT http://www.w3.org/1999/XSL/Transform XSL - Transformations
XSL-FO http://www.w3.org/1999/XSL/Format XSL - Formatting
XML Schema http://www.w3.org/2001/XMLSchema  
SVG http://www.w3.org/2000/svg Scalable Vector Graphics
RDF http://www.w3.org/1999/02/22-rdf-syntax-ns Resource Description Format
SMIL 2.0 http://www.w3.org/2001/SMIL20/ Synchronized Multimedia Integration Lang.
VoiceXML 2.0 http://www.w3.org/2001/vxml Synthesized voice
XLink xmlns:xlink="http://www.w3.org/1999/xlink" XML Linking Language
XForms http://www.w3.org/2002/xforms Next generation of HTML forms.
XHTML http://www.w3.org/1999/xhtml  
MathML http://www.w3.org/1998/Math/MathML Mathematical markup language


  1. Some of these languages (e.g. SMIL, MathML, SVG, X3D) need special clients for display
  2. Some of these languages are transducers or helpers, i.e. are used to define, style, transform and process XML contents


Compound documents


  1. Combining various content delivery formats is the future (also on cell phones !)
  2. For example, XHTML-formatted content can be augmented by SVG objects or mathematical formula.
  3. Examples of possible Compound Document profiles:
  4. XHTML + SVG + MathML
  5. XHTML + SMIL
  6. XHTML + XForms
  7. XHTML + VoiceML
  8. The W3C is working on a generic Compound Document by Reference Framework (CDRF) that defines a language-independent processing model for combining arbitrary document formats ...

Web browser caveats:

  1. IE doesn’t support natively most of these languages, Firefox supports more but not all.
  2. Workaround:
  3. Use a browser that is more advanced (e.g. Firefox) or specialized players (e.g. Realplayer for SMIL)
  4. Install plugins for your web browser and use a more indirect method to assemble contents, i.e. <object> or <iframe> This will work with most browsers if you have the right plugin (SVG in this case) installed.

<iframe src="hello-svg.svg" height="300" width="80%" frameborder="0">

... Sorry you need an SVG plugin ...

</iframe>



MathML example


              1. XHMTL + MathML (file xhtml_mathml.xml)

  1. XHTML is declared in the root since the document is XHTML
  2. MathML is declared when we use it (could have been declared in the root too)

<?xml version="1.0" encoding="iso-8859-1"?>

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

<xhtml:body>

<xhtml:h1>A Compound Document</xhtml:h1>

<xhtml:p>A simple formula using MathML in XHTML.</xhtml:p>

<mathml:math xmlns:mathml="http://www.w3.org/1998/Math/MathML">

<mathml:mrow>

<mathml:msqrt>

<mathml:mn>49</mathml:mn>

</mathml:msqrt>

<mathml:mo>=</mathml:mo>

<mathml:mn>7</mathml:mn>

</mathml:mrow>

</mathml:math>

</xhtml:body>

</xhtml:html>

  1. Warning: Does not work with IE 6/7, but there are workarounds:
  2. use the W3C MathML stylesheet that also will install an appropriate IE plugin (see ex. [-18])
  3. use e.g. Firefox or Amaya
  4. or install a MathML plugin for IE and include MathML contents with an iframe or similar construct

              1. XHMTL + MathML (file xhtml_mathml2.xml)

  1. In the previous example, one also could have declared xhtml as default namespace and overide the default namespace just for the mathml "section". The result is the same

<?xml version="1.0" encoding="iso-8859-1"?>

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

<body>

<h1>A Compound Document</h1>

<p>A simple formula using MathML in XHTML.</p>

<mathml:math xmlns:mathml="http://www.w3.org/1998/Math/MathML">

<mathml:mrow>

<mathml:msqrt>

<mathml:mn>49</mathml:mn>

</mathml:msqrt>

<mathml:mo>=</mathml:mo>

<mathml:mn>7</mathml:mn>

</mathml:mrow>

</mathml:math>

</body>

</html>


              1. XHMTL + MathML + XSLT for IE (file xhtml_mathml_IE.xml)

<?xml version="1.0"?>

<?xml-stylesheet type="text/xsl" href="pmathml.xsl"?>

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

xmlns:pref="http://www.w3.org/2002/Math/preference"

pref:renderer="css">

<head> <title>MATHML with an XSLT trick for IE</title> </head>

<body><h1>MATHML with an XSLT trick for IE</h1>

<p>Below is an equation with a radical:</p>

<math xmlns="http://www.w3.org/1998/Math/MathML">

<msup>

<msqrt>

<mrow>

<mi>a</mi>

<mo>+</mo>

<mi>b</mi>

</mrow>

</msqrt>

<mn>27</mn>

</msup>

</math>

</body></html>


  1. To make this work, you need to copy the mathml.xsl, pmathml.xsl, ctop.xsl and pmathmlcss.xsl files in the same directory

----

  1. 'http://www.w3.org/Math/XSL/ '(consult for further details)


Xlink example


  1. XLink was supposed to replace all linking constructs in the W3C languages
  2. Adopted by SVG, X3D, but not by XHTML 2 which introduces its own linking constructs
  3. XML-capable browsers are also supposed to implement this (Firefox, but not IE)

              1. Story grammar that implements XLink for an A element

<?xml version="1.0" encoding="ISO-8859-1" ?>

<STORY xmlns:xlink="http://www.w3.org/1999/xlink">

<Title>The Webmaster</Title>

……

<INFOS> <Date>30 octobre 2003 - </Date>

<Author>DKS - </Author>

<A xlink:href=http://jigsaw.w3.org/css-validator/check/referer

xlink:type="simple">CSS Validator</A>

</INFOS>

</STORY>



SVG example


              1. XHTML with embedded SVG tags (file xhtml_svg.xhtml)

  1. Tested with Firefox

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >

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

xmlns:svg="http://www.w3.org/2000/svg">

<head> <title>SVG within XHTML Demo</title> </head>

<body>

.... The SVG part starts below <hr />

<svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="400" height="300">

<!-- a small rectangle -->

<rect x="50" y="50" rx="5" ry="5" width="300" height="100"

style="fill: CCCCFF;stroke: 000099"/>

<!-- a text in the same place -->

<text x="55" y="90" style="stroke: 000099;fill: 000099;font-size:24;">

HELLO dear reader </text>

</svg>

<hr />

The SVG part ended above

</body>

</html>


              1. SVG with a plugin (file html_svg.html)

  1. Works with IE or Firefox (and a SVG plugin installed)

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head> <title>HELLO SVG with an iframe</title> </head>

<body>

<h1>HELLO SVG with an iframe</h1>

Here is an embeded SVG scene using iframe. Alternatively you could use an "embed" tag (a slightly more complicated solution).

<iframe src="hello-svg.svg" height="200" width="80%" frameborder="0">

Sorry you need an SVG plugin ...

</iframe>

<hr> </body> </html>

  1. The SVG file is a standard stand-alone SVG file

<?xml version="1.0" standalone="no"?>

<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN"

"http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">

<svg xmlns="http://www.w3.org/2000/svg">

<rect x="50" y="50" rx="5" ry="5" width="300" height="100"

style="fill: CCCCFF;stroke: 000099"/>

<text x="55" y="90" style="stroke: 000099;fill: 000099;font-size:24;">

HELLO dear reader

</text>

</svg>


    1. Combining your XML with XHTML

  1. It sometimes can be practical to combine your own XML contents with XHTML, because HTML offers easy-to-use functionality like image inclusions or links.
  2. Note however that in practice this feature is not often used since:
  3. XSLT stylesheets allow transformations of XML data into XHTML (i.e. the stylesheet will contain the extra HTML and the result displayed usually will be all HTML and easier to manage with CSS)
  4. the way browsers implement this is not really stable

              1. XHTML with some XML included and CSS

  1. Tested with Firefox 2.x (works) and IE 7 (CSS doesn’t work, I don’t know why ...)

Procedure

  1. Define a namespace for the included XML content
  2. Attach a CSS stylesheet with an XML processor instruction
  3. Your file must be understood as "XML", e.g. call it something.xml or something.xhtml but not something.html !

              1. XHTML with some cooking XML included (file cooking.xhtml)

<?xml version="1.0" encoding="iso-8859-1"?>

<?xml-stylesheet type="text/css" href="cooking.css"?>

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

xmlns:re="http://webster.unige.ch/coap21/dolores">

<head>

<title>A Compound XHTML-XML Document</title>

<!-- this should work with IE but doesn’t, maybe IE6 ? -->

<link href="cooking.css" type="text/css" rel="stylesheet"/>

</head>

<body>

<h1>A Compound XHTML-XML Document</h1>

<p>Contains a cooking recipee written down by R. Dolores for a COAP 2180 CSS exercise. Everything below the line is XML styled with a CSS stylesheet</ p>

<hr/>

<re:recipe>

<re:recipe_head>

<re:recipe_name>Cold Salmon in Creamy Spiced Sauce</re:recipe_name>
  <re:recipe_author>Hilaire Walden</re:recipe_author>
  <re:meal_type>Fish and Shellfish</re:meal_type>

</re:recipe_head>

.....

</re:recipe>

</body>

</html>



XML with some XHTML included


  1. Works with Firefox 1x/2x and IE7 (probably also with IE6)
  2. An HTML namespace is declared in the root element and we use it twice (for the img and a tags).
  3. Btw this is a trick to get around non-implementation of the xlink standard in IE. If need to create a valid DTD, see " " [12]

              1. XML plus XHTML (file xml_plus_xhtml.xml)

<?xml version="1.0" ?>

<?xml-stylesheet href="xml_plus_xhtml.css" type="text/css"?>

<page xmlns:html="http://www.w3.org/1999/xhtml" updated="jan 2007">

<title>Hello friend</title>

<list>

<!-- we use an HTML tag below to include a picture -->

<html:img src="photo.jpg"/>

<item price="10"> White plate </item>

<item price="20"> Gold plate </item>

<item price="15"> Silver plate </item>

</list>

<comment> Written by <html:a href="http://tecfa.unige.ch/tecfa-people/ schneider.html">DKS/Tecfa</html:a> , feb 2007 </comment>

</page>



XML Data islands


  1. XML DATA islands are a Microsoft/IE extension to HTML
  2. Based on some early discussion on how to use XML with HTML (from the IE 5 period),
    data islands are easy to use but break all current HTML standards ...
  3. You can get similar functionality with other standard technologies, e.g. XSLT style sheets.

The principle


  1. Usually in the header of the HTML file we define one or more XML data sources within an "xml" tag. These data sources are included either by reference or by cut/paste:

Inclusion by reference to a file (better strategy):

<xml id="cd_info" src="cdlist.xml" />

Inclusion by cut/past (needs to be a full well-formed XML content !)

<xml>'''<?xml version="1.0" encoding="ISO-8859-1" ?> <list> <cd> <artist>The spammers</artist><title>Here we go</title> <price>10</price> </cd> <cd> <artist>The singers</artist><title>Let’s hear a song</title><price>10</ price></cd> </list>

</xml>


  1. The XML file / content needs to well-formed and you don’t need to worry about namespaces

  1. XML elements can be used to "fill in" various HTML element or attribute contents

  1. See official MS documentation or a textbook for details .......
  2. In the next slide we just demonstrate one of the most common use cases, i.e. binding HTML table cells contents to XML data.

              1. MS XML data island table example

XML contents (file cdlist.xml)

<?xml version="1.0" encoding="ISO-8859-1" ?>

<list>

<cd>

<artist>The spammers</artist>

<title>Here we go</title>

<price>10</price>

</cd>

<cd>

<artist>The singers</artist>

<title>Let’s hear a song</title>

<price>10</price>

</cd>

</list>

We would like to display contents of this XML file within a table inside an HTML document


  1. We create a reference to the clist.xml file (see next slide for HTML code !)

<xml id="cd_info" src="cdlist.xml" />

  1. We then tell the table that we are going to use this data source

<table datasrc=" cd_info" border="1">

  1. In the table body we associate contents of span with data source elements

<td><span datafld="artist"></span></td>

<td><span datafld="title"></span></td>

Important: You must use a span element (XML data can not directly be bound to "td" elements !)x

HTML (file xml_data_island.html)

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head>

<title>MS XML Data Islands</title>

<!-- identification of the data source -->

<xml id="cd_info" src="cdlist.xml" />

</head>

<body>

<h1>MS XML Data Islands</h1>

The table below imports data from cdlist.xml

<table datasrc=" cd_info" border="1">

<thead>

<tr> <th><span>Artist Name</span></th>
<th><span>Title</span></th>
<th><span>Price</span></th> </tr>

</thead>

<tbody>

<tr>
<td><span datafld="artist"></span></td>
<td><span datafld="title"></span></td>
<td><span datafld="price"></span></td>
  </tr>  

</tbody>

</table>

<hr> </body> </html>