JavaDoc的学习

JavaDoc的学习

JavaDoc命令是用来生成自己API文档的

什么是API

API就是帮助文档

下面给出Java jdk的api连接

jdk api

参数信息

  • @author
  • @version
  • @since 指明需要最早使用的jdk版本
  • @param 参数名
  • @return 返回值情况
  • @throws 异常抛出情况

实际操作一波

package com.Gemin.base;

/**
 * @author Gemin
 * @version 1.0
 * @since  14.0.2
 */
public class Doc {
    public String name;

    /**
     *
     * @author Gemin
     * @param name
     * @return String
     * @throws Exception
     */

    public String getname(String name)throws Exception{
        return name;
    }
}

上面是自己随便写的一段代码,没有意义,只是为了演示生成的api

-encoding UTF-8是让文档中的中文字符按UTF-8编码

-charset UTF-8 是让文档中的字符串按UTF-8编码

最后的Doc.java是该java文档的文件名

然后我们就可以看到源文件的文件夹下多了好多文件

选择index.html 打开就可以看到我们自己生成的api文档

posted @ 2020-09-18 21:20  Gemin_Chang  阅读(101)  评论(0)    收藏  举报