包机制
-
为了更好地组织类,Java提供了包机制,用于区别类名的命名空间。
-
本质是文件夹
-
包语句的语法格式为:
package pkg1[. pkg2[. pkg3...]];
一般利用公司域名倒置作为包名;
- 为了能够使用某一个包的成员,我们需要再Java程序中明确导入该包。使用import语句可以完成此功能。
import package1[.package2...].(classname|*);
javaDoc
javadoc命令是用来生成自己API文档的
参数信息
- @author 作者名
- @version 版本号
- @since 指明需要最早使用的jdk版本
- @param 参数名
- @return 返回值情况
- @throws异常抛出情况
Java 8 中文版 - 在线API中文手册 - 码工具 (matools.com)
/**
*写类上面的
*@author ***
*@version 1.0
*@since 1.8
*/
public class Doc {
String name; //属性
/**
*写在方法上的
*@author ***
*@param name
*@return
*@throws Exception
*/
public String test(String name) throws Exception{
return name;
}
}
把上面的代码文件生成自己的API文档
输入命令:javadoc -encoding UTF-8 -charset UTF-8 Doc.java(中间的参数是防止乱码)
- 除了可以使用命名生成帮助文档还可以使用IDEA生成JavaDoc文档!