栏目分类:
子分类:
返回
名师互学网用户登录
快速导航关闭
当前搜索
当前分类
子分类
实用工具
热门搜索
名师互学网 > IT > 软件开发 > 后端开发 > Java

JavaDoc生成文档(文档注释前面说注释的时候留过概念)

Java 更新时间: 发布时间: IT归档 最新发布 模块sitemap 名妆网 法律咨询 聚返吧 英语巴士网 伯小乐 网商动力

JavaDoc生成文档(文档注释前面说注释的时候留过概念)

JavaDoc生成文档(文档注释)

参数信息:

@author 作者名

@version 版本号

@since 指明需要最早使用的jdk版本

@param 参数名

@return 返回值情况

@throws 异常抛出情况

可以在网上搜:jdk帮助文档

 

 

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

IDEA里就可以写一个自己的API文档如下

 

 

除了这些,我们还可以做更多操作,比如:

抛出异常

在刚刚原来代码的基础下:

 在箭头处输入:throws Exception,如下图:

 然后再在String name;的下一行输入/**并回车得到如下

其中可以修改的内容,都在本文的最上面的参数信息里。

注意:

文档注释加在类的上面就是类的注释,加在方法的上面,就是方法的注释

文档注释加起来和注释的区别

 我们在文件夹中打开我们刚刚写的代码,

 然后会得到一堆乱七八糟

我们为了整洁要在javadoc后面输入一些代码,来保证一些报错可以省略,可以使中文显示的更加正常

javadoc -encoding UTF-8 -charset UFT-8 Doc.java

 然后发现他有警告没有说明,可以不管,有警告但是都运行了下来,生成的东西都在刚刚打开的文件夹里,这里由于演示生成了两次,文件夹会比较多

 

 这就是java生成的文档,和我们刚刚看到的java官网的jdk帮助文档差不多

 但是注意,我们生成的里面很干净

这个Doc可以点进去

 

 最终这个文档生成了,这就是用命令行生成javadoc文档

在看下一篇前我们要学会:查找使用IDEA生成javaDoc文档 ,如果不会

我们一定要学会:面向百度编程

就是有问题先百度,有困难问老师同学,这就是团体的力量,一群志同道合的人一起学习。

转载请注明:文章转载自 www.mshxw.com
本文地址:https://www.mshxw.com/it/726882.html
我们一直用心在做
关于我们 文章归档 网站地图 联系我们

版权所有 (c)2021-2022 MSHXW.COM

ICP备案号:晋ICP备2021003244-6号