public final class TagElement extends ASTNode implements IDocElement
TagElement: [ @ Identifier ] { DocElement } DocElement: TextElement Name MethodRef MemberRef { TagElement }
Javadoc
Modifier and Type | Field and Description |
---|---|
static ChildListPropertyDescriptor |
FRAGMENTS_PROPERTY
The "fragments" structural property of this node type (element type:
IDocElement ). |
static String |
TAG_AUTHOR
Standard doc tag name (value "@author").
|
static String |
TAG_CODE
Standard inline doc tag name (value "@code").
|
static String |
TAG_DEPRECATED
Standard doc tag name (value "@deprecated").
|
static String |
TAG_DOCROOT
Standard inline doc tag name (value "@docRoot").
|
static String |
TAG_EXCEPTION
Standard doc tag name (value "@exception").
|
static String |
TAG_INHERITDOC
Standard inline doc tag name (value "@inheritDoc").
|
static String |
TAG_LINK
Standard inline doc tag name (value "@link").
|
static String |
TAG_LINKPLAIN
Standard inline doc tag name (value "@linkplain").
|
static String |
TAG_LITERAL
Standard inline doc tag name (value "@literal").
|
static SimplePropertyDescriptor |
TAG_NAME_PROPERTY
The "tagName" structural property of this node type (type:
String ). |
static String |
TAG_PARAM
Standard doc tag name (value "@param").
|
static String |
TAG_RETURN
Standard doc tag name (value "@return").
|
static String |
TAG_SEE
Standard doc tag name (value "@see").
|
static String |
TAG_SERIAL
Standard doc tag name (value "@serial").
|
static String |
TAG_SERIALDATA
Standard doc tag name (value "@serialData").
|
static String |
TAG_SERIALFIELD
Standard doc tag name (value "@serialField").
|
static String |
TAG_SINCE
Standard doc tag name (value "@since").
|
static String |
TAG_THROWS
Standard doc tag name (value "@throws").
|
static String |
TAG_VALUE
Standard inline doc tag name (value "@value").
|
static String |
TAG_VERSION
Standard doc tag name (value "@version").
|
ANNOTATION_TYPE_DECLARATION, ANNOTATION_TYPE_MEMBER_DECLARATION, ANONYMOUS_CLASS_DECLARATION, ARRAY_ACCESS, ARRAY_CREATION, ARRAY_INITIALIZER, ARRAY_TYPE, ASSERT_STATEMENT, ASSIGNMENT, BLOCK, BLOCK_COMMENT, BOOLEAN_LITERAL, BREAK_STATEMENT, CAST_EXPRESSION, CATCH_CLAUSE, CHARACTER_LITERAL, CLASS_INSTANCE_CREATION, COMPILATION_UNIT, CONDITIONAL_EXPRESSION, CONSTRUCTOR_INVOCATION, CONTINUE_STATEMENT, CREATION_REFERENCE, DIMENSION, DO_STATEMENT, EMPTY_STATEMENT, ENHANCED_FOR_STATEMENT, ENUM_CONSTANT_DECLARATION, ENUM_DECLARATION, EXPRESSION_METHOD_REFERENCE, EXPRESSION_STATEMENT, FIELD_ACCESS, FIELD_DECLARATION, FOR_STATEMENT, IF_STATEMENT, IMPORT_DECLARATION, INFIX_EXPRESSION, INITIALIZER, INSTANCEOF_EXPRESSION, INTERSECTION_TYPE, JAVADOC, LABELED_STATEMENT, LAMBDA_EXPRESSION, LINE_COMMENT, MALFORMED, MARKER_ANNOTATION, MEMBER_REF, MEMBER_VALUE_PAIR, METHOD_DECLARATION, METHOD_INVOCATION, METHOD_REF, METHOD_REF_PARAMETER, MODIFIER, NAME_QUALIFIED_TYPE, NORMAL_ANNOTATION, NULL_LITERAL, NUMBER_LITERAL, ORIGINAL, PACKAGE_DECLARATION, PARAMETERIZED_TYPE, PARENTHESIZED_EXPRESSION, POSTFIX_EXPRESSION, PREFIX_EXPRESSION, PRIMITIVE_TYPE, PROTECT, QUALIFIED_NAME, QUALIFIED_TYPE, RECOVERED, RETURN_STATEMENT, SIMPLE_NAME, SIMPLE_TYPE, SINGLE_MEMBER_ANNOTATION, SINGLE_VARIABLE_DECLARATION, STRING_LITERAL, SUPER_CONSTRUCTOR_INVOCATION, SUPER_FIELD_ACCESS, SUPER_METHOD_INVOCATION, SUPER_METHOD_REFERENCE, SWITCH_CASE, SWITCH_STATEMENT, SYNCHRONIZED_STATEMENT, TAG_ELEMENT, TEXT_ELEMENT, THIS_EXPRESSION, THROW_STATEMENT, TRY_STATEMENT, TYPE_DECLARATION, TYPE_DECLARATION_STATEMENT, TYPE_LITERAL, TYPE_METHOD_REFERENCE, TYPE_PARAMETER, UNION_TYPE, VARIABLE_DECLARATION_EXPRESSION, VARIABLE_DECLARATION_FRAGMENT, VARIABLE_DECLARATION_STATEMENT, WHILE_STATEMENT, WILDCARD_TYPE
Modifier and Type | Method and Description |
---|---|
List |
fragments()
Returns the live list of fragments in this tag element.
|
String |
getTagName()
Returns this node's tag name, or
null if none. |
boolean |
isNested()
Returns whether this tag element is nested within another
tag element.
|
static List |
propertyDescriptors(int apiLevel)
Returns a list of structural property descriptors for this node type.
|
void |
setTagName(String tagName)
Sets the tag name of this node to the given value.
|
accept, copySubtree, copySubtrees, delete, equals, getAST, getFlags, getLength, getLocationInParent, getNodeType, getParent, getProperty, getRoot, getStartPosition, getStructuralProperty, hashCode, nodeClassForType, properties, setFlags, setProperty, setSourceRange, setStructuralProperty, structuralPropertiesForType, subtreeBytes, subtreeMatch, toString
public static final SimplePropertyDescriptor TAG_NAME_PROPERTY
String
).public static final ChildListPropertyDescriptor FRAGMENTS_PROPERTY
IDocElement
).public static final String TAG_AUTHOR
public static final String TAG_CODE
Note that this tag first appeared in J2SE 5.
public static final String TAG_DEPRECATED
public static final String TAG_DOCROOT
public static final String TAG_EXCEPTION
public static final String TAG_INHERITDOC
public static final String TAG_LINK
public static final String TAG_LINKPLAIN
public static final String TAG_LITERAL
Note that this tag first appeared in J2SE 5.
public static final String TAG_PARAM
public static final String TAG_RETURN
public static final String TAG_SEE
public static final String TAG_SERIAL
public static final String TAG_SERIALDATA
public static final String TAG_SERIALFIELD
public static final String TAG_SINCE
public static final String TAG_THROWS
public static final String TAG_VALUE
public static final String TAG_VERSION
public static List propertyDescriptors(int apiLevel)
apiLevel
- the API level; one of the
AST.JLS*
constantsStructuralPropertyDescriptor
)public String getTagName()
null
if none.
For top level doc tags such as parameter tags, the tag name
includes the "@" character ("@param").
For inline doc tags such as link tags, the tag name
includes the "@" character ("@link").
The tag name may also be null
; this is used to
represent the material at the start of a doc comment preceding
the first explicit tag.null
if nonepublic void setTagName(String tagName)
null
; this is used to
represent the material at the start of a doc comment preceding
the first explicit tag.tagName
- the tag name, or null
if nonepublic List fragments()
The fragments cover everything following the tag name
(or everything if there is no tag name), and generally omit
embedded line breaks (and leading whitespace on new lines,
including any leading "*"). TagElement
nodes are used to represent tag elements (e.g., "@link")
nested within this tag element.
Here are some typical examples:
Adding and removing nodes from this list affects this node
dynamically. The nodes in this list may be of various
types, including TextElement
,
TagElement
, Name
,
MemberRef
, and MethodRef
.
Clients should assume that the list of types may grow in
the future, and write their code to deal with unexpected
nodes types. However, attempts to add a non-proscribed type
of node will trigger an exception.
IDocElement
)public boolean isNested()
This convenience methods checks to see whether the parent
of this node is of type TagElement
.
true
if this node is a nested tag element,
and false if this node is either parented by a doc comment node
(Javadoc
), or is unparented
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.