Day06包机制与JavaDoc

目录

包机制

JavaDoc

通过命令行窗口创建API文档

通过IDEA创建API文档

---

包机制

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

包语句的语法格式为：

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

一般将域名倒置作为包名。

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

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

利用包机制可有效管理文件

JavaDoc

JavaDoc命令可用来生成自己API文档

参数信息

• @author 作者名

• @version 版本号

• @since 指明需要最早使用的JDK版本

• @param 参数名

• @return 返回值情况

• @throws 异常抛出情况

通过命令行窗口创建API文档

输入代码后打开命令，找到该代码所在路径，输入Javadoc +文件名+后缀，有时为避免乱码或无法识别代码中一些字体，会加入一些编码，例如：-encoding UTF-8和-charset UTF-8.防止文档中出现乱码。 

出现如图所示即为操作成功，打开文档中index.html文档

即出现Java自行生成的API文档

通过IDEA创建API文档

工具--->在其他命令行参数中输入-encoding UTF-8 -charset UTF-8--->创建API文档。