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

Proposal (was Re: [Sax-devel] Re: SAX survey: expected local name for n

  • To: sax-devel@l...
  • Subject: Proposal (was Re: [Sax-devel] Re: SAX survey: expected local name for non-namespace qualified elements)
  • From: "Simon St.Laurent" <simonstl@s...>
  • Date: Sun, 02 Jun 2002 17:25:30 -0400
  • Cc: xerces-j-dev@x..., xml-dev@l...
  • In-reply-to: <OFDACC48C5.271E4D67-ON85256BCC.006D0D27@r...>

sax localname
At 04:07 PM 6/2/2002 -0400, Glenn Marcy wrote:
>In reading this thread main thing that I see confusing people
>is the name of the parameter "qName".  I remember when it was
>first something like "rawName", which wasn't as well aligned
>with terms in the Namespace spec.  However, it was perhaps a
>slightly less confusing name with Namespaces turned off.  The
>"dual nature" of the methods in the interface are unfortunate.

I've been thinking about this unfortunate situation and think I may have a 
proposal which will let us steer through the disconnect between 
namespaces-on and namespace-off approaches as people like Glenn seem to see 
them.

How about:
1) The qName parameter is renamed "rawName", and documentation explains 
that this is both the Qualified Name in namespace-aware processing and the 
Name in namespace-unaware processing.  I don't believe that changing 
parameter names in Java has any direct impact on code built on those 
parameter names - overriding methods can rename parameters at their 
convenience. (I could be wrong about that, of course.)

2) A filter which copies rawName to localName in the event that localName 
is empty or null is included in the org.xml.sax.helpers package.  This way, 
developers can adapt filters and applications which work using 
namespace-aware expectations to namespace-unaware processing without having 
to retrofit their code.

Effectively this is a fix-through-documentation and supplements, though 
admittedly it touches the code.

Simon St.Laurent
"Every day in every way I'm getting better and better." - Emile Coue


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.