欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  技术分享

Java Eclipse自动生成方法注释_Eclipse注释模板设置详解

程序员文章站 2022-03-01 18:03:38
...

做为一个优秀的程序员、是十分不想写注释的、还记得我刚刚参加实习的时候、除了自己觉得理解比较难的加上了注释以外、基本上都是没有注释的、所以介于我的情况是必须要设置自动生成注释这个功能的、分享一下设置方法、以便以后使用

设置注释模板的入口: Window->Preference->Java->Code Style->Code Template 然后展开Comments节点就是所有需设置注释的元素啦

现就每一个元素逐一介绍:


文件(Files)注释标签:

/**   
 * @Title: ${file_name} 
 * @Package ${package_name} 
 * @Description: ${todo}(用一句话描述该文件做什么) 
 * @author qinyl http://dwtedx.com
 * @date ${date} ${time} 
 * @version V1.0   
 */


类型(Types)注释标签(类的注释):

/** 
 * @ClassName: ${type_name} 
 * @Description: ${todo}(这里用一句话描述这个类的作用) 
 * @author qinyl http://dwtedx.com
 * @date ${date} ${time} 
 * ${tags} 
 */


字段(Fields)注释标签:

/** 
 * @Fields ${field} : ${todo}(用一句话描述这个变量表示什么) 
 */ 


构造函数标签:

/** 
 * @Title: ${enclosing_method} 
 * @Description: 构造方法
 * ${tags} 
 */


方法(Constructor & Methods)标签:

/** 
 * @Title: ${enclosing_method} 
 * @Description: ${todo}(这里用一句话描述这个方法的作用) 
 * @param ${tags}    设定文件 
 * @return ${return_type}    返回类型 
 * @throws 
 */


覆盖方法(Overriding Methods)标签:

/** 
 * @Title: ${enclosing_method} 
 * @Description: (非 JavaDoc)
 * ${tags} 
 * ${see_to_overridden} 
 */


代表方法(Delegate Methods)标签:

/** 
 * ${tags} 
 * ${see_to_target} 
 */


getter方法标签:

/** 
 * @return ${bare_field_name} 
 */


setter方法标签:

/** 
 * @param ${param} 要设置的 ${bare_field_name} 
 */


另外还有JSP和XML的注释自动生成、我目前还没有设置、如果有想设置的可以自己查一下、其实我觉得JSP和XML自动生成注释的必要性也不是很迫切