Day14-20251208

昨日作业

1. 打开IDEA，找到doc类
2. 在IDEA菜单栏找到工具（tools）选项，选择生成JavaDoc（GenerateJavaDoc）
3. 在弹出的对话框中设置JavaDoc作用域，整个项目、模块、文件（类）或者自定义
4. 设置输出目录，选择用于保存JavaDoc文件的文件夹
5. 在区域设置中，可根据需求选择语言，如“zh”表示中文
6. 在命令行实参中，输入“-encoding UFT-8 -charset UFT-8",以确保中文输出无乱码，如有其他需求还可添加”-windowtitle"指定窗口标题、"-link"指定外部链接等参数
7. 设置完成后点击生成，即可根据JaveDoc注释生成相应的文档
8. 打开设置的输出目录，打开"index.html"文件，即可查看生成的JavaDoc文档

常用JavaDoc标签：

1. 基础信息类：

• @author 作者名
• @version 版本号
• @since 指明需要最早使用的jdk版本

2. 功能说明类：

• @use 用途说明
• @param 参数名
• @return 返回值情况
• @throws 异常抛出情况

3. 状态标识类：

• @deprecated 已过时，标注该类方法已不再使用需说明替代方案
• @see参考链接

以上标签写在代码的注释块中，生成JavaDoc时会自动整理成此结构化的文档

Java流程控制

用户交互scanner

顺序结构

选择结构

循环结构

break&continue

练习

Scanner对象

• 之前我们学的基本语法中我们并没有实现程序和人的交互，但是Java给我们提供了这样一个工具类，我们可以获取用户的输入。java.util.Scanner是Java5的新特征，我们可以通过Scanner类来获取用户的输入。
• 基本语法：

Scanner s = new Scanner(System.in);

• 通过Scanner类的next()与nextLine()方法获取输入的字符串，在读取前我们一般需要使用hasNext()与hasNextLine()判断是否还有输入的数据。

util：工具包

next():

1. 一定要读取到有效字符后才可以结束输入。//scanner close();
2. 对输入有效字符之前遇到的空白，next()方法会自动将其去掉。
3. 只有输入有效字符后才将其后面输入的空白作为分隔符或者结束符。
4. next()不能得到带有空格的字符。

package com.jiaguangqing.scanner;

import java.util.Scanner;

public class Demo01 {
    public static void main(String[] args){

        //创建一个扫描器对象，用于接收键盘数据
        Scanner scanner = new Scanner(System.in);//Ctrl+Alt+V\ALT=Enter

        System.out.println("使用next方式接受:");

        //判断用户有没有输入字符串
        if (scanner.hasNext()==true){//==true可省略
            //使用next方式接收
            String str = scanner.next();//程序会等待用户输入完毕
            System.out.println("输出的内容为:"+str);
        }
        //凡是属于IO流的类如果不关闭会一直占用资源，要养成好习惯用完就关掉
        scanner.close();//IO流：输入输出流

    }

}

输出：

使用next方式接受:
Hello World!
输出的内容为:Hello

进程已结束，退出代码为 0

nextLine():

1. 以Enter为结束符，也就是说nextLine()方法返回的是输入回车之前的所有字符。
2. 可以获得空白。

package com.jiaguangqing.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()){
                String str = scanner.nextLine();
                System.out.println("输出的内容为："+str);
        }

        scanner.close();
    }
}

输出：

使用nextLine方式接收：
Hello World!
输出的内容为：Hello World!

进程已结束，退出代码为 0

随堂代码：

package com.jiaguangqing.scanner;

import java.util.Scanner;

public class Demo03 {
    public static void main(String[] args) {
        //从键盘接收数据
        Scanner scanner = new Scanner(System.in);

        System.out.println("请输入数据：");

        String str = scanner.nextLine();

        System.out.println("输出的内容为："+str);

        scanner.close();




    }


}

输出：

使用nextLine方式接收：
欢迎大家来一起学习Java！ 欢迎大家来到线下学习
输出的内容为：欢迎大家来一起学习Java！ 欢迎大家来到线下学习

进程已结束，退出代码为 0

本文摘要：

1. 介绍了使用IDEA生成JavaDoc文档的详细步骤，包括设置作用域、输出目录、语言编码等参数
2. 列举了常用JavaDoc标签，分为基础信息类、功能说明类和状态标识类三大类
3. 讲解了Java流程控制中的Scanner对象使用，比较了next()和nextLine()方法的区别
4. 通过代码示例演示了如何接收用户输入，强调next()不能获取带空格的字符串而nextLine()可以
5. 提醒使用IO流类后要及时关闭资源