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  

*/ 

1. 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也可生成注释。

 

 

 

转载于:https://www.cnblogs.com/Randlly/p/11072419.html