代码的注释是帮助阅读代码的人能够比较容易的看出写代码的人的代码的用意及作用。
所以代码的注释形式要统一,并且内容要准确和简洁。
注释的添加标记有:
1、类的注释(一般写在类名的上方):@author(标明开发该类模块的作者)可以多次使用,表示有多个作者,用“,”隔开;@version(标明该类模板的版本)也可以多次使用,仅第一次有效;@see(相关的主题)
2、方法的注释(一般写在方法的内部):@param(对方法中的参数说明)@return(对方法的返回值的说明)@exception(对方法抛出的异常进行说明)
(eclipse)文档生成的方式:选中需要生成文档的类,鼠标点击右键选择Export选项然后在弹出框中选择javadoc,然后next,左侧选中需要生成的文档的类的包,右侧选择需要生成文档的类,再选中public(只有public修饰的类和方法才可以生成文档),然后再选中文档存放的位置,最后finish,文档注释就生成成功了。