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

Schema Namespace name, schemaLocation, and Schema Versioning


jdom schemalocation
I've read the Best Practice, debated the pros and cons, and am still not
confident that I understand all of the ramifications: How should I associate
evolving schema version numbers into my namespace name? Into my
schemaLocation? 

I have a set of schemas, all under the same namespace name, that will
certainly change over time.

Some changes will be major, some minor, some "trivial" (with numbering
reflecting the various levels, e.g., 2.3.1).

I know that if I want validators to validate the content, without writing
custom code that inspects the xml doc's content, the doc's schemaLocation
must reflect the specific version information (e.g.,
http://www.MyStandard.org/2.3.1/xyz.xsd).

I know that each schema change could affect the content in the instance
documents (changing the wire signature), and/or the names and/or structure
of the schema, which could adversely affect those schemas that import or
include the altered schema.

As such, each change reflects a different version of the schema (and thus a
new schemaLocation, e.g., http://www.MyStandard.org/2.3.1/xyz.xsd). 

But does each change warrant a new namespace name?

How much of a change to the schema truly warrants a change to the namespace
name? (Some say: "any change." Some say: "only non-backward-compatible
changes," whatever those might be).

What are the ramifications of fine-grained versioning in the schema
namespace (e.g., http://www.MyStandard.org/2.3.1/xyz.xsd)?

What are the ramifications of course-grained versioning in the schema
namespace (e.g., http://www.MyStandard.org/2.3/xyz.xsd)?

With well-componentized schemas, I understand that every change to the
schema would require a change to the namespace declaration in every included
schema, in order for namespace names to match. With a good configuration
management system, this can be supported trivially. For those who don't use
these tools, this can be tedious and error prone.

I can tell you at the moment, I'm leaning toward having three levels of
version numbering, and only reflecting major and minor version numbers into
the namespace name. But as I said, I'm not confident about the distinction
between "minor" and "trivial," nor am I convinced that there would be no
adverse impacts on the schemas' deployability/usability.

From a pure xml standpoint, my current approach will work, although I'm
still unsure whether any change, no matter how trivial, would represent both
an identical vocabulary (in the instances) and an identical meta-vocabulary
(in/among the schemas).

But from a practical, production perspective, I am unsure how the
schema-consuming middleware would accommodate the changing namespace names.
Certainly, new maps would have to be created for each element/attribute in
each new namespace name. Not so for most of the content, if the namespace
name was held stable and the predominant changes were extensions.

So what's your take ?( I know this is more of a philosophical rather than
pure technical question). When should a namespace name change to reflect
changes in the schemas? What granularity do you recommend? What practices
are so common that I should just accept them, even if they don't fully
answer my (many) questions?

Where can I look, beyond the xfront site, to get insight into common
practice, ramifications, etc.? Is this question better asked under the
XML-Dev list?

Thanks,

Mark

Mark Feblowitz                                   	
XML Architect
       [t]   617.715.7231                                     	
       [f]   617.495.0188
Frictionless Commerce Incorporated 	
       [e]  mfeblowitz@f... <mailto:mfeblowitz@f...>

       [w] http://www.frictionless.com <http://www.frictionless.com> 
       [m] 400 Technology Square, 9th Floor
             Cambridge, MA 02139 
Open Applications Group Incorporated
       [e]  mfeblowitz@o...
<mailto:mfeblowitz@o...> 
       [w] http://www.openapplications.org <http://www.openapplications.org>



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.