Java基础语法04（包机制、JavaDoc）

包机制

为了更好地组织类，Java提供了包机制，用于区别类名的命名空间。
包语句的语法格式为：

package pkg1[. pkg2[. pkg3...]];

一般利用公司域名倒置作为包名；
为了能够使用某一个包的成员，我们需要在Java程序中明确导入该包。使用“import”语句可完成此功能

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

JavaDoc

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

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

学会查找使用IDEA生产JavaDoc文档

在 “Tools->Gerenate JavaDoc” 面版的 “Other command line arguments:” 栏里输入 “-encoding utf-8 -charset utf-8”.

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

package com.kuang.base;

/**
 * @author   kuangsen
 * @version  1.0
 * @since  1.8
 */
public class Doc {

    String name;

    /**
     * @author kuangshen
     * @param name
     * @return
     * @throws Exception
     */


    public String test(String name) throws Exception{
        return name;
    }

    //我是通过命令行 javadoc 参数 Java文件

    //作业：学会查找使用IDEA生产JavaDoc文档！  面向百度编程！

    //基础部分的一切知识，后面几乎每天都会用
}