JAVA-基础语法-3-包机制/JavaDoc

包机制

• 包的本质是文件夹，(控制不重名)
• 为了更好的组织类，Java提供了包机制，用于区分类名的命名空间
  包语句的语法格式为：package pk1.pk2[.pk3[.pk4]];
• 一般利用公司域名倒置作为包名：www.baidu.com --> com.baidu.www
• package + 包名 在每个程序的最上方，并且必须要存在
• 导入包： 如需使用 java.until.Date包下的Date命令，需要用import命令进行导入包的操作
  1. 必须要在package的下方
  2. package必须存在
     
     

JavaDoc

• 百度搜索: JDK帮助文档，找到版本号8，在线API(Application Programming Interface,即应用程序编程接口)帮助文档
  

• 常用标签

  1. @author 标识一个类的作者
  2. @version 指定类的版本
  3. @deprecated 指名一个过期的类或成员
  4. @throws 抛出异常
  5. @param 参数情况
  6. @return 返回值

• JavaDoc可以帮助我们生成API文档

• 步骤，在要生成api文档的包下边使用javadoc命令生成文档: javadoc -encoding UTF-8 -charset UTF-8 要生成文档的java文件
  

• 一些标签