【Java学习笔记】day6--内容包括：包机制-在IDEA中新建包中包，JavaDoc-通过命令行生成javadoc文档、通过IDEA生成javadoc文档

目录

Java第六天--基础的最后部分啦

7 包机制

7.1 包机制的概念

7.2 如何在IDEA中新建包中包

8 JavaDoc

8.1 javadoc概念

8.2 通过命令行生成JavaDoc文档

8.3 通过IDEA生成JavaDoc文档

---

Java第六天--基础的最后部分啦

7 包机制

7.1 包机制的概念

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

• 包语句的语法格式为：

  package pkg1[.pkg2[.pkg3...]];

• 一般利用公司域名倒置作为包名；com.study.blog

• 为了能够使用某一个包的成员，我们需要在Java程序中明确导入该包。使用"import"语句可完成此功能

  import package1[.package2...].(classname|*);
  ​
  //导入这个包下所有的类
  import com.study.*;

7.2 如何在IDEA中新建包中包

 

• 建立包中包 com.study(com下study)

• 实际显示效果，只有一个包，com.study不符合我们的预期

•  点击project旁的小齿轮，取消勾选 Compact Midldle Packages选项

•  结果如下，符合我们的预期

 

8 JavaDoc

8.1 javadoc概念

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

• 参数信息

  1. @author 作者名

  2. @version 版本号

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

  4. @param 参数名

  5. @return 返回值情况

  6. @throws 异常抛出情况

• 在线API帮助文档网址：Java Platform SE 8

/**
*@author jlgl520
*@version 1.0
*@since 1.8
*/
​
public class Demo{
    String name;
    /**
    *@param name
    *@return
    *@throws Exception
    */
    public String test (String name) throws Exception{
        return name;
    }
}

8.2 通过命令行生成JavaDoc文档

命令：javadoc -encoding UTF-8 -charset UTF-8 Demo02.java

 

8.3 通过IDEA生成JavaDoc文档

• 打开相应的选项面板

• 设置

• -encoding UTF-8 -charset UTF-8 -windowtitle "test"

• -encoding是java代码编码，-charset是对生成文档所用的编码。-windowtitle就是对应html的