public QName(String localPart) 
{
                                      
      this(emptyString, localPart, emptyString);
}

Constructor for the QName. Takes a localPart and sets the namespace and prefix to the empty string "".

Parameters:

localPart - Local part of the QName

Throws:

IllegalArgumentException - if localPart is null.

 public QName(String namespaceURI,
    String localPart) 
{
      this(namespaceURI, localPart, emptyString);
}

Constructor for the QName. Takes a localPart and a namespace and sets the prefix to the empty string "". If namespace is null, it defaults to the empty string.

Parameters:

namespaceURI - Namespace URI for the QName

localPart - Local part of the QName.

Throws:

IllegalArgumentException - if localPart is null.

 public QName(String namespaceURI,
    String localPart,
    String prefix) 
{
    this.namespaceURI = (namespaceURI == null)
                        ? emptyString
                        : namespaceURI.intern();
    if(localPart != null)
    {
        this.localPart = localPart.intern();
    }
    else
    {
        throw new IllegalArgumentException("localpart cannot be null.");
    }
    if(prefix != null)
    {
        this.prefix = prefix.intern();
    }
    else
    {
        throw new IllegalArgumentException("prefix cannot be null.");
    }
}

Constructor for the QName. Takes a localPart, a namespace and a prefix. If the namespace is null, it defaults to the empty string "". The localPart and prefix cannot be null. If they are, an IllegalArgumentException is thrown. If there is no prefix, an empty string "" must be specified.

Parameters:

namespaceURI - Namespace URI for the QName

localPart - Local part of the QName.

prefix - the xmlns-declared prefix for this namespaceURI

Throws:

IllegalArgumentException - if localPart or prefix is null.

 public final boolean equals(Object obj) 
{
    if (obj == this)
    {
      return true;
    }
    if (!(obj instanceof QName))
    {
      return false;
    }
    //We use intern strings, so can use '==' instead of .equals
    //for better performance.
    if ((namespaceURI == ((QName)obj).namespaceURI)
        && (localPart == ((QName)obj).localPart))
    {
      return true;
    }
    return false;
}

Tests this QName for equality with another object.

If the given object is not a QName or is null then this method returns false.

For two QNames to be considered equal requires that both localPart and namespaceURI must be equal. This method uses String.equals to check equality of localPart and namespaceURI. The prefix is NOT used to determine equality. Any class that extends QName is required to satisfy this equality contract.

This method satisfies the general contract of the Object.equals method.

 public String getLocalPart() 
{
    return localPart;
}

Gets the Local part for this QName

 public String getNamespaceURI() 
{
    return namespaceURI;
}

Gets the Namespace URI for this QName

 public String getPrefix() 
{
      return prefix;
}

Gets the prefix for this QName

 public final int hashCode() 
{
    return namespaceURI.hashCode() ^ localPart.hashCode();
}

Returns a hash code value for this QName object. The hash code is based on both the localPart and namespaceURI parts of the QName. This method satisfies the general contract of the Object.hashCode method.

 public String toString() 
{
    return ((namespaceURI == emptyString)
            ? localPart
            : '{" + namespaceURI + '}" + localPart);
}

Returns a string representation of this QName

 public static QName valueOf(String s) 
{
    if (s == null)
    {
      throw new IllegalArgumentException(
                  "Invalid QName literal - null string.");
    }
    if(s.indexOf("{") == 0) {
        int rightBrace = s.indexOf("}");
        if(rightBrace == -1 || rightBrace == s.length() - 1)
        {
            //No matching right brace or no local part after right brace
            throw new IllegalArgumentException(
                    "Invalid QName literal '" + s + "'.");
        } else {
            //namespace and local part
            return new QName(s.substring(1, rightBrace), s.substring(rightBrace + 1));
        }
    } else {
        //treat the whole string as the local part
        return new QName(s);
    }
}

Returns a QName holding the value of the specified String.

The string must be in the form returned by the QName.toString() method, i.e. "{namespaceURI}localPart", with the "{namespaceURI}" part being optional. If the Namespace URI .equals(""), only the local part should be provided. An empty string "" value will be treated as the localPart.

The prefix value CANNOT be represented in the String and will be set to "".

This method doesn't do a full validation of the resulting QName. In particular, it doesn't check that the resulting namespace URI is a legal URI (per RFC 2396 and RFC 2732), nor that the resulting local part is a legal NCName per the XML Namespaces specification.