Eclipse注釋規范模版總結
一、具體操作
(1)在eclipse中,打開Window->Preference->Java->Code Style->Code Template
(2)然後展開Comments節點就是所有需設置注釋的元素,參照下面注釋規范對應設置即可
二、注釋規范
1、文件(Files)注釋標簽
/** * FileName: ${file_name} * @Description: ${todo} * @author: crane-yuan * @version V1.0 * Createdate: ${date} ${time} * Copyright: Copyright(C) 2016-2017 * Company CY. * All rights Reserved, Designed By crane-yuan * Modification History: * Date Author Version Discription * --------------------------------------------------------------------------- * ${date} crane-yuan 1.0 1.0 * Why & What is modified: */
2、類型(Types)注釋標簽(類的注釋):
/** * @ClassName: ${type_name} * @Description: ${todo} * @author: crane-yuan * @date: ${date} ${time} */
3、字段(Fields)注釋標簽:
/** * @Fields ${field} : ${todo} */
4、構造函數(Constructor)注釋標簽:
/** * @Title: ${enclosing_type} * @Description: ${todo} * @param: ${tags} * @throws */
5、方法(Methods)標簽:
/** * @Title: ${enclosing_method} * @Description: ${todo} * @param: ${tags} * @return: ${return_type} * @throws */
6、覆蓋方法(Overriding Methods)標簽:
/** * <p>Title: ${enclosing_method}</p> * <p>Description: </p> * ${tags} * ${see_to_overridden} */
7、代表方法(Delegate Methods)標簽:
/** * ${tags} * ${see_to_target} */
8、getter方法標簽:
/** * @Title: ${enclosing_method} <BR> * @Description: ${todo} <BR> * @return: ${field_type} <BR> */
9、setter方法標簽:
/** * @Title: ${enclosing_method} <BR> * @Description: ${todo} <BR> * @return: ${field_type} <BR> */