【Java】javadoc生成文档/用户交互Scanner

javadoc生成文档

---

Java的API帮助文档:https://docs.oracle.com/javase/8/docs/api/
（可自行搜索并收藏）

• javadoc命令作用：用来生成自己的API文档

• javadoc生成的步骤

1. 自动生成参数：写好方法- >/**加回车- >自动生成
   代码如下：

public class JavaDos {
    String name;

    /**
     * 
     * @param name
     * @return
     */
    public String test(String name){
        return name;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12

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

2.打开终端

1.在"我的电脑"中打开当前ava类文件
2.快速在文件夹中打开终端：在总文件名前加上cmd+空格
3.可以右键终端上部分的，打开终端属性，调整相关布局

3. 使用javadoc命令

在终端中输入:javadoc -encoding UTF-8 -charset UTF-8 文件名.java

4. 点击文件夹中新生成的index.html，进入生成API文档

用户交互Scanner

---

• 作用：用来获取用户输入
• 声明：Scanner s = new Scanner (System.in);
• 获取输入的字符串：next()、nextLine()方法
• 判断是否还有输入数据：hasNext()、hasNextLine()

next()–最不容易出bug

1. 一定要读取到有效字符后才可以结束输入，对输入钱遇到的空白，会自动将其去掉
2. 遇到有效字符后的空白作为结束符，故next()不能得到带有空格的字符串

在这里插入代码片package Kuangshen.Scanner;

import java.util.Scanner;

public class Demo01 {

    public static void main(String[] args) {
        //创建一个扫描器对象，用于接收键盘数据
        Scanner scanner = new Scanner(System.in);

        System.out.println("使用next方式接收：");

        //判断用户有没有输入字符串
        if (scanner.hasNext()){
            //使用next方式接收
            String str = scanner.next();
            System.out.println("输出的内容为："+str);
        }

        //凡是属于IO流的类如果不关闭会一直占用资源，要养成好习惯用完关闭
        scanner.close();

    }
}

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

nextLine()

1. 返回的是输入回车之前的所以字符，故可以获得空白
2. 不需要前面的判断语句也可以输入

package Kuangshen.Scanner;

import java.util.Scanner;

public class Demo02 {

    public static void main(String[] args) {
        //创建一个扫描器对象，用于接收键盘数据
        Scanner scanner = new Scanner(System.in);

        System.out.println("使用nextLine方式接收：");

        //判断用户有没有输入字符串
//        if (scanner.hasNextLine()){
            //使用next方式接收
            String str = scanner.nextLine();
            System.out.println("输出的内容为："+str);
//        }

        //凡是属于IO流的类如果不关闭会一直占用资源，要养成好习惯用完关闭
        scanner.close();

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

hasNextDouble()

• 作用：输入一个浮点数