javadoc生成文档

以前看博客最讨厌别人不加图片,难以理解,现在天天在公司一张图片都无法上传,自己都崩溃了

支持的常用标注

@author 作者

@version 版本

@since jdk版本

@param 参数说明

@return 返回值说明

@throws 抛出异常

示例代码

package com.example.demo_kuang.base;

/**
 * @author ohmydream
 * @version 1.0
 * @since 1.8
 */
public class Doc {
    String name;

    /**
     * test
     *
     * @param name
     * @return
     * @throws Exception
     */
    public String test(String name) throws Exception {
        return name;
    }
}

生成文档方法

第一种:命令行 在代码目录下输入:java -encoding UTF-8 -charset UTF-8 Doc.java

第二种:idea->Tools->Generate javaDoc…

​ 选择file

​ 选择output directory

​ other command line arguments 填入-encoding UTF-8 -charset UTF-8

​ 点击ok

在当前目录或者设置的输出目录下找到index.html 双击打开查看生成文档