您的位置:首页 > 编程语言 > Java开发

java关于javadoc的那些小技巧和你需要知道的地方(一)

2017-05-04 16:43 471 查看
1.生成javadoc

生成javadoc的方法很普遍,大家在晚上找找就有

我这就转一下:http://blog.csdn.net/u011596810/article/details/50825748

方法都是一样的,没有必要在我找,我就把博主的内容给大家转过来一起看看:





最初的时候,我也很好奇它是怎么来的,就以为像平常的参考书一样,都是别人一字一笔制作出来的。但是,等我认识到javadoc这个东东的时候,我才发现,可以差不多是一键就能生成这种文档了。。。

其实缘由可以由我们最初学习Java注释的时候看出,我们都知道,Java注释分为三种:行注释(//)、段落注释(/* /)、文档注释(/* */),为什么称为文档注释?其中,其重要功能之一,便是用于生成HTML说明文档。

本文将讲解两部分:

1、使用cmd命令窗口对一个java文件进行生成文档说明

2、使用eclipse对于一个项目进行生成文档说明

1、使用cmd命令窗口对一个java文件进行生成文档说明

(1)首先,我们应该在磁盘中创建一个java文件,例如:E:\FirstJavaDoc.java

里面的大致内容如下:

/**
* 测试JavaDoc
* @author 红叶岭谷
*
*/
public class FirstJavaDoc{
public static void main(String[] args){
addFunction("Hello JavaDoc!");
}

/**
* 添加方法
* @param obj
*            所需要输出的内容
*/
public static void addFunction(Object obj) {
System.out.println(obj.toString());
}
}


(2)打开cmd命令行窗口,进入到java文件的当前路径,输入 javadoc 文件名.java



点击回车出现



就成功了

如果出现javadoc不是内部命令,请检查你的java的jdk环境配置

打开文件夹有:



打开index.html



前提是你的java文件必须是可读性的没有加密乱码之类的就可以刻

这个是HTML的,如果你觉得这样还是不够好,你可以试着将它转成chm文件,既小又好用

欢迎关注:

java关于javadoc的那些小技巧和你需要知道的地方(二)
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签:  java javadoc