Class QName
- All Implemented Interfaces:
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.
- Author:
- axis-dev, Matthew J. Duftler (duftler@us.ibm.com)
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionfinal boolean
Tests this QName for equality with another object.Gets the Local part for this QNameGets the Namespace URI for this QNameGets the prefix for this QNamefinal int
hashCode()
Returns a hash code value for this QName object.toString()
Returns a string representation of this QNamestatic QName
Returns a QName holding the value of the specified String.
-
Constructor Details
-
QName
Constructor for the QName.- Parameters:
localPart
- Local part of the QName
-
QName
Constructor for the QName.- Parameters:
namespaceURI
- Namespace URI for the QNamelocalPart
- Local part of the QName.
-
QName
Constructor for the QName.- Parameters:
namespaceURI
- Namespace URI for the QNamelocalPart
- Local part of the QName.prefix
- the xmlns-declared prefix for this namespaceURI
-
-
Method Details
-
getNamespaceURI
Gets the Namespace URI for this QName- Returns:
- Namespace URI
-
getLocalPart
Gets the Local part for this QName- Returns:
- Local part
-
getPrefix
Gets the prefix for this QName- Returns:
- prefix of this QName
-
toString
Returns a string representation of this QName -
equals
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. -
valueOf
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
- Throws:
IllegalArgumentException
- If the specified String cannot be parsed as a QName
-
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 theObject.hashCode
method.
-