com.objsys.xbinder.runtime

Class XBQName

java.lang.Object

com.objsys.xbinder.runtime.XBQName

public class XBQName
extends java.lang.Object

This models xsd:QName related values: a prefix, a namespaceUri, and a localName. This class differs from javax.xml.namespace.QName in a few important ways: 1) it is mutable 2) the namespaceUri can be in one of two states: assigned or not assigned. This can be used to distinguish between an unknown namespace and a known empty namespace. Use of this class is preferred when a modifiable QName object is desired.

Constructor Summary

Constructors

Constructor and Description
XBQName(java.lang.String qName) Create XBQName from given xsd:QName value.
XBQName(java.lang.String namespaceUri, java.lang.String localName, java.lang.String prefix) Create XBQName with given parameters.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getLocalName() Return the localName.
java.lang.String	getNamespaceUri() Return the namespace URI.
java.lang.String	getPrefix() Return the prefix.
boolean	isNamespaceUriAssigned() Return true if the namespaceUri has been assigned.
void	setLocalName(java.lang.String localName) Set the localName.
void	setNamespaceUri(java.lang.String namespaceUri) The namespace cannot be set to null.
void	setPrefix(java.lang.String prefix) The prefix cannot be set to null.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

XBQName

public XBQName(java.lang.String qName)

Create XBQName from given xsd:QName value. This splits the name into prefix and localName. namespaceUri will remain unassigned.

Parameters:

qName - The xsd:QName value. It must include a non-empty localName. The prefix is, of course, optional.

XBQName

public XBQName(java.lang.String namespaceUri,
               java.lang.String localName,
               java.lang.String prefix)

Create XBQName with given parameters.

Parameters:

namespaceUri - if null, "" is used

localName - may not be null or empty

prefix - if null, "" is used

Method Detail

getLocalName

public java.lang.String getLocalName()

Return the localName.

Returns:

The localName. A non-null, non-empty value.

getNamespaceUri

public java.lang.String getNamespaceUri()

Return the namespace URI.

Returns:

The namespace. A non-null value. If namespace is unassigned, an empty string is returned. If an empty string is returned, it will be the interned constant "" (allowing identity tests against "").

getPrefix

public java.lang.String getPrefix()

Return the prefix.

Returns:

The prefix. A non-null value. If empty string, the interned constant "" is returned (allowing identity tests against "").

isNamespaceUriAssigned

public boolean isNamespaceUriAssigned()

Return true if the namespaceUri has been assigned.

Returns:

setLocalName

public void setLocalName(java.lang.String localName)

Set the localName. Cannot be null or empty.

Parameters:

localName -

setNamespaceUri

public void setNamespaceUri(java.lang.String namespaceUri)

The namespace cannot be set to null. Passing null sets it to the empty string.

Parameters:

namespaceUri -

setPrefix

public void setPrefix(java.lang.String prefix)

The prefix cannot be set to null. Passing null sets it to the empty string.

Parameters:

prefix -

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object