第4天 JavaDoc生成文档&Java流程控制（第一节：用户交互Scanner）

JavaDoc生成文档

javadoc命令是用来生成自己的API文档

参数信息：

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

package com.kuang.base;

/**
 * @author
 * @version
 * @since
 */
public class Doc {
    String name;

    /**
     *
     * @param name
     * @return
     */
    public  String test(String name){      //在上面直接输入/**  回车即可自动填写信息
        return name;
    }

    //老师通过命令行生成javadoc    javadoc              参数             Java 文件
                              //javadoc -encoding UTF-8 -charset UTF-8 Doc.java
    //作业：学会用IDEA生成JavaDoc文档     面向百度编程
    //基础部分的一切知识，后面每天都会用！！！！！
}

官方的API文档：百度搜索jdk帮助文档选择官方的网址，即可进入选择自己的版本 8得到下面网址

https://docs.oracle.com/javase/8/docs/api/

3.用DOS 生成一个javadoc 在java文件所在目录打开cmd，输入

javadoc -encoding UTF-8 -charset UTF-8 Doc.java

打开index.html 即是他的首页

用IDEA生成JavaDoc（引自：https://www.cnblogs.com/xiaoming0601/p/6657136.html）

IDEA 的 JavaDoc 生成功能在菜单 Tools->Generate JavaDoc 项里面。
点击上述菜单项后，会出现生成 JavaDoc 的对话框，一般的选项都很直观，不必细说。但是要注意生成 JavaDoc 的源代码对象的选择，一般以模块（Module）为主，必要时可以单独选择必要的 Java 源代码文件，不推荐以 PRoject 为 JavaDoc 生成的源范围。
里面有一个 Locale 可选填项，表示的是需要生成的 JavaDoc 以何种语言版本展示，根据 javadoc.exe 的帮助说明，这其实对应的就是 javadoc.exe 的 -locale 参数，如果不填，默认可能是英文或者是当前操作系统的语言，既然是国人，建议在此填写 zh_CN，这样生成的 JavaDoc 就是中文版本的，当然指的是 JavaDoc 的框架中各种通用的固定显示区域都是中文的。你自己编写的注释转换的内容还是根据你注释的内容来。
还有一个“Other command line arguments:”可选填项，非常重要，是填写直接向 javadoc.exe 传递的参数内容。因为有一些重要的设置，只能通过直接参数形式向 javadoc.exe 传递。这里必须要填写如下参数：

-encoding UTF-8 -charset UTF-8 -windowtitle "你的文档在浏览器窗口标题栏显示的内容" -link http://docs.Oracle.com/javase/7/docs/api
第一个参数 -encoding UTF-8 表示你的源代码（含有符合 JavaDoc 标准的注释）是基于 UTF-8 编码的，以免处理过程中出现中文等非英语字符乱码；第二个参数 -charset UTF-8 表示在处理并生成 JavaDoc 超文本时使用的字符集也是以 UTF-8 为编码，目前所有浏览器都支持 UTF-8，这样最具有通用性，支持中文非常好；第三个参数 -windowtitle 表示生成的 JavaDoc 超文本在浏览器中打开时，浏览器窗口标题栏显示的文字内容；第四个参数 -link 很重要，它表示你生成的 JavaDoc 中涉及到很多对其他外部 Java 类的引用，是使用全限定名称还是带有超链接的短名称，举个例子，我创建了一个方法 public void func(String arg)，这个方法在生成 JavaDoc 时如果不指定 -link 参数，则 JavaDoc 中对该方法的表述就会自动变为 public void func(java.lang.String arg)，因为 String 这个类对我自己实现的类来讲就是外部引用的类，虽然它是 Java 标准库的类。如果指定了 -link http://docs.oracle.com/javase/7/docs/api 参数，则 javadoc.exe 在生成 JavaDoc 时，会使用 String 这样的短名称而非全限定名称 java.lang.String，同时自动为 String 短名称生成一个超链接，指向官方 JavaSE 标准文档 http://docs.oracle.com/javase/7/docs/api 中对 String 类的详细文档地址。-link 实质上是告诉 javadoc.exe 根据提供的外部引用类的 JavaDoc 地址去找一个叫 package-list 的文本文件，在这个文本文件中包含了所有外部引用类的全限定名称，因此生成的新 JavaDoc 不必使用外部引用类的全限定名，只需要使用短名称，同时可以自动创建指向其外部引用 JavaDoc 中的详细文档超链接。每个 JavaDoc 都会在根目录下有一个 package-list 文件，包括我们自己生成的 JavaDoc。

　　JavaDoc 生成完毕，即可在其根目录下找到 index.html 文件，打开它就可以看到我们自己的标准 JavaDoc API 文档啦。

Java流程控制

用户交互Scanner

可以获取用户的输入 java.until.Scanner 通过Scanner来获取用户的输入
基本语法： Scanner s = new Scanner(System.in)
通过Scanner 类的next（）与nextLine（）方法获取输入的字符串，在读取我们一般需要使用hasNext（）与hasnextLine（）判断是否还有输入的数据

