eclipse代码注释的设置
http://blog.csdn.net/shiyuezhong/article/details/8450578
1. eclipse用户名的设置:
在eclipse的安装路径下,打开eclipse.ini的配置文件,如下图:
在-vmargs下加入:-Duser.name=你的名字
2. 注释格式以及各个主要简介
(1).单行(single-line)注释:“//……”
(2).块(block)注释:“/*……*/”
(3).文档注释:“/**……*/”
(4).javadoc注释标签语法
@author 对类的说明标明开发该类模块的作者
@version 对类的说明标明该类模块的版本
@see 对类、属性、方法的说明参考转向,也就是相关主题
@param 对方法的说明对方法中某参数的说明
@return 对方法的说明对方法返回值的说明
@exception 对方法的说明对方法可能抛出的异常进行说明
@return_type返回类型
@date 日期
3类、方法、重写方法等类型的注释添加
打来:Window->Preference->Java->Code Style->Code Template 然后展开Comments节点,选中你要添加注释的类型,
然后点击edit,就是所有需设置注释的元素。现就每一个元素逐一介绍:
点击edit后,在pattern里按“ctrl“+”/”键,选择要添加的种类,例如日期,作者、时间、返回类型等等……
设置好以后,会在上图的pattern下生成相应代码,如下图所示:
(1)文件(Files)注释标签:
目前没有用到,可以不用设置。
(2)类型(Types)注释标签(类的注释):
规范:
/**
*
类的描述
* @authoryourname
* @Time 2012-11-20 14:49:01
*
*/
注释的pattern:
/**
* @Description:${todo}
* @author:${user}
* @time:${date} ${time}
*/
(3)字段(Fields)注释标签:
/**
* @Description: ${field} : ${todo}(用一句话描述这个变量表示什么)
*/
暂时用不到
(4)构造函数标签(Constructor):
规范:
/**
*
构造方法的描述
* @param name
* 按钮的上显示的文字
*/
Pattern:
/**
* @Description:${todo}
* ${tags}
*/
(5)方法(Methods)标签:(接口和其实现类的方法,都要加注释)
注释规范:
/**
*
为按钮添加颜色
*@param color
按钮的颜色
*@return
*@exception (方法有异常的话加)
* @author Administrator
* @Time 2012-11-20 15:02:29
*/
Pattern:
/**
* @Description:${todo}
* ${tags}
* ${return_type}
* @exception:
* @author: ${user}
* @time:${date} ${time}
*/
(6)覆盖方法(Overriding Methods)标签:
(7)代表方法(Delegate Methods)标签:
(8)getter方法标签:
(9)setter方法标签:
这些暂时没有定义,可以按照自己的方式添加注释。