jadex.xml.stax

Class QName

java.lang.Object

jadex.xml.stax.QName

All Implemented Interfaces:

Serializable

public class QName
extends Object
implements Serializable

StaX API: QName

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
QName(String localPart) Constructor for the QName with just a local part.
QName(String namespaceURI, String localPart) Constructor for the QName with a namespace URI and a local part.
QName(String namespaceURI, String localPart, String prefix) Constructor for the QName.

Method Summary

Methods

Modifier and Type	Method and Description
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.
String	getPrefix() Gets the prefix 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.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

QName

public QName(String localPart)

Constructor for the QName with just a local part. This assigns an empty string as the default values for namespaceURI, prefix and localPart.

Parameters:

localPart - Local part of the QName

Throws:

IllegalArgumentException - If null local part is specified

QName

public QName(String namespaceURI,
     String localPart)

Constructor for the QName with a namespace URI and a local part. This method assigns an empty string as the default value for prefix.

Parameters:

namespaceURI - Namespace URI for the QName

localPart - Local part of the QName

Throws:

IllegalArgumentException - If null local part or namespaceURI is specified

QName

public QName(String namespaceURI,
     String localPart,
     String prefix)

Constructor for the QName.

Parameters:

namespaceURI - Namespace URI for the QName

localPart - Local part of the QName

prefix - The prefix of the QName

Throws:

IllegalArgumentException - If null local part or prefix is specified

Method Detail

getNamespaceURI

public String getNamespaceURI()

Gets the Namespace URI for this QName.

Returns:

Namespace URI

getLocalPart

public String getLocalPart()

Gets the Local part for this QName.

Returns:

Local part

getPrefix

public String getPrefix()

Gets the prefix for this QName. Note that the prefix assigned to a QName may not be valid in a different context. For example, a QName may be assigned a prefix in the context of parsing a document but that prefix may be invalid in the context of a different document.

Returns:

a String value of the prefix.

toString

public String toString()

Returns a string representation of this QName.

Overrides:

toString in class Object

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

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 the Object.hashCode method.

Overrides:

hashCode in class Object

Returns:

A hash code value for this Qname object

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.

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

Overrides:

equals in class Object

Parameters:

obj - the reference object with which to compare.

Returns:

true if the given object is identical to this QName: false otherwise.