Class 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 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.
      • 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.