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

Class TagName

java.lang.Object

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.

Author:

Kohsuke Kawaguchi

Field Summary

Fields

Modifier and Type	Field and Description
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

Constructors

Constructor and Description
TagName()

Method Summary

Modifier and Type	Method and Description
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.