包机制、JavaDoc、Scanner

包机制

• 包就像windows上的文件夹，里面可以存放文件夹或者是文件，包的机制也是这样的

• 命名规则：利用公司的域名倒置作为包名，如com.baidu.www

• 在一个包下，为了能使用另外一个包的成员，需要在java程序中明确导入该包，使用imprt

• 导入格式：import package1.package2.package…classname;从右往左都是从属关系

• 如果要导入一个包中所有的类，则在该包后加.*(通配符)，即最后一个从属包后加

• 记住，不能写在package上面，不然导入的其他包不能在该包中使用,有个主次关系

  ---

  JavaDoc 文档

  1. 先说一下API

     1. 官方解释：API（Application Programming Interface，应用程序接口）是一些预先定义的函数，或指软件系统不同组成部分衔接的约定 用来提供应用程序与开发人员基于某软件或硬件得以访问的一组例程，而又无需访问原码，或理解内部工作机制的细节。
     2. 分解：接口，对应约定，就像手机充电头如果型号不对应是无法接在一起的；一组例程，就像开锁原理；无需访问原码，不需要了解它的内部结构，会用就行，就像玩手机；API就是向用户展示它的原理，用户根据需求来调用就行，就像打开手机APP一样，APP图标就像是API，点它就会启动并运行，通过APP的内部函数来帮助用户解决问题。（哎，我觉得还是有点抽象，驾驭不了）

  2. 再说JavaDoc

     1. javadoc是Sun公司提供的一个技术，它从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。也就是说，只要在编写程序时以一套特定的标签作注释，在程序编写完成后，通过Javadoc就可以同时形成程序的开发文档了。

     2. 百度搜索jdk帮助文档，就有很多函数或类的解释

     3. JavaDoc可以帮助用户搜索，就像关键字一样；

     4. 参数信息：

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

     5. 展示效果：

        package ccc;
        
        /**
         * @author  wo
         * @version 1.8
         * @since  1.1
         */
        public class Demo09 {
            /**
             * @author  wo
             * @param name
             * @return
             * @throws Exception
             */
            public String test(String name) throws Exception{
                return name;
            }
        }
        

        可以看出，可以写在package下，也可以写在函数中

        ---

        Scanner

        • 用来获取用户输入，就像C语言中的scanf
        • 要调用java.util.Scanner才能使用

        next()函数：

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

        package 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);
                }
                scanner.close();//用完关掉，IO流的类
            }
        
        
        }
        //输入：hello world
        //输出：hello
        所以只输出第一个空格之前
        

        nextLine()

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

        ackage 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();
            }
        }
        //输入：hello world
        //输出：hello world
        

        小应用

        package 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 += 1;
                    sum = sum + x;
                    System.out.println("你输入了第" + m + "个数据，当前结果sum=" + sum);
                }
                System.out.println(m+"个数的和为"+sum);
                System.out.println(m+"个数的和平均值"+(sum /m));
                scanner.close();
            }
        }