next()

一定要读取到有效字符后才可以结束输入
对输入有效字符之前遇到的空白，next（）方法会自动将其去掉
只有输入有效字符后才将其后面输入的空白作为分隔符或者结束符
next（）不能得到带有空格的字符串

package com.kuang.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); //输入hello world   输出为hello
        }
        //凡是属于IO流的类，如果不关闭会一直占用资源，要养成良好的习惯
        scanner.close();
    }
}

nextLine（）

1.以Enter为结束符，也就是说next Line（）方法返回的是输入回车之前所有的字符串。
可以获得空白

package com.kuang.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);   //输入hello world  输出hello world
        }
        scanner.close();
    }
}

package com.kuang.scanner;

import java.util.Scanner;

public class Demo05 {
    public static void main(String[] args) {
        //我们可以输入多个数字，并求和与平均数，每输入一个数字用回车确认，通过输入非数字来结束并输出执行结果
        Scanner scanner = new Scanner(System.in);
        //和
        double sum = 0;
        //计算输入多少个数字
        int m = 0;
        System.out.println("请输入你的数据：");
        //通过循环判断是否还有数据输入，并在里面对每一次进行球和统计
        while (scanner.hasNextDouble()){
            double x =scanner.nextDouble();

            m = m+1;  //m++
            sum = sum + x;
            System.out.println("你输入了第" + m + "个数据，" + "当前结果为：" + sum);
        }

        System.out.println(m + "个数的和为： " + sum);
        System.out.println(m + "个数的平均数为：" + (sum/m));
        scanner.close();
    }
}

顺序结构

从上到下按顺序进行

package com.kuang.struct;

public class ShuXuDemo {
    public static void main(String[] args) {
        System.out.println("hello1");
        System.out.println("hello2");
        System.out.println("hello3");
        System.out.println("hello4");
        System.out.println("hello5");

选择结构

if单选择结构：

package com.kuang.struct;

import java.util.Scanner;

public class IfDemo01 {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        System.out.println("请输入内容：");
        String s = scanner.nextLine();
        
        if (s.equals("Hello")){
            System.out.println(s);
        }
        System.out.println("End");
        scanner.close();
    }
}

if双选择结构：

package com.kuang.struct;

import java.util.Scanner;

public class IfDemo02 {
    public static void main(String[] args) {
        //考试大于60及格，小于60不及格
        Scanner scanner = new Scanner(System.in);
        System.out.println("请输入你的分数：");
        double v = scanner.nextDouble();
        if (v >60){
            System.out.println("你的成绩为："+ v + "成绩已及格");
         }else {
            System.out.println("你的成绩为："+ v + "很抱歉，你的成绩未及格");
        }
        scanner.close();
    }
}

if多选择结构：

package com.kuang.struct;

import java.util.Scanner;

public class IfDemo03 {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        System.out.println("请输入你的成绩");
        double score = scanner.nextDouble();
        if (score==100){
            System.out.println("满分");
        }else if (score<100 && score>=90){
            System.out.println("优秀");
        }else if (score<90 && score>=80){
            System.out.println("良");
        }else if (score<80 && score>=70){
            System.out.println("中");
        }else if (score<70 && score>=60){
            System.out.println("差");
        }else if (score<00 && score>=0){
            System.out.println("不及格");
        }else{
            System.out.println("输入数据不合法！！,满分为100分，请正确输入！");
        }
        scanner.close();
    }
}

嵌套的if结构

作业：查找1-100之间的数（1-50 50-100）

Switch多选择结构
多选择结构还有一个实现方式就是switch case语句
switch case 语句是判断一个变量与一系列值中某个值是否相等，，每一个值为一个分支

Switch(expression){
    case value:
    	//语句
    	break;//可选
    case value:
    	//语句
    	break;//可选
    //你可以有任意数量的case语句
    default://可选
    	//语句
}

switch 语句中的变量类型可以是：
- byte short int 或者char
- 从JavaSE7开始支持String类型了
- 同时case标签必须为字符串常量或者字面量

运行实例及java反编译

package com.kuang.struct;

import java.util.Scanner;

public class SwitchDemo02 {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        System.out.println("请输入你的名字");
        String name = scanner.next();
        //JDK的新特性，表达式结果可以是字符串
        //字符串的本质还是数字
        //反编译  Java..变为..class(字节码文件) ----反编译（用IDEA就可以实现）
        /**
         * IDEA反编译方法：打开代码out文件夹姜class文件考入对应代码
         * java文件夹即可用IDEA查看，反编译结束
         */
        switch (name){
            case "秦将":
                System.out.println("秦将");
                break;
            case "狂神":
                System.out.println("狂神");
                break;
            default:
                System.out.println("你干啥呢？");
        }
    }
}

posted @ 2021-07-29 15:18 Ariesmark 阅读(106) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

跟着遇见狂神说学JAVA

怂人面前全是坎，骏马面前无沟壑

第4天 JavaDoc生成文档&Java流程控制（第一节：用户交互Scanner）

JavaDoc生成文档

Java流程控制

公告