Tagpublic interface Tag Represents a simple documentation tag, such as @since, @author, @version.
Given a tag (e.g. "@since 1.2"), holds tag name (e.g. "@since")
and tag text (e.g. "1.2"). Tags with structure or which require
special processing are handled by subclasses such as ParamTag
(for @param), SeeTag (for @see and {@link}), and ThrowsTag
(for @throws). |
Methods Summary |
---|
public com.sun.javadoc.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 {@link Tag}
of kind "Text".
Inline tags are represented as a {@link 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
{@link java.text.BreakIterator#getSentenceInstance(Locale)
java.text.BreakIterator.getSentenceInstance(Locale)}.
| public com.sun.javadoc.Doc | holder()Return the containing {@link Doc} of this Tag element.
| public com.sun.javadoc.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 {@link #text()} returns the string. Each
{@link} tag is represented by a
{@link 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 {@link Tag} with name "Text" and text consisting
of "This is a "
- tags[1] is a {@link SeeTag} with name "@link", referenced
class
Doc and label "commentlabel"
- tags[2] is a {@link Tag} with name "Text" and text consisting
of " example."
| public java.lang.String | kind()Return the kind of this tag.
similar or synonymous tags. For most tags,
kind() == name() ;
the following table lists those cases where there is more
than one tag of a given kind:
kind() | name() |
@throws | @throws |
@throws | @exception |
@see | @see |
@see | @link |
@see | @linkplain |
@serial | @serial |
@serial | @serialData |
| public java.lang.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 .
| public com.sun.javadoc.SourcePosition | position()Return the source position of this tag.
| public java.lang.String | text()Return the text of this tag, that is, portion beyond tag name.
| public java.lang.String | toString()Convert this object to a string.
|
|