Java基础（五）：包机制、文档注释

Java基础（五）：包机制、文档注释

一、包机制

为了更好地组织类，Java提供了包机制，用于区别类名的名命空间。本质上类似于文件夹。

包语句的语法格式为：包名1.包名2.包名3；

一般利用公司域名倒置作为包名：com.baidu.www

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

import 包名1.包名2.包名3；

包名命：com.gok.base

二、文档注释

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

注：在线Java API帮助文档https://docs.oracle.com/javase/8/docs/api/

/**
*@author作者名
*@version版本号
*@since指明需要最早使用的jdk版本
*@parm参数名
*@return返回值情况
*@throws异常抛出情况
*/
package com.gok.base;
/**
 * @author  gok
 * @version 1.0
 * @since 1.8
 */
public class HelloWorld {
    String name;
    /**
     * 
     * @param name
     * @return
     * @throws Exception
     */
    public String text(String name) throws Exception {
        return name;
    }
}

在doc界面使用命令，生成API文档