4.6.Java基础语法之包机制、JavaDoc

1.包机制

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

  • 包----即文件夹

  • 包语句的语法格式:

 package pkg1[.pkg2[.pkg3...]];
 ​
 package bilibli.lanseyutou.base;
  • 一般利用公司域名倒置作为包名

  • 为了能够使用某一个包的成员,我们需要在Java程序中明确导入该包,使用“import”语句可以实现该功能

 import pkg1[.pkg2[.pkg3...]];
 ​
 import bilibili.lanseyutou.base.Demo02;
 ​
 import bilibili.lanseyutou.base.*;//导入bilibili.lanseyutou.base包下所有的类

 

2. JavaDoc

  • JavaDoc命令是用来生成自己API文档的

  • JDK8帮助文档

  • 参数信息:

    • @author 作者名

    • @version 版本号

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

    • @param 参数名

    • @return 返回值情况

    • @throws 异常抛出情况

 package bilibli.lanseyutou;
 ​
 /**
  * @author lanseyutou
  * @version 1.0
  * @since 1.8
  */
 ​
 ​
 public class Doc01 {
 ​
     String name;
 ​
     /**
      *
      * @param name
      * @throws Exception
      * @return
      */
 ​
     public String test(String name) throws Exception {
         return name;
 ​
    }
 }

然后打开该文件所在的文件夹,在路径前输入cmd打开windows powershell

输入javadoc -encoding UTF-8 -charset UTF-8 Doc01.java(javadoc 参数 文件名)

 

即可看到该文件夹下生成index.html文件,点开后即可看到类似于JDK帮助文档的页面

 

  • 使用IDEA生成JavaDoc文档

  1. 首先新建一个文件夹,用于存放要生成的javadoc文档

  2. 接下来点击IntelliJ IDEA顶部的Tools菜单,选择Generate JavaDoc 选项 4.6.Java基础语法之包机制、JavaDoc

  3. 然后在弹出的界面中我们点击Output directory输入框后面的按钮 4.6.Java基础语法之包机制、JavaDoc

  4. 在弹出的文件夹界面中选择刚才新建的文件夹

  5. 接下来在底部的Locale输入框配置语言和编码集,如下图所示,语言用zh_CN 代编中文

     -encoding utf-8 -charset utf-8

    4.6.Java基础语法之包机制、JavaDoc

  6. 然后点击确认以后我们就可以等待Intellij IDEA 给我们生成的 JavaDoc文档即可

  7. 接下来我们打开JavaDoc文件夹,找到index.html文件,点击就能看到API文档。

上一篇:注释的重要性


下一篇:Java学习笔记_基础语法_JavaDoc生成文档