org.jibx.runtime
Class QName

java.lang.Object
  extended by org.jibx.runtime.QName

public class QName
extends java.lang.Object

Representation of a qualified name. This includes the JiBX serializer/deserializer methods for the representation. It assumes that the actual namespace declarations are being handled separately for marshalling

Note that this implementation treats only the namespace and local name as significant for purposes of comparing values. The prefix is held only as a convenience, and the actual prefix used when writing a value may differ from the prefix defined by the instance.

Author:
Dennis M. Sosnoski

Constructor Summary
QName(java.lang.String name)
          Constructor from local name only.
QName(java.lang.String uri, java.lang.String name)
          Constructor from namespace and local name.
QName(java.lang.String uri, java.lang.String prefix, java.lang.String name)
          Constructor from full set of components.
 
Method Summary
static QName deserialize(java.lang.String text, IUnmarshallingContext ictx)
          JiBX deserializer method.
static QName[] deserializeList(java.lang.String text, IUnmarshallingContext ictx)
          JiBX deserializer method.
 boolean equals(java.lang.Object obj)
           
 java.lang.String getName()
          Get local name.
 java.lang.String getPrefix()
          Get namespace prefix.
 java.lang.String getUri()
          Get namespace URI.
 int hashCode()
           
static java.lang.String serialize(QName qname, IMarshallingContext ictx)
          JiBX serializer method.
static java.lang.String serializeList(QName[] qnames, IMarshallingContext ictx)
          JiBX serializer method.
 void setName(java.lang.String name)
          Set local name.
 void setPrefix(java.lang.String prefix)
          Set namespace prefix.
 void setUri(java.lang.String uri)
          Set namespace URI.
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

QName

public QName(java.lang.String uri,
             java.lang.String prefix,
             java.lang.String name)
Constructor from full set of components.

Parameters:
uri - namespace uri, null if no-namespace namespace
prefix - namespace prefix, null if unspecified, empty string if default namespace
name - local name

QName

public QName(java.lang.String uri,
             java.lang.String name)
Constructor from namespace and local name. This constructor is provided as a convenience for when the actual prefix used for a namespace is irrelevant.

Parameters:
uri - namespace uri, null if no-namespace namespace
name -

QName

public QName(java.lang.String name)
Constructor from local name only. This constructor is provided as a convenience for names in the no-namespace namespace.

Parameters:
name -
Method Detail

equals

public boolean equals(java.lang.Object obj)
Overrides:
equals in class java.lang.Object

hashCode

public int hashCode()
Overrides:
hashCode in class java.lang.Object

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

getName

public java.lang.String getName()
Get local name.

Returns:
name

setName

public void setName(java.lang.String name)
Set local name.

Parameters:
name - name

getPrefix

public java.lang.String getPrefix()
Get namespace prefix.

Returns:
prefix, null if unspecified, empty string if default namespace

setPrefix

public void setPrefix(java.lang.String prefix)
Set namespace prefix.

Parameters:
prefix - prefix, null if unspecified, empty string if default namespace

getUri

public java.lang.String getUri()
Get namespace URI.

Returns:
uri namespace uri, null if no-namespace namespace

setUri

public void setUri(java.lang.String uri)
Set namespace URI.

Parameters:
uri - namespace uri, null if no-namespace namespace

deserialize

public static QName deserialize(java.lang.String text,
                                IUnmarshallingContext ictx)
                         throws JiBXException
JiBX deserializer method. This is intended for use as a deserializer for instances of the class.

Parameters:
text - value text
ictx - unmarshalling context
Returns:
created class instance
Throws:
JiBXException - on error in unmarshalling

serialize

public static java.lang.String serialize(QName qname,
                                         IMarshallingContext ictx)
                                  throws JiBXException
JiBX serializer method. This is intended for use as a serializer for instances of the class. The namespace must be active in the output document at the point where this is called.

Parameters:
qname - value to be serialized
ictx - unmarshalling context
Returns:
created class instance
Throws:
JiBXException - on error in marshalling

deserializeList

public static QName[] deserializeList(java.lang.String text,
                                      IUnmarshallingContext ictx)
                               throws JiBXException
JiBX deserializer method. This is intended for use as a deserializer for a list made up of instances of the class.

Parameters:
text - value text
ictx - unmarshalling context
Returns:
array of instances
Throws:
JiBXException - on error in marshalling

serializeList

public static java.lang.String serializeList(QName[] qnames,
                                             IMarshallingContext ictx)
                                      throws JiBXException
JiBX serializer method. This is intended for use as a serializer for a list made up of instances of the class. The namespace must be active in the output document at the point where this is called.

Parameters:
qnames - array of names to be serialized
ictx - unmarshalling context
Returns:
generated text
Throws:
JiBXException - on error in marshalling


Project Web Site