com.sun.xml.bind.v2.runtime.unmarshaller
Class TagName

java.lang.Object
  extended by com.sun.xml.bind.v2.runtime.unmarshaller.TagName

public abstract class TagName
extends Object

Represents an XML tag name (and attributes for start tags.)

This object is used so reduce the number of method call parameters among unmarshallers. An instance of this is expected to be reused by the caller of XmlVisitor. Note that the rest of the unmarshaller may modify any of the fields while processing an event (such as to intern strings, replace attributes), so XmlVisitor should reset all fields for each use.

The 'qname' parameter, which holds the qualified name of the tag (such as 'foo:bar' or 'zot'), is not used in the typical unmarshalling route and it's also expensive to compute for some input. Thus this parameter is computed lazily.


Field Summary
 Attributes atts
          Used only for the enterElement event.
 String local
          Local part of the attribute/element name.
 String uri
          URI of the attribute/element name.
 
Constructor Summary
TagName()
           
 
Method Summary
 QName createQName()
          Creates QName.
 String getPrefix()
          Gets the prefix.
abstract  String getQname()
          Gets the qualified name of the tag.
 boolean matches(Name name)
          Checks if the given name pair matches this name.
 boolean matches(String nsUri, String local)
          Checks if the given name pair matches this name.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

uri

public String uri
URI of the attribute/element name. Can be empty, but never null. Interned.


local

public String local
Local part of the attribute/element name. Never be null. Interned.


atts

public Attributes atts
Used only for the enterElement event. Otherwise the value is undefined. This might be AttributesEx.

Constructor Detail

TagName

public TagName()
Method Detail

matches

public final boolean matches(String nsUri,
                             String local)
Checks if the given name pair matches this name.


matches

public final boolean matches(Name name)
Checks if the given name pair matches this name.


toString

public String toString()
Overrides:
toString in class Object

getQname

public abstract String getQname()
Gets the qualified name of the tag.

Returns:
never null.

getPrefix

public String getPrefix()
Gets the prefix. This is slow.

Returns:
can be "" but never null.

createQName

public QName createQName()
Creates QName.