Eclipse添加自定义注释
首先介绍几个常用的注解：
- @author 作者名
- @date 日期
- @version 版本标识
- @parameter 参数及其意义
- @return 返回值
- @throws 异常类及抛出条件
- @deprecated 引起不推荐使用的警告
- @override 重写
这个注解我们在java代码中经常可以看到。
设置注释模板的步骤：点击菜单栏上的Window -->Preferences-->Java-->Code Style -->Code Templates，对右侧Comments选项中具体的注释信息进行编辑即可。可勾选上自动添加注释信息，在生成java文件时便会自动生成注释，当然也可以手动插入注释。
下面介绍具体的Comment如何设置：
1. 点击Comments下的Files可对整个Java文件进行注释：包括公司名称，版权所属，作者信息，日期等。
/**
* <p>Title: ${file_name}</p>
* <p>Description: </p>
* <p>Copyright: Copyright (c) 2017</p>
* <p>Company: www.baidudu.com</p>
* @author shenlan
* @date ${date}
* @version 1.0
*/
-
2. 点击Types对类进行注释：
/**
* <p>Title: ${type_name}</p>
* <p>Description: </p>
* @author shenlan
* @date ${date}
*/
3. 点击Fields对字段进行注释：
/** ${field}*/
4. 点击Constructors对构造方法进行注释：
/**
* <p>Title: </p>
* <p>Description: </p>
* ${tags}
*/
5. 点击Methods对方法进行注释：
/**
* <p>Title: ${enclosing_method}</p>
* <p>Description: </p>
* ${tags}
*/
6. 点击Overriding Methods对重写方法进行注释：
/* (non-Javadoc)
* <p>Title: ${enclosing_method}</p>
* <p>Description: </p>
* ${tags}
* ${see_to_overridden}
*/
7. Delegate methods对代表方法进行注释：
/**
* ${tags}
* ${see_to_target}
*/
8. Getters对get方法进行注释：
/**
* @return the ${bare_field_name}
*/
9. Setters对set方法进行注释：
/**
* @param ${param} the ${bare_field_name} to set
*/
注解使用的方法：
在对类中的方法进行注释是：在方法上方输入/** 后点击回车，即可生成方法注释；或将光标放在方法名上，按住Shift+Alt+J快捷键也可；或在方法上右击，source》Generate Element Comment也可生成注释。
