javax.xml.namespace

Class QName

Implemented Interfaces:
Serializable

public class QName
extends java.lang.Object
implements Serializable

QName class represents the value of a qualified name as specified in XML Schema Part2: Datatypes specification.

The value of a QName contains a namespaceURI and a localPart. The localPart provides the local part of the qualified name. The namespaceURI is a URI reference identifying the namespace. Note: Some of this impl code was taken from Axis.

Authors:
axis-dev
Matthew J. Duftler (duftler@us.ibm.com)

Constructor Summary

QName(String localPart)
Constructor for the QName.
QName(String namespaceURI, String localPart)
Constructor for the QName.

Method Summary

boolean
equals(Object obj)
Tests this QName for equality with another object.
String
getLocalPart()
Gets the Local part for this QName
String
getNamespaceURI()
Gets the Namespace URI for this QName
int
hashCode()
Returns a hash code value for this QName object.
String
toString()
Returns a string representation of this QName
static QName
valueOf(String s)
Returns a QName holding the value of the specified String.

Constructor Details

QName

public QName(String localPart)
Constructor for the QName.
Parameters:
localPart - Local part of the QName

QName

public QName(String namespaceURI,
             String localPart)
Constructor for the QName.
Parameters:
namespaceURI - Namespace URI for the QName
localPart - Local part of the QName.

Method Details

equals

public final boolean equals(Object obj)
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. Any class that extends QName is required to satisfy this equality contract.

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

Parameters:
obj - the reference object with which to compare
Returns:
true if the given object is identical to this QName: false otherwise.

getLocalPart

public String getLocalPart()
Gets the Local part for this QName
Returns:
Local part

getNamespaceURI

public String getNamespaceURI()
Gets the Namespace URI for this QName
Returns:
Namespace URI

hashCode

public final int 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.
Returns:
a hash code value for this Qname object

toString

public String toString()
Returns a string representation of this QName
Returns:
a string representation of the QName

valueOf

public static QName valueOf(String 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.

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.

Parameters:
s - the string to be parsed
Returns:
QName corresponding to the given String

Copyright B) 2003,2005 IBM. All Rights Reserved.