Javadoc is the industry standard for documenting Java classes. Javadoc can be documented inside the documentation field, see figure below.
Documentation Field.
Report Wizard provides a template tool for translating Javadoc text into Javadoc properties. Javadoc tool will be loaded and used inside the template upon the user’s request.
An example of Javadoc text is shown below:
Code Block
language
text
/**
* A base class realizing from interface {@link Itool}.
* This class provides default implementation for
* {@link Itool}. The extended class from this class may
* send message or object to observer class by invoking
* {@link #notifyObservers(Object)} of class <code>
* Observable</code>. The observer class such as
* {@link AbstractTemplateEngine} or graphical user
* interface can catch notified object and interact with
* user.
*
* @author Siri Chongasamethaworn (siri_c@nomagicasia.com)
* @since Aug 3, 2007
*/
To print the Javadoc comment and author inside the template:
Comment:
A base class realizing from interface Itool. This class provides default implementation for Itool. The extended class from this class may send message or object to observer class by invoke #notifyObservers(Object) of class Observable. The observer class such as AbstractTemplateEngine or graphical user interface can catch notified object and interact with user.
Author:
Siri Chongasamethaworn (siri_c@nomagicasia.com)
