其考网合作机构> 广州培训学校>广州市天河区达内IT培训
广州市天河区达内IT培训
全国统一学习专线 8:30-21:00
位置:其考网 > 计算机>Java开发> Java注释类型有哪些呢?  正文

Java注释类型有哪些呢?

发布时间:2022-03-12 14:22:34来源:魔方格

Java中注释有两种类型:程序注释和文档注释。程序注释是对程序某个部分的具体实现的注释;文档注释是对程序的描述性注释,主要是为那些不需要知道程序的具体实现的开发者提供的。

Java提供有两种类型的注释:程序注释和文档注释。

程序注释是由分隔符/*···*/和//隔开的部分,这些注释与C++中的注释相同。文档注释是Java所特有的,由分隔符/**···*/隔开,文档注释可以用javadoc工具提取出来,形成HTML文件。

程序注释是对程序某个部分的具体实现的注释;文档注释是对程序的描述性注释,主要是为那些不需要知道程序的具体实现的开发者提供的。注释中可以描述一些精妙的算法和一些不容易理解的设计思想。

但应该避免那些在程序代码中很清楚地表达出来的信息。尽可能地避免过时的信息,错误的注释比没有注释更有害,经常性的注释有时也反映出代码质量的低下。

程序注释有四种类型:块注释、单行注释、跟随注释和行尾注释。

(1)块注释:主要用于描述文件、方法、数据结构和算法。它通常用在文件或方法定义之前,也可以用在方法定义里面,此时它的缩进必须与它所描述的代码相同。

块注释应该以空行开始,以便于区分代码的各个部分。

2、单行注释:一个相对较短的注释可以放在单行上,但必须与它后面的代码有相同的缩进。如果注释不适合放在一行,那么它必须用块注释的格式来写。

3、跟随注释:一个非常短的注释可以和它所描述的代码放在同一行,但要确保代码和注释之间有足够的间距。如果在同一个代码块中有多个这样的注释,它们应该是对齐的。

4、行尾注释。行尾注释不能用于多行文本注释,但可以对多行代码进行注释。注释标记"//"可以注释一行或以"//"开始的部分,直到该行的结束。

文档注释描述了Java类、接口、构造函数等。每个类、接口或成员在声明它的地方之前只有一个文档注释。较外层的类或接口的文档注释是不缩进的,但其成员的文档注释的缩进格式与成员的声明相同。

相关内容: Java Java注释 Java注释类型

推荐课程
相关文章
最新文章
相关热词