com.sun.codemodel
Class JDocComment

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractList<E>
          java.util.ArrayList<java.lang.Object>
              com.sun.codemodel.JCommentPart
                  com.sun.codemodel.JDocComment

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<java.lang.Object>, java.util.Collection<java.lang.Object>, java.util.List<java.lang.Object>, java.util.RandomAccess

public class JDocComment
extends JCommentPart

JavaDoc comment.

A javadoc comment consists of multiple parts. There's the main part (that comes the first in in the comment section), then the parameter parts (@param), the return part (@return), and the throws parts (@throws). TODO: it would be nice if we have JComment class and we can derive this class from there.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

JDocComment(JCodeModel owner)

Method Summary

JCommentPart	addDeprecated() add an @deprecated tag to the javadoc, with the associated message.
JCommentPart	addParam(JVar param) Append a text to an @param tag.
JCommentPart	addParam(java.lang.String param) Append a text to a @param tag to the javadoc
JCommentPart	addReturn() Appends a text to @return tag.
JCommentPart	addThrows(java.lang.Class exception) add an @throws tag to the javadoc
JCommentPart	addThrows(JClass exception) add an @throws tag to the javadoc
java.util.Map<java.lang.String,java.lang.String>	addXdoclet(java.lang.String name) add an xdoclet.
java.util.Map<java.lang.String,java.lang.String>	addXdoclet(java.lang.String name, java.util.Map<java.lang.String,java.lang.String> attributes) add an xdoclet.
java.util.Map<java.lang.String,java.lang.String>	addXdoclet(java.lang.String name, java.lang.String attribute, java.lang.String value) add an xdoclet.
JDocComment	append(java.lang.Object o) Appends a new value.
void	generate(JFormatter f)

Methods inherited from class com.sun.codemodel.JCommentPart

add, format

Methods inherited from class java.util.ArrayList

add, addAll, addAll, clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, lastIndexOf, remove, remove, removeRange, set, size, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode, iterator, listIterator, listIterator, subList

Methods inherited from class java.util.AbstractCollection

containsAll, removeAll, retainAll, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

containsAll, equals, hashCode, iterator, listIterator, listIterator, removeAll, retainAll, subList

Constructor Detail

JDocComment

public JDocComment(JCodeModel owner)

Method Detail

append

public JDocComment append(java.lang.Object o)

Description copied from class: JCommentPart

Appends a new value. If the value is JType it will be printed as a @link tag. Otherwise it will be converted to String via Object.toString().

Overrides:

append in class JCommentPart

addParam

public JCommentPart addParam(java.lang.String param)

Append a text to a @param tag to the javadoc

addParam

public JCommentPart addParam(JVar param)

Append a text to an @param tag.

addThrows

public JCommentPart addThrows(java.lang.Class exception)

add an @throws tag to the javadoc

addThrows

public JCommentPart addThrows(JClass exception)

add an @throws tag to the javadoc

addReturn

public JCommentPart addReturn()

Appends a text to @return tag.

addDeprecated

public JCommentPart addDeprecated()

add an @deprecated tag to the javadoc, with the associated message.

addXdoclet

public java.util.Map<java.lang.String,java.lang.String> addXdoclet(java.lang.String name)

add an xdoclet.

addXdoclet

public java.util.Map<java.lang.String,java.lang.String> addXdoclet(java.lang.String name,
                                                                   java.util.Map<java.lang.String,java.lang.String> attributes)

add an xdoclet.

addXdoclet

public java.util.Map<java.lang.String,java.lang.String> addXdoclet(java.lang.String name,
                                                                   java.lang.String attribute,
                                                                   java.lang.String value)

add an xdoclet.

generate

public void generate(JFormatter f)