Package org.jboss.jdeparser

Class AbstractJDocComment

java.lang.Object

org.jboss.jdeparser.AbstractJComment

org.jboss.jdeparser.AbstractJHtmlComment

org.jboss.jdeparser.AbstractJDocComment

All Implemented Interfaces:

JComment, JDocComment, JHtmlComment, Writable

Direct Known Subclasses:

ImplJDocComment, NestedDocCommentContent

abstract class AbstractJDocComment
extends AbstractJHtmlComment
implements JDocComment

Field Summary

Fields

Modifier and Type	Field	Description
private Map<String,List<DocTagJHtmlComment>>	docTags

Fields inherited from class org.jboss.jdeparser.AbstractJComment

CLOSE_PAREN_CONTENT, COMMA_CONTENT, DOC_ROOT_CONTENT, HASH_CONTENT, NL_CONTENT, OPEN_PAREN_CONTENT

Constructor Summary

Constructors

Constructor	Description
AbstractJDocComment()

Method Summary

Modifier and Type	Method	Description
JHtmlComment	_return()	Add a @return tag.
JHtmlComment	_throws(JType exceptionType)	Add a @throws tag.
JDocComment	block()	Add a comment sub-block at this location.
JDocComment	br()	Add a line separator.
JDocComment	docRoot()	Add the {@docRoot} tag at this position.
JHtmlComment	docTag(String tag)	Add a block tag.
JHtmlComment	docTag(String tag, String firstWord)	Add a block tag.
(package private) Map<String,List<DocTagJHtmlComment>>	getDocTags()
JDocComment	inlineDocTag(String tag, String body)	Add an inline doc tag with simple content.
JDocComment	nl()	Add a newline.
JDocComment	p()	Add a paragraph separator.
JHtmlComment	param(String name)	Add a @param tag.
JDocComment	sp()	Add a non-trailing space.
JDocComment	text(String text)	Add some text to the end of this comment.
JDocComment	typeName(JType type)	Add a type name to the end of this comment.
JDocComment	value(JType type, String fieldName)	Add a @value inline tag.

Methods inherited from class org.jboss.jdeparser.AbstractJHtmlComment

add, htmlLink, htmlTag, preformattedCode

Methods inherited from class org.jboss.jdeparser.AbstractJComment

add, addItemDirectly, code, getContent, inlineDocTag, linkConstructor, linkField, linkMethod, linkMethod, linkType, write

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jboss.jdeparser.JComment

code, linkConstructor, linkField, linkMethod, linkMethod, linkType

Methods inherited from interface org.jboss.jdeparser.JDocComment

inlineDocTag

Methods inherited from interface org.jboss.jdeparser.JHtmlComment

htmlLink, htmlTag, preformattedCode

Field Details

docTags

private Map<String,List<DocTagJHtmlComment>> docTags

Constructor Details

AbstractJDocComment

AbstractJDocComment()

Method Details

block

public JDocComment block()

Description copied from interface: JComment

Add a comment sub-block at this location. The block has no visual representation but allows text to be inserted at the point of the block even after more content was appended after it.

Specified by:

block in interface JComment

Specified by:

block in interface JDocComment

Specified by:

block in interface JHtmlComment

Overrides:

block in class AbstractJHtmlComment

Returns:

the comment sub-block

sp

public JDocComment sp()

Description copied from interface: JComment

Add a non-trailing space. If no content follows, the space will be omitted.

Specified by:

sp in interface JComment

Specified by:

sp in interface JDocComment

Specified by:

sp in interface JHtmlComment

Overrides:

sp in class AbstractJHtmlComment

Returns:

this comment

nl

public JDocComment nl()

Description copied from interface: JComment

Add a newline.

Specified by:

nl in interface JComment

Specified by:

nl in interface JDocComment

Specified by:

nl in interface JHtmlComment

Overrides:

nl in class AbstractJHtmlComment

Returns:

this comment

typeName

public JDocComment typeName(JType type)

Description copied from interface: JComment

Add a type name to the end of this comment. If the type is imported, it will emit as a simple name, otherwise it will emit as a qualified name.

Specified by:

typeName in interface JComment

Specified by:

typeName in interface JDocComment

Specified by:

typeName in interface JHtmlComment

Overrides:

typeName in class AbstractJHtmlComment

Parameters:

type - the type name to add

Returns:

this comment

text

public JDocComment text(String text)

Description copied from interface: JComment

Add some text to the end of this comment. No formatting or line breaks are inserted.

Specified by:

text in interface JComment

Specified by:

text in interface JDocComment

Specified by:

text in interface JHtmlComment

Overrides:

text in class AbstractJHtmlComment

Parameters:

text - the text to add

Returns:

this comment

inlineDocTag

public JDocComment inlineDocTag(String tag,
 String body)

Description copied from interface: JComment

Add an inline doc tag with simple content.

Specified by:

inlineDocTag in interface JComment

Specified by:

inlineDocTag in interface JDocComment

Specified by:

inlineDocTag in interface JHtmlComment

Overrides:

inlineDocTag in class AbstractJHtmlComment

Parameters:

tag - the tag name (without the leading @ sign)

body - the complete tag body

Returns:

this comment

docRoot

public JDocComment docRoot()

Description copied from interface: JComment

Add the {@docRoot} tag at this position.

Specified by:

docRoot in interface JComment

Specified by:

docRoot in interface JDocComment

Specified by:

docRoot in interface JHtmlComment

Overrides:

docRoot in class AbstractJHtmlComment

Returns:

this comment

p

public JDocComment p()

Description copied from interface: JHtmlComment

Add a paragraph separator.

Specified by:

p in interface JDocComment

Specified by:

p in interface JHtmlComment

Overrides:

p in class AbstractJHtmlComment

Returns:

this HTML comment

br

public JDocComment br()

Description copied from interface: JHtmlComment

Add a line separator.

Specified by:

br in interface JDocComment

Specified by:

br in interface JHtmlComment

Overrides:

br in class AbstractJHtmlComment

Returns:

this HTML comment

value

public JDocComment value(JType type,
 String fieldName)

Description copied from interface: JHtmlComment

Add a @value inline tag.

Specified by:

value in interface JDocComment

Specified by:

value in interface JHtmlComment

Overrides:

value in class AbstractJHtmlComment

Parameters:

type - the value type

fieldName - the value field name

Returns:

this HTML comment

docTag

public JHtmlComment docTag(String tag)

Description copied from interface: JDocComment

Add a block tag.

Specified by:

docTag in interface JDocComment

Parameters:

tag - the tag name

Returns:

the block tag comment block

docTag

public JHtmlComment docTag(String tag,
 String firstWord)

Description copied from interface: JDocComment

Add a block tag.

Specified by:

docTag in interface JDocComment

Parameters:

tag - the tag name

firstWord - the tag body first word

Returns:

the block tag comment block

_return

public JHtmlComment _return()

Description copied from interface: JDocComment

Add a @return tag.

Specified by:

_return in interface JDocComment

Returns:

the tag body

_throws

public JHtmlComment _throws(JType exceptionType)

Description copied from interface: JDocComment

Add a @throws tag.

Specified by:

_throws in interface JDocComment

Parameters:

exceptionType - the type of exception

Returns:

the tag body

param

public JHtmlComment param(String name)

Description copied from interface: JDocComment

Add a @param tag.

Specified by:

param in interface JDocComment

Parameters:

name - the parameter name

Returns:

the tag body

getDocTags

Map<String,List<DocTagJHtmlComment>> getDocTags()