/**@class javax.xml.namespace.QName
 implements java.io.Serializable

@extends java.lang.Object

 <p><code>QName</code> represents a <strong>qualified name</strong>
 as defined in the XML specifications: <a
 href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part2:
 Datatypes specification</a>, <a
 href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">Namespaces
 in XML</a>, <a
 href="http://www.w3.org/XML/xml-names-19990114-errata">Namespaces
 in XML Errata</a>.</p>

 <p>The value of a <code>QName</code> contains a <strong>Namespace
 URI</strong>, <strong>local part</strong> and
 <strong>prefix</strong>.</p>

 <p>The prefix is included in <code>QName</code> to retain lexical
 information <strong><em>when present</em></strong> in an {@link javax.xml.transform.Source XML input source}. The prefix is
 <strong><em>NOT</em></strong> used in {@link #equals(Object)
 javax.xml.namespace.QName.equals(Object)} or to compute the {@link #hashCode()
 javax.xml.namespace.QName.hashCode()}.  Equality and the hash code are defined using
 <strong><em>only</em></strong> the Namespace URI and local part.</p>

 <p>If not specified, the Namespace URI is set to {@link javax.xml.XMLConstants#NULL_NS_URI XMLConstants.NULL_NS_URI}.
 If not specified, the prefix is set to {@link javax.xml.XMLConstants#DEFAULT_NS_PREFIX
 XMLConstants.DEFAULT_NS_PREFIX}.</p>

 <p><code>QName</code> is immutable.</p>

 @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
 @version $Revision: 754581 $, $Date: 2009-03-14 18:32:39 -0700 (Sat, 14 Mar 2009) $
 @see <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part2: Datatypes specification</a>
 @see <a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">Namespaces in XML</a>
 @see <a href="http://www.w3.org/XML/xml-names-19990114-errata">Namespaces in XML Errata</a>
 @since 1.5
*/
var QName = {

/**<p>Get the Namespace URI of this <code>QName</code>.</p>
@return {String} Namespace URI of this <code>QName</code>
*/
getNamespaceURI : function(  ) {},

/**<p>Get the local part of this <code>QName</code>.</p>
@return {String} local part of this <code>QName</code>
*/
getLocalPart : function(  ) {},

/**<p>Get the prefix of this <code>QName</code>.</p>

 <p>The prefix assigned to a <code>QName</code> might
 <strong><em>NOT</em></strong> be valid in a different
 context. For example, a <code>QName</code> may be assigned a
 prefix in the context of parsing a document but that prefix may
 be invalid in the context of a different document.</p>
@return {String} prefix of this <code>QName</code>
*/
getPrefix : function(  ) {},

/**<p>Test this <code>QName</code> for equality with another
 <code>Object</code>.</p>

 <p>If the <code>Object</code> to be tested is not a
 <code>QName</code> or is <code>null</code>, then this method
 returns <code>false</code>.</p>

 <p>Two <code>QName</code>s are considered equal if and only if
 both the Namespace URI and local part are equal. This method
 uses <code>String.equals()</code> to check equality of the
 Namespace URI and local part. The prefix is
 <strong><em>NOT</em></strong> used to determine equality.</p>

 <p>This method satisfies the general contract of {@link java.lang.Object#equals(Object) Object.equals(Object)}</p>
@param {Object {Object}} objectToTest the <code>Object</code> to test for
 equality with this <code>QName</code>
@return {Boolean} <code>true</code> if the given <code>Object</code> is
 equal to this <code>QName</code> else <code>false</code>
*/
equals : function(  ) {},

/**<p>Generate the hash code for this <code>QName</code>.</p>

 <p>The hash code is calculated using both the Namespace URI and
 the local part of the <code>QName</code>.  The prefix is
 <strong><em>NOT</em></strong> used to calculate the hash
 code.</p>

 <p>This method satisfies the general contract of {@link java.lang.Object#hashCode() Object.hashCode()}.</p>
@return {Number} hash code for this <code>QName</code> <code>Object</code>
*/
hashCode : function(  ) {},

/**<p><code>String</code> representation of this
 <code>QName</code>.</p>

 <p>The commonly accepted way of representing a <code>QName</code>
 as a <code>String</code> was <a href="http://jclark.com/xml/xmlns.htm">defined</a>
 by James Clark.  Although this is not a <em>standard</em>
 specification, it is in common use,  e.g. {@link javax.xml.transform.Transformer#setParameter(String name, Object value)}.
 This implementation represents a <code>QName</code> as:
 "{" + Namespace URI + "}" + local part.  If the Namespace URI
 <code>.equals(XMLConstants.NULL_NS_URI)</code>, only the
 local part is returned.  An appropriate use of this method is
 for debugging or logging for human consumption.</p>

 <p>Note the prefix value is <strong><em>NOT</em></strong>
 returned as part of the <code>String</code> representation.</p>

 <p>This method satisfies the general contract of {@link java.lang.Object#toString() Object.toString()}.</p>
@return {String} <code>String</code> representation of this <code>QName</code>
*/
toString : function(  ) {},

/**<p><code>QName</code> derived from parsing the formatted
 <code>String</code>.</p>

 <p>If the <code>String</code> is <code>null</code> or does not conform to
 {@link #toString() javax.xml.namespace.QName.toString()} formatting, an
 <code>IllegalArgumentException</code> is thrown.</p>

 <p><em>The <code>String</code> <strong>MUST</strong> be in the
 form returned by {@link #toString() javax.xml.namespace.QName.toString()}.</em></p>

 <p>The commonly accepted way of representing a <code>QName</code>
 as a <code>String</code> was <a href="http://jclark.com/xml/xmlns.htm">defined</a>
 by James Clark.  Although this is not a <em>standard</em>
 specification, it is in common use,  e.g. {@link javax.xml.transform.Transformer#setParameter(String name, Object value)}.
 This implementation parses a <code>String</code> formatted
 as: "{" + Namespace URI + "}" + local part.  If the Namespace
 URI <code>.equals(XMLConstants.NULL_NS_URI)</code>, only the
 local part should be provided.</p>

 <p>The prefix value <strong><em>CANNOT</em></strong> be
 represented in the <code>String</code> and will be set to
 {@link javax.xml.XMLConstants#DEFAULT_NS_PREFIX
 XMLConstants.DEFAULT_NS_PREFIX}.</p>

 <p>This method does not do full validation of the resulting
 <code>QName</code>.
 <p>The Namespace URI is not validated as a
 <a href="http://www.ietf.org/rfc/rfc2396.txt">URI reference</a>.
 The local part is not validated as a
 <a href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</a>
 as specified in
 <a href="http://www.w3.org/TR/REC-xml-names/">Namespaces in XML</a>.</p>
@param {String} qNameAsString <code>String</code> representation
 of the <code>QName</code>
@return {Object {javax.xml.namespace.QName}} <code>QName</code> corresponding to the given <code>String</code>
@see #toString() QName.toString()
*/
valueOf : function(  ) {},


};