OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help



   raw names vs qualified names

[ Lists Home | Date Index | Thread Index ]
  • From: Elliotte Rusty Harold <elharo@metalab.unc.edu>
  • To: xml-dev <xml-dev@xml.org>
  • Date: Mon, 06 Mar 2000 10:38:59 -0800

I have another, hopefully less controversial suggestion about renaming
something in the SAX2 API. In the ContentHandler class the
starteElement() method is declared like this:

public void startElement(java.lang.String namespaceURI,
                         java.lang.String localName,
                         java.lang.String rawName,
                         Attributes atts)
                  throws SAXException

I suggest the third argument, rawName, be renamed qualifiedName. The
reason is that "qualified name" is the term actually used in the
Namespaces in XML specification for prefixed names like rdf:book. The
term "raw name" does not appear.

Since method arguments are purely formal, this change can be made
without affecting anybody's existing code or invalidating anybody's
books. (Indeed in my books I routinely rename method arguments if I
think it makes the declarations clearer.)

The same change should be made in the endElement() method as well. It's
aminor change but I think it would help people learn SAX2 a little more
quickly and help ensure consistency between different XML specs.

| Elliotte Rusty Harold | elharo@metalab.unc.edu | Writer/Programmer |
|               Java I/O (O'Reilly & Associates, 1999)               |
|            http://metalab.unc.edu/javafaq/books/javaio/            |
|   http://www.amazon.com/exec/obidos/ISBN=1565924851/cafeaulaitA/   |
|  Read Cafe au Lait for Java News:  http://metalab.unc.edu/javafaq/ | 
|  Read Cafe con Leche for XML News: http://metalab.unc.edu/xml/     |

This is xml-dev, the mailing list for XML developers.
To unsubscribe, mailto:majordomo@xml.org&BODY=unsubscribe%20xml-dev
List archives are available at http://xml.org/archives/xml-dev/


News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS