Eclipse自定义注释风格

一、简介

设置注释模板的入口：Window->Preference->Java->Code Style->Code Template

然后展开Comments节点就是所有需设置注释的元素了！

然后点击选中的注释模块，点击edit就可以设置了

 

下面我们来简单解释一下这些注释的意思和推荐的模板

1、文件(Files)注释标签

Files标签是对新建的文件的说明，出现在文件最上面

• 推荐注释风格：

/**   
 * Copyright © ${year} eSunny Info. Tech Ltd. All rights reserved.
 * 
 * 功能描述：
 * @Package: ${package_name} 
 * @author: ${user}   
 * @date: ${date} ${time} 
 */

2、类型(Types)注释标签（类的注释）

Types标签是对类Class的一个说明，出现在类上面

• 推荐注释风格：

/**   
* Copyright: Copyright (c) ${year} LanRu-Caifu
* 
* @ClassName: ${file_name}
* @Description: 该类的功能描述
*
* @version: v1.0.0
* @author: ${user}
* @date: ${date} ${time} 
*
*/

 3、字段(Fields)注释标签

Fields标签是对变量字段的说明

• 推荐注释风格：

// @Fields ${field} : ${todo}

 4、构造函数(Constructors)标签

Constructors标签是对类的构造函数的说明

• 推荐注释风格：

/**   
* @Function: ${file_name}
* @Description: 该函数的功能描述
*
* @param:参数描述
* @version: v1.0.0
* @author: ${user}
* @date: ${date} ${time} 
*/

 5、方法(Methods)标签

Methods标签是对函数方法的说明

• 推荐注释风格：

/**   
* @Function: ${file_name}
* @Description: 该函数的功能描述
*
* @param:描述1描述
* @return：返回结果描述
* @throws：异常描述
*
* @version: v1.0.0
* @author: ${user}
* @date: ${date} ${time} 
*
*/

 6、覆盖方法(Overriding Methods)标签

Overriding Methods标签是对覆盖方法的说明

• 推荐注释风格：

/** 
* ${see_to_overridden}  
* @Function: ${file_name}
* @Description: 该函数的功能描述
*
* @param:描述1描述
* @return：返回结果描述
* @throws：异常描述
*
* @version: v1.0.0
* @author: ${user}
* @date: ${date} ${time} 
*
*/

 7、代表方法(Delegate Methods)标签

• 推荐注释风格：

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

8、getter方法标签

• 推荐注释风格：

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

9、setter方法标签

• 推荐注释风格：​​​​​​​

/**
 * @param ${param} the ${bare_field_name} to set
 */