ICode9

精准搜索请尝试: 精确搜索
首页 > 编程语言> 文章详细

JAVA学习笔记02-注释、标识符、关键字以及数据类型

2021-12-23 02:02:16  阅读:167  来源: 互联网

标签:02 JAVA 标签 数据类型 Javadoc javadoc 注释 文档


目录

注释

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

Javadoc

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

注意

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

Javadoc的标签

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

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

标签 描述
@author 作者名
@version 版本号
@since 指明需要最早使用的jdk版本
@param 参数
@return 返回值情况
@throws 异常抛出情况

注意

  • 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)包括类、接口、数组

标签:02,JAVA,标签,数据类型,Javadoc,javadoc,注释,文档
来源: https://www.cnblogs.com/zbcgoal/p/15721807.html

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有