Java Web Services in a Nutshell

Name

QName

Synopsis

public class QName implements java.io.Serializable {
// Public Constructors
       public QName( String localPart); 
       public QName( String namespaceURI, String localPart); 
// Public Class Methods
    public static QName valueOf( String s); 
// Public Instance Methods
    public String getLocalPart(  ); 
    public String getNamespaceURI(  ); 
// Public Methods Overriding Object
    public final boolean equals( Object obj); 
    public final int hashCode(  ); 
    public String toString(  ); 
}

This class represents an XML-qualified name. The two-argument constructor creates a QName object with a given local part and namespace URI. The one-argument constructor creates a QName object that does not have an explicitly specified namespace. An XML element associated with a QName that does not have an explicit namespace is considered to be in the default namespace that is in force for that element. The URI for the default namespace is determined by an xmlns attribute with no associated prefix, placed either on that element or on one of its ancestors.

The getLocalPart( ) and getNamespaceURI( ) methods return the local part and the namespace URI associated with the QName. In the case of a QName that does not have a namespace URI, the latter method returns an empty string. The toString( ) method creates a string representation of the QName as follows:

• If the name does not have a namespace URI, then the value returned by toString( ) is just the local part of the name.

• Otherwise, the value returned is {URI}localPart.