[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

RE: Namespaces Best Practice

  • From: Paul Spencer <paul.spencer@a...>
  • To: Jonathan Borden <jborden@m...>, xml-dev@l...
  • Date: Wed, 19 Sep 2001 17:31:58 +0100

namespaces best practice
I'm late coming to this thread, but am I the only one to disagree with point
1? (I agree totally with 2.)

Take a typical document submitted to UK Government (my area, by the
principles apply elsewhere). This will have a document payload that will
generally meet requirement 1. It will have a single default namespace
defined in its document element. If it uses other namespaces, the bindings
will probably be defined here as well. This is then wrapped in an envelope.
This will also use a default namespace, and will itself contain a digital
signature in the XML Signature namespace (again, used as a default for this
part of the document). So the compound document has three distinct parts -
the envelope, the signature and the payload. It is both unnecessary and
confusing to declare all the namespaces in the document element of the
envelope and prefix all elements except those in a single default. Indeed,
it is positively harmful as the envelope will be stripped off and thrown
away before the payload is processed (do you keep the envelope when you get
a letter from the taxman?). Arguably, we could qualify every element of the
signature, but why not define a new default for this? After all, it is a
well-bounded section of the document.

So these "compound documents" definitely should have multiple default
namespaces defined for different parts of the document. What I would not do
is specify bindings at random through the document. I guess that is what
Jonathan is referring to.

Paul Spencer
CTO, alphaXML Ltd
alphaXML is recruiting XML Consultants and Developers
+44 (0)1491 630053
http://www.alphaxml.com


> -----Original Message-----
> From: Jonathan Borden [mailto:jborden@m...]
> Sent: 26 August 2001 19:56
> To: xml-dev@l...
> Subject: Namespaces Best Practice
>
>
> Wow! I return from vacation to find such discussions of Namespaces x
> Schemas. It has been quite difficult for me to follow/reconstruct
> the thread
> of these arguments.
>
> Back to basics.
>
> It is a plain fact that the vast majority of major XML parsers as well as
> significant XML related specifications such as XSLT, XHTML, XLink, XSD,
> RELAXNG, Schematron etc. are XML Namespace aware. Love em or hate em XML
> Namespaces are here to stay and we are best to define namespace best
> practices.
>
> 1) An XML Namespaces best practice for document/application design is to
> define all namespace prefix bindings at the document (root)
> element context.
>
> 2) Use of XML Namespaces is optional in XML document and application
> design - however - it is a best practice to either use or not use XML
> namespaces in a single document format/application. That is, if XML
> Namespaces are to be used, it is a best practice to qualify all elements.
>
> 1) and 2) are related. Taken together, a document composed of elements
> qualified by multiple namespaces should have a single
> _unprefixed_ namespace
> and multiple prefixed namespaces. By defining the namespace - prefix
> bindings at the document (root) element, it is easy for both people and
> applications to understand the namespace structure of a document.
> Unqualified elements confuse the picture because its not immediately clear
> if they are intended to be qualified by the namespace associated with the
> empty prefix (i.e. unprefixed) or not qualified without scanning the
> namespace bindings in the element's attributes. This breaks 1). To keep
> things simple, it is best to either use or not use namespaces, but mixing
> and matching is as frought with problems as is binding the same prefix to
> different namespaces in different places within the same document.
>
> Jonathan
>
>
> -----------------------------------------------------------------
> The xml-dev list is sponsored by XML.org <http://www.xml.org>, an
> initiative of OASIS <http://www.oasis-open.org>
>
> The list archives are at http://lists.xml.org/archives/xml-dev/
>
> To subscribe or unsubscribe from this elist use the subscription
> manager: <http://lists.xml.org/ob/adm.pl>
>
>


PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
 

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.


Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.