java基础学习Day05-包机制

包机制

• 为了更好地组织类，java、提供了包机制，用于区别类名的命名空间

• 包的本质就是文件夹

• 包语句的语法格式：

  package pkg[.pkg2.[pkg3...]];
  

• 一般利用公司域名倒置做包名；

• 为了能够使用某一个包的成员，我们需要在Java里明确导入该包，使用“import”语句可以完成此功能。

  import package1[.package2...].(classname|*);
  

  import com.jiang.base.*;//*代表通配符，全部类导入；
  

JavaDoc生成文档

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

• 参数信息：

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

• javadoc生成方式：

  • 命令提示符生成：

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

  • idea生成：

    tools-->Generate JavaDoc

    package com.jiang.base;
    
    /**
     * @author jiang
     * @version 1.0
     */
    public class Doc {
        String name;
    
        /**
         *
         * @param name
         * @return
         * @throws Exception
         */
    
        public String test(String name) throws Exception{
            return name;
        }
    }