Class TextTag

  • All Implemented Interfaces:
    Tag

    public class TextTag
    extends Object
    implements Tag
    • Constructor Detail

      • TextTag

        public TextTag​(Doc holder,
                       String text)
        Constructor
    • Method Detail

      • name

        public String name()
        Return the name of this tag. The name is the string starting with "@" that is used in a doc comment, such as @return. For inline tags, such as {@link}, the curly brackets are not part of the name, so in this example the name would be simply @link.
        Specified by:
        name in interface Tag
        Returns:
        the name of this tag
      • holder

        public Doc holder()
        Return the containing Doc of this Tag element.
        Specified by:
        holder in interface Tag
        Returns:
        the containing Doc of this Tag element
      • kind

        public String kind()
        Return the kind of this tag. For most tags, kind() == name(); the following table lists those cases where there is more than one tag of a given kind:
        Related Tags
        kind() name()
        @throws @throws
        @throws @exception
        @see @see
        @see @link
        @see @linkplain
        @serial @serial
        @serial @serialData
        Specified by:
        kind in interface Tag
        Returns:
        the kind of this tag.
      • text

        public String text()
        Return the text of this tag, that is, the portion beyond tag name.
        Specified by:
        text in interface Tag
        Returns:
        the text of this tag
      • inlineTags

        public Tag[] inlineTags()
        For a documentation comment with embedded {@link} tags, return an array of Tag objects. The entire doc comment is broken down into strings separated by {@link} tags, where each successive element of the array represents either a string or {@link} tag, in order, from start to end. Each string is represented by a Tag object of name "Text", where Tag.text() returns the string. Each {@link} tag is represented by a SeeTag of name "@link" and kind "@see". For example, given the following comment tag:

        This is a {@link Doc commentlabel} example.

        return an array of Tag objects:

        • tags[0] is a Tag with name "Text" and text consisting of "This is a "
        • tags[1] is a SeeTag with name "@link", referenced class Doc and label "commentlabel"
        • tags[2] is a Tag with name "Text" and text consisting of " example."
        Specified by:
        inlineTags in interface Tag
        Returns:
        Tag[] array of tags
        See Also:
        ParamTag, ThrowsTag
      • firstSentenceTags

        public Tag[] firstSentenceTags()
        Return the first sentence of the comment as an array of tags. Includes inline tags (i.e. {@link reference} tags) but not block tags. Each section of plain text is represented as a Tag of kind "Text". Inline tags are represented as a SeeTag of kind "@link". If the locale is English language, the first sentence is determined by the rules described in the Java Language Specification (first version): "This sentence ends at the first period that is followed by a blank, tab, or line terminator or at the first tagline.", in addition a line will be terminated by paragraph and section terminating HTML tags: <p> </p> <h1> <h2> <h3> <h4> <h5> <h6> <hr> <pre> or </pre>. If the locale is not English, the sentence end will be determined by BreakIterator.getSentenceInstance(Locale).
        Specified by:
        firstSentenceTags in interface Tag
        Returns:
        an array of Tag objects representing the first sentence of the comment
      • position

        public SourcePosition position()
        Return the source position of this tag.
        Specified by:
        position in interface Tag
        Returns:
        the source position of this tag.