包机制与javadoc

包机制

• 为了更好地组织包机制，用于区别类名的命名空间。
• 包语句的语法格式为：
  package pkg1[.pkg2[.pkg3…]];
• 一般利用公司域名倒置作为包名；com.baidu.www
• 为了能够使用某一个包的成员，我们需要在Java程序中明确导入该包。使用“import”语句可以完成此功能
  import package1[.package2…].(classname|*);

JavaDoc

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

package com.baidu;

/**
 * @author ding
 * @version 14.0.1
 */

public class Demo03 {
    String name;

    /**
     * @author ding
     * @param name
     * @return
     * @throws Exception
     */
    public String test(String name) throws Exception{
        return name;
    }
}

• 参数信息
  1. @author 作者名
  2. @version 版本号
  3. @since 指明需要最早使用的jdk版本
  4. @param 参数名
  5. @return 返回值情况
  6. @throws 异常抛出情况