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

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、方法注释
声明好方法后，在向方法里写实现的代码前，在方法前

/** 回车

补充：软件开发 , Java ,