2-Java基础:包机制

一、包机制

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

package pkg1[.pkg2[.pkg3...]];  //可能一个包内嵌套另一个包

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

IDEA取消压缩中间包

新建包

效果

导入包语法格式：

import package1[.package2..].(classname / *); // 可以导入某个包内的某个类或全部类

注： 尽量不要让导入的类名同当前类名一致

Java Doc

使用 javadoc 命令生成自己的API文档
参数信息：

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

类上就是类的注释
方法上就是方法的注释

测试：生成API文档——命令行的方式

• 打开文件所在文件夹
  
• 在该文件夹位置打开命令行窗口【快速方式1：在路径前写cmd和一个空格，回车】
  
• 使用javadoc命令生成文档【注解会有中文字符，所有设置编码格式encoding和字符集charset】

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

• 生成文档页面
  
  点开index.html，还可以点开"Demo05"查看具体内容
  
  测试：生成API文档——IDEA的方式