|
Doclet API | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
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).
SeeTag,
ParamTag,
ThrowsTag,
SerialFieldTag,
Doc.tags()| Method Summary | |
Tag[] |
firstSentenceTags()
Return the first sentence of the comment as an array of tags. |
Doc |
holder()
Return the containing Doc of this Tag element. |
Tag[] |
inlineTags()
For a documentation comment with embedded {@link}
tags, return an array of Tag objects. |
String |
kind()
Return the kind of this tag. |
String |
name()
Return the name of this tag. |
SourcePosition |
position()
Return the source position of this tag. |
String |
text()
Return the text of this tag, that is, portion beyond tag name. |
String |
toString()
Convert this object to a string. |
| Method Detail |
public String name()
@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 Doc holder()
Doc of this Tag element.
public String kind()
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 String text()
public String toString()
public Tag[] inlineTags()
{@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 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:
Tag with name "Text" and text consisting
of "This is a "
SeeTag with name "@link", referenced
class Doc and label "commentlabel"
Tag with name "Text" and text consisting
of " example."
ParamTag,
ThrowsTagpublic Tag[] firstSentenceTags()
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
java.text.BreakIterator.getSentenceInstance(Locale).
Tag objects representing the
first sentence of the commentpublic SourcePosition position()
|
Doclet API | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||