javax.xml.namespace
public class QName extends 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.
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.
|
Parameters: localPart Local part of the QName
Parameters: namespaceURI Namespace URI for the QName localPart Local part of the QName.
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.
Returns: Local part
Returns: Namespace URI
Object.hashCode
method.
Returns: a hash code value for this Qname object
Returns: a string representation of the QName
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
Throws: java.lang.IllegalArgumentException If the specified String cannot be parsed as a QName