Java包机制与文档注释

Java包机制与文档注释

包机制

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

• 包语句的语法：

  package pkg1.pkg2.pkg3...; // 必须在文件第一行
  

• 一般用公司域名倒置作为包名； www.baidu.com ---> com.baidu.www

• 导入包

  import pkg1.pkg2...(.className|*); // * 会导入该包下面所有的class
  

文档注释（JavaDoc）

• javadoc命令是用来生成自己的API的

• 参数信息

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

• 生成Javadoc的时候，输入command “-encoding utf-8 -charset utf-8”