< prev index next >

src/javax/xml/namespace/QName.java

Print this page
rev 2127 : 8048021: Remove @version tag in jaxp repo
Reviewed-by: joehw


  45  * URI</strong>, <strong>local part</strong> and
  46  * <strong>prefix</strong>.</p>
  47  *
  48  * <p>The prefix is included in <code>QName</code> to retain lexical
  49  * information <strong><em>when present</em></strong> in an {@link
  50  * javax.xml.transform.Source XML input source}. The prefix is
  51  * <strong><em>NOT</em></strong> used in {@link #equals(Object)
  52  * QName.equals(Object)} or to compute the {@link #hashCode()
  53  * QName.hashCode()}.  Equality and the hash code are defined using
  54  * <strong><em>only</em></strong> the Namespace URI and local part.</p>
  55  *
  56  * <p>If not specified, the Namespace URI is set to {@link
  57  * javax.xml.XMLConstants#NULL_NS_URI XMLConstants.NULL_NS_URI}.
  58  * If not specified, the prefix is set to {@link
  59  * javax.xml.XMLConstants#DEFAULT_NS_PREFIX
  60  * XMLConstants.DEFAULT_NS_PREFIX}.</p>
  61  *
  62  * <p><code>QName</code> is immutable.</p>
  63  *
  64  * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
  65  * @version $Revision: 1.8 $, $Date: 2010/03/18 03:06:17 $
  66  * @see <a href="http://www.w3.org/TR/xmlschema-2/#QName">
  67  *   XML Schema Part2: Datatypes specification</a>
  68  * @see <a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">
  69  *   Namespaces in XML</a>
  70  * @see <a href="http://www.w3.org/XML/xml-names-19990114-errata">
  71  *   Namespaces in XML Errata</a>
  72  * @since 1.5
  73  */
  74 
  75 public class QName implements Serializable {
  76 
  77     /**
  78      * <p>Stream Unique Identifier.</p>
  79      *
  80      * <p>Due to a historical defect, QName was released with multiple
  81      * serialVersionUID values even though its serialization was the
  82      * same.</p>
  83      *
  84      * <p>To workaround this issue, serialVersionUID is set with either
  85      * a default value or a compatibility value.  To use the




  45  * URI</strong>, <strong>local part</strong> and
  46  * <strong>prefix</strong>.</p>
  47  *
  48  * <p>The prefix is included in <code>QName</code> to retain lexical
  49  * information <strong><em>when present</em></strong> in an {@link
  50  * javax.xml.transform.Source XML input source}. The prefix is
  51  * <strong><em>NOT</em></strong> used in {@link #equals(Object)
  52  * QName.equals(Object)} or to compute the {@link #hashCode()
  53  * QName.hashCode()}.  Equality and the hash code are defined using
  54  * <strong><em>only</em></strong> the Namespace URI and local part.</p>
  55  *
  56  * <p>If not specified, the Namespace URI is set to {@link
  57  * javax.xml.XMLConstants#NULL_NS_URI XMLConstants.NULL_NS_URI}.
  58  * If not specified, the prefix is set to {@link
  59  * javax.xml.XMLConstants#DEFAULT_NS_PREFIX
  60  * XMLConstants.DEFAULT_NS_PREFIX}.</p>
  61  *
  62  * <p><code>QName</code> is immutable.</p>
  63  *
  64  * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>

  65  * @see <a href="http://www.w3.org/TR/xmlschema-2/#QName">
  66  *   XML Schema Part2: Datatypes specification</a>
  67  * @see <a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">
  68  *   Namespaces in XML</a>
  69  * @see <a href="http://www.w3.org/XML/xml-names-19990114-errata">
  70  *   Namespaces in XML Errata</a>
  71  * @since 1.5
  72  */
  73 
  74 public class QName implements Serializable {
  75 
  76     /**
  77      * <p>Stream Unique Identifier.</p>
  78      *
  79      * <p>Due to a historical defect, QName was released with multiple
  80      * serialVersionUID values even though its serialization was the
  81      * same.</p>
  82      *
  83      * <p>To workaround this issue, serialVersionUID is set with either
  84      * a default value or a compatibility value.  To use the


< prev index next >