JAVA复习笔记--前言:第一节:从注释开始

2014-11-24 11:01:04 · 作者: · 浏览: 0

java注释分以下三种注释:

1、单行(single-line)--短注释://……
2、块(block)--块注释:/*……*/
3、文档注释:/**……*/

一、单行注释
1、单行注释(Single-Line Comments):
短注释可以显示在一行内,并与其后的代码具有一样的缩进层级。

如果一个注释不能在一行内写完,就该采用块注释。

单行注释之前应该有一个空行。

例:

if (condition) { /* Handle the condition. */ ... }eclipse快捷键:Ctrl+Shift+/ Ctrl+Shift+\

2、尾端注释(Trailing Comments):
尾端(trailing)--极短的注释,在代码行的行尾进行注释。

建议:一般与代码行后空8(至少4)个格,所有注释必须对齐。

例:

if (a == 2) { return TRUE; /* special case */ } else { return isPrime(a); /* works only for odd a */ }eclipse快捷键:Ctrl+Shift+/ Ctrl+Shift+\

3、行末注释:

在代码行的开头进行注释。主要为了使该行代码失去意义。
注释格式:// 注释内容

建议:在代码中单起一行注释, 注释前最好有一行空行,并与其后的代码具有一样的缩进层级。如果单行无法完成,则应采用块注释。

如:

风格一: if (foo > 1) { // Do a double-flip. ... } else { return false; 风格二:// Explain why here. } 风格三: //if (bar > 1) { // // // Do a triple-flip. // ... //} //else { // return false; //}

Ctrl+Shift+C 或者 Ctrl+/ 再按一次取消


二、块注释
注释若干行,通常用于提供文件、方法、数据结构等的意义与用途的说明,或者算法的描述。一般位于一个文件或者一个方法的前面,起到引导的作用,也可以根据需要放在合适的位置。这种域注释不会出现在HTML报告中。注释格式通常写成:

快捷键:Ctrl+Shift+/ Ctrl+Shift+\

三、文档注释
注释若干行,并写入javadoc文档。每个文档注释都会被置于注释定界符

avadoc注释标签语法

1、接口或类中使用

@see 对类、属性、方法的说明 参考转向,也就是相关主题
@author 对类的说明 标明开发该类模块的作者
@version 对类的说明 标明该类模块的版本

@deprecated:不推荐使用的方法或类

2、方法中使用

@deprecated:不推荐使用的方法

@see 对类、属性、方法的说明 参考转向,也就是相关主题
@param 对方法的说明 对方法中某参数的说明
@return 对方法的说明 对方法返回值的说明
@exception 对方法的说明 对方法可能抛出的异常进行说明

@throws 同exception

3、字段上使用

@deprecated:不推荐使用的方法

@see 对类、属性、方法的说明 参考转向,也就是相关主题


1、开头注释(Beginning Comments)
所有的源文件都应该在开头有一个C语言风格的注释,其中列出类名、版本信息、日期和版权声明:

/*
* Classname
*
* Version information
*
* Date
*
* Copyright notice
*/


2、包和引入语句(Package and Import Statements)
我常用的快捷键:Ctrl+Shift+O

3、类和接口声明(Class and Interface Declarations)
快捷键:Alt+Shift+J

/**
* @Copyright

* @Description
* @author 逍遥客
* @date 2013-5-23 上午12:43:22
* @version V1.0
*/

4、方法注释
声明好方法后,在向方法里写实现的代码前,在方法前

/** 回车