• 注释
  • Javadoc
  • Javadoc的标签
  • 用Javadoc命令生成文档
  • 用IDEA生成Javadoc文档
• JAVA的关键字
• JAVA的数据类型

注释

java中的注释包括了我们常见的单行注释以及多行注释，单行与多行注释不再赘述。
这里主要学习一下java中的文档注释以及通过使用javadoc来让文档注释输出为文档。
这里先来讲一讲什么是文档注释，文档注释通过/***/来标注，使用的方法是/**+enter。文档注释可以放在类、方法、成员变量、接口的前面来说明它们的功能，比如放在方法的前面：

Javadoc

javadoc可以从源码中抽取类、方法、变量之前的注释，将其整理为一个属于自己代码的API帮助文档。

注意

• 文档注释需要放到类、方法、接口、变量的前面，因为javadoc只处理在这些位置前的注释。
• 所谓的API是暴露给用户使用的部分，所有Javadoc默认只会提取public和protected修饰的部门，如果需要提取pravite部分的注释，那么就需要加上-pravite。

Javadoc的标签

所谓标签，就是javadoc能识别的注释中的特殊部分，这些标签都由@开头或者是以{@}的形式存在。

常见的一些标签如下所示：

注意

• Javadoc的标签是区分大小写的，如果大小写不对，在生成帮助文档的时候会检测不到
• Javadoc必须从一行的开头书写，这是约定。

用Javadoc命令生成文档

javadoc的命令用法标准是

javadoc + 命令参数 + 包名 + 源文件名

我们通过javadoc命令将上面的helloworld的java文件生成文档：

回到我们项目的文件夹中，我们发现了很多.html文件，我们打开index.html文件可以发现，javadoc提取出了我们的文档注释，并生成了我们的API帮助文档目录：

用IDEA生成Javadoc文档

首先在顶部菜单中点击Tool，然后选择Generate JavaDoc

进入配置页面后进行参数的配置

点击OK之后会自动在我们指定的目录导出我们的Javadoc文档：

JAVA的关键字

数据类型：boolean、int、long、short、byte、float、double、char、class、interface。
流程控制：if、else、do、while、for、switch、case、default、break、continue、return、try、catch、finally。
修饰符：public、protected、private、final、void、static、strict、abstract、transient、synchronized、volatile、native。
动作：package、import、throw、throws、extends、implements、this、supper、instanceof、new。
保留字：true、false、null、goto、const。

JAVA区分大小写，是强类型语言

JAVA的数据类型

Java的数据类型分为两大类：

• 基本类型（primitive type）int、long、float、boolean......
• 引用类型（reference type）包括类、接口、数组