java文档注释


Java 支持三种注释方式。前两种分别是 // 和 /* */，第三种被称作说明注释，它以 /** 开始，以 */结束。


这里主要讲述，最后一种方法注释，因为可以使用 javadoc 工具软件来生成信息，并输出到HTML文件中。

注释方式主要有以下三种

行首注释关键字

关键字	描述
@see	引用其他类
@version	版本号
@author	作者
@since	从什么时候开始，与版本号对应
@param	参数
@return	返回值
@throws	抛出异常
@deprecated	过时
@category	种类

@see

/**
 * @see CallBack
 */

点击

@version、@author、@since

/**
 * @version 1.0
 * @author 张三
 * @since 1.0
 */

@param

@return

@throws

    /**
     * 
     * @param x 输入参数1
     * @param y 输入参数2
     * @throws Exception  
     *     
     * @return  返回值为float类型
     */

@deprecated

/**
 * 
 * @deprecated
 */

@category

行内注释关键字

关键字	描述
{@link}	引用其他类，与see功能相似，是行内用法
{@linkplain}	与{@link}，显示格式不同
{@inheritDoc}	继承父类中注释
{@docRoot}	暂时不清楚
{@value}	static final常量显示
{@code}	代码格式

{@link}、{@linkplain}

其中

/**
 * 采用栈模拟递归，具体实现了方法
 *  
{@link #next()}  与
 *  
{@linkplain #hasNext()}
 * 
 *  
 ps:其中linkplain字体更大一些
 */
public class CompositeIterator implements Iterator<Component>

点击Iterator

{@inheritDoc}

父类注释

/**
 * 抽象模板方法定义的抽象方法{@linkplain #privimitiveOperation1()}，具体模板参考{@linkplain #templateMethod()}
 */

子类注释

    /**
     * {@inheritDoc}
     * 
     * 
子类ConcreteClass实现具体抽象方法，这里简单打印一句话
     */

{@value}

    /**
     * 地点默认值：{@value}
     */
    public final static String MGMT_DISTRICT = "北京";

{@code}

/**
 * 
适配器，将Component类型适配为Iterator类型

 * 
 * 例如：
 * 
 {@code Component menu = simpleFactory();
 * Iterator it = new IteratorAdapter(menu);
 * } 
 * 
 */

常用HTML注释关键字

关键字	描述
	超链接
	粗体
	引用
	换行
	代码风格
	定义列表
	主题
	内容
	强调的内容
-	标题
	水平线
	斜体
	无序
	有序
	列表元素
	段落
	保持原有格式
	用于简短的行内引用
	更强的强调的内容。
		元素
		标题行
元素行

html都是辅助元素，用于修饰作用，具体参考html定义即可，使用什么根据个人习惯