8.6.2 类、方法等注释的方法
在这一小节中,将简单地介绍类、方法、字段等的注释方法,虽简单但是很重要。
1.类注释
类注释一般必须放在所有的“import”语句之后,紧靠在类声明之前。
/**
this is the student class.
it includes the student name.
*/
public class student
{
……
}
2.方法注释
方法注释必须紧靠在方法声明的前面,除了/*……/标签外,还可以使用下列的以@开始的标签。
❑@param变量描述
❑@return返回类型描述
❑@throws异常类描述
如果以上的注释都没有,把程序拿给别人看,别人会轻易看懂吗?如果过了很长时间以后,自己再来看看这些程序,可能也已经忘记这些代码是做什么的了。
所以说,注释对于程序的可读性来说,是非常重要的,希望读者不要忽视它,以免造成无可挽回的损失。