Day4 包机制 及JavaDoc文档.

包机制

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

它语句的语法格式为：

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

 

一般利用公司域名倒置作为包名：

例如：www.baidu.com ---> com.baidu.www

为了能够使用某一个包的成员，我们需要在Java程序中明确导入该包。使用"import "语句可以完成该功能。

 

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

 

阿里巴巴开发手册；

 

 

Java Doc

java 8 API帮助文档

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

 

参数信息：

• @author 作者名

• @version 版本号

• since 指明需要最早的jdk版本

• @parm 参数名

• @return 返回值情况

• throws 异常抛出情况

   

 

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

1.用cmd命令生成JavaDoc文档. jacadoc -encoding UTF-8 -charset UTF-8 Doc.java

2.作业：学会通过使用Idea 生成 JavaDoc文档；