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

 

猜你喜欢

转载自www.cnblogs.com/Randlly/p/11072419.html
今日推荐