小白学java第五天

包机制，JavaDoc

java包机制

• 为了更好的组织类，Java提供了包机制，用于区别类名的空间。

  • 理解：在电脑中新建两个同名文件时会报错，但将这两个文件分别放入不同的文件夹时，就解决了问题，而包的作用，本质就是文件夹。

  • 我们一般利用公司域名倒置作为包名。

  • 为了能使用某一个包的成员，我们需要在Java程序中，明确导入该包。

    • 导入方法，import

    • import package1[package2...].(classname|*);
      //导入该包全部内容：import com.yue.base.*；
      

  Java Doc

• JavaDos命令是用来生成自己的API文档的。

• 参数信息：

  • @author ：作者名。

  • @version ：版本号。

  • @since ：指明需要使用的jdk文档。

  • @param：参数名。

  • @return：返回值情况。

  • @throws ：异常抛出情况。

  • package operator;
    
    /**
     * @author yue
     * @version 1.0
     * @since 1.8
     */
    // 这段注释将加在下方的 Demo06这个类上
    
    
    public class Demo06 {
    
        String name;
    
        /**
         *
         * @param name
         * @return
         * @throws Exception
         */
         public String test(String name)throws Exception{
             return name;
         }
    
    
    
    }