org.apache.xml.utils
Class QName

java.lang.Object
  extended byorg.apache.xml.utils.QName
All Implemented Interfaces:
Serializable

public class QName
extends Object
implements Serializable

Class to represent a qualified name: "The name of an internal XSLT object, specifically a named template (see [7 Named Templates]), a mode (see [6.7 Modes]), an attribute set (see [8.1.4 Named Attribute Sets]), a key (see [14.2 Keys]), a locale (see [14.3 Number Formatting]), a variable or a parameter (see [12 Variables and Parameters]) is specified as a QName. If it has a prefix, then the prefix is expanded into a URI reference using the namespace declarations in effect on the attribute in which the name occurs. The expanded name consisting of the local part of the name and the possibly null URI reference is used as the name of the object. The default namespace is not used for unprefixed names."

See Also:
Serialized Form

Field Summary
protected  String _localName
          The local name.
protected  String _namespaceURI
          The namespace URI.
protected  String _prefix
          The namespace prefix.
private  int m_hashCode
          The cached hashcode, which is calculated at construction time.
static String S_XMLNAMESPACEURI
          The XML namespace.
 
Constructor Summary
QName()
          Constructs an empty QName. 20001019: Try making this public, to support Serializable?
QName(String localName)
          Construct a QName from a string, without namespace resolution.
QName(String localName, boolean validate)
          Construct a QName from a string, without namespace resolution.
QName(String qname, org.w3c.dom.Element namespaceContext, PrefixResolver resolver)
          Construct a QName from a string, resolving the prefix using the given namespace context and prefix resolver.
QName(String qname, org.w3c.dom.Element namespaceContext, PrefixResolver resolver, boolean validate)
          Construct a QName from a string, resolving the prefix using the given namespace context and prefix resolver.
QName(String qname, PrefixResolver resolver)
          Construct a QName from a string, resolving the prefix using the given namespace stack.
QName(String qname, PrefixResolver resolver, boolean validate)
          Construct a QName from a string, resolving the prefix using the given namespace stack.
QName(String qname, Stack namespaces)
          Construct a QName from a string, resolving the prefix using the given namespace stack.
QName(String qname, Stack namespaces, boolean validate)
          Construct a QName from a string, resolving the prefix using the given namespace stack.
QName(String namespaceURI, String localName)
          Constructs a new QName with the specified namespace URI and local name.
QName(String namespaceURI, String localName, boolean validate)
          Constructs a new QName with the specified namespace URI and local name.
QName(String namespaceURI, String prefix, String localName)
          Constructs a new QName with the specified namespace URI, prefix and local name.
QName(String namespaceURI, String prefix, String localName, boolean validate)
          Constructs a new QName with the specified namespace URI, prefix and local name.
 
Method Summary
 boolean equals(Object object)
          Override equals and agree that we're equal if the passed object is a QName and it matches the name of the arg.
 boolean equals(String ns, String localPart)
          Override equals and agree that we're equal if the passed object is a string and it matches the name of the arg.
 String getLocalName()
          Returns the local part of the qualified name.
 String getLocalPart()
          Get the local part of the qualified name.
static String getLocalPart(String qname)
          Returns the local name of the given node.
 String getNamespace()
          Get the namespace of the qualified name.
 String getNamespaceURI()
          Returns the namespace URI.
 String getPrefix()
          Returns the namespace prefix.
static String getPrefixFromXMLNSDecl(String attRawName)
          This function tells if a raw attribute name is a xmlns attribute.
static String getPrefixPart(String qname)
          Returns the local name of the given node.
static QName getQNameFromString(String name)
          Given a string, create and return a QName object
 int hashCode()
          Return the cached hashcode of the qualified name.
static boolean isXMLNSDecl(String attRawName)
          This function tells if a raw attribute name is a xmlns attribute.
 String toNamespacedString()
          Return the string representation of the qualified name using the the '{ns}foo' notation.
 String toString()
          Return the string representation of the qualified name, using the prefix if available, or the '{ns}foo' notation if not.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

_localName

protected String _localName
The local name.


_namespaceURI

protected String _namespaceURI
The namespace URI.


_prefix

protected String _prefix
The namespace prefix.


S_XMLNAMESPACEURI

public static final String S_XMLNAMESPACEURI
The XML namespace.

See Also:
Constant Field Values

m_hashCode

private int m_hashCode
The cached hashcode, which is calculated at construction time.

Constructor Detail

QName

public QName()
Constructs an empty QName. 20001019: Try making this public, to support Serializable? -- JKESS


QName

public QName(String namespaceURI,
             String localName)
Constructs a new QName with the specified namespace URI and local name.

Parameters:
namespaceURI - The namespace URI if known, or null
localName - The local name

QName

public QName(String namespaceURI,
             String localName,
             boolean validate)
Constructs a new QName with the specified namespace URI and local name.

Parameters:
namespaceURI - The namespace URI if known, or null
localName - The local name
validate - If true the new QName will be validated and an IllegalArgumentException will be thrown if it is invalid.

QName

public QName(String namespaceURI,
             String prefix,
             String localName)
Constructs a new QName with the specified namespace URI, prefix and local name.

Parameters:
namespaceURI - The namespace URI if known, or null
prefix - The namespace prefix is known, or null
localName - The local name

QName

public QName(String namespaceURI,
             String prefix,
             String localName,
             boolean validate)
Constructs a new QName with the specified namespace URI, prefix and local name.

Parameters:
namespaceURI - The namespace URI if known, or null
prefix - The namespace prefix is known, or null
localName - The local name
validate - If true the new QName will be validated and an IllegalArgumentException will be thrown if it is invalid.

QName

public QName(String localName)
Construct a QName from a string, without namespace resolution. Good for a few odd cases.

Parameters:
localName - Local part of qualified name

QName

public QName(String localName,
             boolean validate)
Construct a QName from a string, without namespace resolution. Good for a few odd cases.

Parameters:
localName - Local part of qualified name
validate - If true the new QName will be validated and an IllegalArgumentException will be thrown if it is invalid.

QName

public QName(String qname,
             Stack namespaces)
Construct a QName from a string, resolving the prefix using the given namespace stack. The default namespace is not resolved.

Parameters:
qname - Qualified name to resolve
namespaces - Namespace stack to use to resolve namespace

QName

public QName(String qname,
             Stack namespaces,
             boolean validate)
Construct a QName from a string, resolving the prefix using the given namespace stack. The default namespace is not resolved.

Parameters:
qname - Qualified name to resolve
namespaces - Namespace stack to use to resolve namespace
validate - If true the new QName will be validated and an IllegalArgumentException will be thrown if it is invalid.

QName

public QName(String qname,
             org.w3c.dom.Element namespaceContext,
             PrefixResolver resolver)
Construct a QName from a string, resolving the prefix using the given namespace context and prefix resolver. The default namespace is not resolved.

Parameters:
qname - Qualified name to resolve
namespaceContext - Namespace Context to use
resolver - Prefix resolver for this context

QName

public QName(String qname,
             org.w3c.dom.Element namespaceContext,
             PrefixResolver resolver,
             boolean validate)
Construct a QName from a string, resolving the prefix using the given namespace context and prefix resolver. The default namespace is not resolved.

Parameters:
qname - Qualified name to resolve
namespaceContext - Namespace Context to use
resolver - Prefix resolver for this context
validate - If true the new QName will be validated and an IllegalArgumentException will be thrown if it is invalid.

QName

public QName(String qname,
             PrefixResolver resolver)
Construct a QName from a string, resolving the prefix using the given namespace stack. The default namespace is not resolved.

Parameters:
qname - Qualified name to resolve
resolver - Prefix resolver for this context

QName

public QName(String qname,
             PrefixResolver resolver,
             boolean validate)
Construct a QName from a string, resolving the prefix using the given namespace stack. The default namespace is not resolved.

Parameters:
qname - Qualified name to resolve
resolver - Prefix resolver for this context
validate - If true the new QName will be validated and an IllegalArgumentException will be thrown if it is invalid.
Method Detail

getNamespaceURI

public String getNamespaceURI()
Returns the namespace URI. Returns null if the namespace URI is not known.

Returns:
The namespace URI, or null

getPrefix

public String getPrefix()
Returns the namespace prefix. Returns null if the namespace prefix is not known.

Returns:
The namespace prefix, or null

getLocalName

public String getLocalName()
Returns the local part of the qualified name.

Returns:
The local part of the qualified name

toString

public String toString()
Return the string representation of the qualified name, using the prefix if available, or the '{ns}foo' notation if not. Performs string concatenation, so beware of performance issues.

Overrides:
toString in class Object
Returns:
the string representation of the namespace

toNamespacedString

public String toNamespacedString()
Return the string representation of the qualified name using the the '{ns}foo' notation. Performs string concatenation, so beware of performance issues.

Returns:
the string representation of the namespace

getNamespace

public String getNamespace()
Get the namespace of the qualified name.

Returns:
the namespace URI of the qualified name

getLocalPart

public String getLocalPart()
Get the local part of the qualified name.

Returns:
the local part of the qualified name

hashCode

public int hashCode()
Return the cached hashcode of the qualified name.

Overrides:
hashCode in class Object
Returns:
the cached hashcode of the qualified name
See Also:
Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(String ns,
                      String localPart)
Override equals and agree that we're equal if the passed object is a string and it matches the name of the arg.

Parameters:
ns - Namespace URI to compare to
localPart - Local part of qualified name to compare to
Returns:
True if the local name and uri match

equals

public boolean equals(Object object)
Override equals and agree that we're equal if the passed object is a QName and it matches the name of the arg.

Overrides:
equals in class Object
Parameters:
object - the reference object with which to compare.
Returns:
True if the qualified names are equal
See Also:
Object.hashCode(), Hashtable

getQNameFromString

public static QName getQNameFromString(String name)
Given a string, create and return a QName object

Parameters:
name - String to use to create QName
Returns:
a QName object

isXMLNSDecl

public static boolean isXMLNSDecl(String attRawName)
This function tells if a raw attribute name is a xmlns attribute.

Parameters:
attRawName - Raw name of attribute
Returns:
True if the attribute starts with or is equal to xmlns

getPrefixFromXMLNSDecl

public static String getPrefixFromXMLNSDecl(String attRawName)
This function tells if a raw attribute name is a xmlns attribute.

Parameters:
attRawName - Raw name of attribute
Returns:
Prefix of attribute

getLocalPart

public static String getLocalPart(String qname)
Returns the local name of the given node.

Parameters:
qname - Input name
Returns:
Local part of the name if prefixed, or the given name if not

getPrefixPart

public static String getPrefixPart(String qname)
Returns the local name of the given node.

Parameters:
qname - Input name
Returns:
Prefix of name or empty string if none there