包机制、JavaDoc

一、包机制

• 包就相当于文件夹
  
  
• 导包 import

package com.jacyzhu.operator;

// 导入这个包下所有的类
import com.jacyzhu.base.*;

import java.util.Date;

public class Demo01 {
    public static void main(String[] args) {
        // 二元运算符
        int a = 10;
        int b = 20;
        int c = 25;
        int d = 25;

        Date date = new Date();

        System.out.println(a+b); // 30
        System.out.println(a-b); // -10
        System.out.println(a*b); // 200
        System.out.println(a/(double)b); // 0.5

        System.out.println(date.getTime()); // 1659411151769
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

• 阿里巴巴Java开发手册各版本请点击下载

二、JavaDoc

• JavaDoc命令是用来生成自己API文档的
• 参数信息
  1. @author 作者名
  2. @version 版本号
  3. @since 指明需要最早使用的JDK版本
  4. @param 参数名
  5. @return 返回值情况
  6. @throws 异常抛出情况

package com.jacyzhu.base;

/**
 * @author jacyzhu
 * version 1.0
 * @since 1.8
 */
public class Doc {

    String name;

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

生成Doc文档的两种方法：

• 第一种：

1. 打开Dos窗口
   
2. 在Dos窗口中输入命令javadoc -encoding UTF-8 -charset UTF-8 Doc.java
   

• 第二种：

1. 点击Tool->Generate JavaDoc…
   
2. 弹出如下窗口，按照标红的地方填写信息（语言：中文：zh_CN ；输入-encoding UTF-8 -charset UTF-8，避免出现乱码），最后点击OK
   
3. 生成的文档如下：