spoon.javadoc.internal

Class Javadoc

java.lang.Object

spoon.javadoc.internal.Javadoc

All Implemented Interfaces:

Serializable

public class Javadoc
extends Object
implements Serializable

The structured content of a single Javadoc comment.

It is composed by a description and a list of block tags.

An example would be the text contained in this very Javadoc comment. At the moment of this writing this comment does not contain any block tags (such as @see AnotherClass)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Javadoc()
Javadoc(JavadocDescription description)

Method Summary

Modifier and Type	Method and Description
Javadoc	addBlockTag(JavadocBlockTag blockTag)
Javadoc	addBlockTag(String tagName)
Javadoc	addBlockTag(String tagName, String parameter, String content) For tags like "@return good things" where tagName is "return", and the rest is content.
boolean	equals(Object o)
List<JavadocBlockTag>	getBlockTags()
JavadocDescription	getDescription()
int	hashCode()
static Javadoc	parse(String commentContent) parses the Javadoc content (description + tags)
static JavadocDescription	parseText(String text) parse the description part (before tags) of a Javadoc
String	toString()
String	toText() Return the text content of the document.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Javadoc

public Javadoc()

Javadoc

public Javadoc(JavadocDescription description)

Method Detail

addBlockTag

public Javadoc addBlockTag(JavadocBlockTag blockTag)

addBlockTag

public Javadoc addBlockTag(String tagName,
                           String parameter,
                           String content)

For tags like "@return good things" where tagName is "return", and the rest is content.

addBlockTag

public Javadoc addBlockTag(String tagName)

toText

public String toText()

Return the text content of the document. It does not containing trailing spaces and asterisks at the start of the line.

getDescription

public JavadocDescription getDescription()

getBlockTags

public List<JavadocBlockTag> getBlockTags()

Returns:

the current List of associated JavadocBlockTags

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

parseText

public static JavadocDescription parseText(String text)

parse the description part (before tags) of a Javadoc

parse

public static Javadoc parse(String commentContent)

parses the Javadoc content (description + tags)