昨日作业
- 打开IDEA，找到doc类
- 在IDEA菜单栏找到工具（tools）选项，选择生成JavaDoc（GenerateJavaDoc）
- 在弹出的对话框中设置JavaDoc作用域，整个项目、模块、文件（类）或者自定义
- 设置输出目录，选择用于保存JavaDoc文件的文件夹
- 在区域设置中，可根据需求选择语言，如“zh”表示中文
- 在命令行实参中，输入“-encoding UFT-8 -charset UFT-8",以确保中文输出无乱码，如有其他需求还可添加”-windowtitle"指定窗口标题、"-link"指定外部链接等参数
- 设置完成后点击生成，即可根据JaveDoc注释生成相应的文档
- 打开设置的输出目录，打开"index.html"文件，即可查看生成的JavaDoc文档
常用JavaDoc标签：
- 基础信息类：
- @author 作者名
- @version 版本号
- @since 指明需要最早使用的jdk版本
- 功能说明类：
- @use 用途说明
- @param 参数名
- @return 返回值情况
- @throws 异常抛出情况
- 状态标识类：
- @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():
- 一定要读取到有效字符后才可以结束输入。//scanner close();
- 对输入有效字符之前遇到的空白，next()方法会自动将其去掉。
- 只有输入有效字符后才将其后面输入的空白作为分隔符或者结束符。
- 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=EnterSystem.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():
- 以Enter为结束符，也就是说nextLine()方法返回的是输入回车之前的所有字符。
- 可以获得空白。
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
本文摘要：
- 介绍了使用IDEA生成JavaDoc文档的详细步骤，包括设置作用域、输出目录、语言编码等参数
- 列举了常用JavaDoc标签，分为基础信息类、功能说明类和状态标识类三大类
- 讲解了Java流程控制中的Scanner对象使用，比较了next()和nextLine()方法的区别
- 通过代码示例演示了如何接收用户输入，强调next()不能获取带空格的字符串而nextLine()可以
- 提醒使用IO流类后要及时关闭资源