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

2018/01/01Java基础学习——如何通过dos系统的javadoc命令生成API文档

2018-01-01 11:02 916 查看
通常在Java原程序中插入类似这样的注释,/** ... ... */这样的格式可以通过Javados命令生成doc帮助文档。代码案例如下:

1 import java.util.Arrays;
2
3 /**
4  * Description
5  * <br> this's a test class
6  * Created by test on 2017/2/7.
7  * @author MisJersion
8  * @version 1.8
9  */
10 public class HelloWorld{
11        public static void fill(int[][] array) {
12             /**
13              * 执行赋值操作
14              */
15             for (int i = 0; i < array.length; i++) {
16                 for (int j = 0; j < array[i].length; j++) {
17                     array[i][j] = (int) (Math.random()*100);
18                 }
19             }
20         }
21         public static void sort(int[][] array) {
22             /**
23              * 先把二维数组使用System.arraycopy进行数组复制到一个一维数组
24              * 然后使用sort进行排序
25              * 最后再复制回到二维数组。
26              */
27             int[] a = new int[array.length * array[0].length];
28             int b = 0;
29             int c = 0;
30             for (int i = 0; i < array.length; i++) {
31                 System.arraycopy(array[i],0,a,b,array[i].length);
32                 b += array[i].length;
33             }
34             Arrays.sort(a);
35             System.out.println(Arrays.toString(a));
36             for (int i = 0; i < array.length; i++) {
37                 System.arraycopy(a,c,array[i],0,array[i].length);
38                 c += array[i].length;
39                 System.out.println(Arrays.toString(array[i]));
40             }
41         }
42         public static void main(String[] args) {
43             int[][] a = new int[5][8];
44             fill(a);
45             sort(a);
46         }
47 }


下面讲解如何生成doc帮助文档

方法一:

打开dos界面:win + R, 然后输入cmd

拿我自己的.java路径来举例,输入:E:+enter

输入:cd E:\project\j2se\src,然后enter

javadoc 类名.java,然后enter

打开根目录E:\project\j2se\src,找到index.html索引网页,双击打开,就可以查看了

点击其中的类,可以看到相应类的信息,如你设置的版本、作者,还可以看到继承的类等信息,有助于快速了解源代码

  方法一的优点是快速,其实还有一种更快的方式,但是建成的.HTML文件比较乱。所以推荐了下面的方法。

方法二:参考链接: 如何使用javadoc命令生成api文档、文档注释

第一步方法同『方法一』的前三步

创建api文件,进行文档生成:输入『javadoc -d javaapi -header 测试的API -doctitle 这是我的第一个文档注释 -version -author 类名.java』

打开根目录E:\project\j2se\src:可以看到生成了一个文件夹javaapi,这样就不乱了。

  


  【note注意】上述的类名.java在这里是HelloWorld.java。
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: