Myeclipse 中的注释

注释也是一门艺术,好的注释不仅便于后期维护,还可以生成接口文档便于前端查阅。 有必要的话可以将自己的注释写成一个模板,以后用的时候直接复制就行。 关于在myeclipse中如何设置注释模板,请参考:https://blog.csdn.net/u012463017/article/details/52189802 文档注释中是支持html标签的 所以可以定制自己的模板。 注释模板：

/** 

<p><b>描述：</b></p> <p></p>

<p><b>用途：</b> </p> <p></p>

@author

@param

@return 返回Message对象<br/> <b>内容:</b><p>message: "", status: true, list: null, listSize: 0, map: null</p> <p>message的内容为提示字符串</p> <p>status为状态 true为真 false为假</p> <p>list 为数据集合</p> <p>listSize 为集合长度</p> <p>map为 键值对的数据集合</p>

*/

这个模板显示效果如上图，注释写完直接导出成javadoc文档留存。 虽然注释写起来比较麻烦费时，但是我相信完整的注释不仅会对项目后期有很大作用，对于后期自己维护，或者别人维护的时候都是一件有意义的事情。 当然方法内的其他注释也是不能少的。

// 这是单行注释

/* * *这是多行注释 * */
   
 /**
    *这是文档注释
    */
    注释关键字：
                    [@author](https://my.oschina.net/arthor)   作者
                    [@param](https://my.oschina.net/u/2303379)  参数
                    @return  返回值
                    @exception  异常
                    @see  引用其他类
                    @version  版本号
                    @since  从什么时候开始
                    @throws 抛出异常
                    @deprecated 过时
                    @category 种类
                    @serialData 说明通过writeObject()和writeExternal()方法写的数据

好记性不如烂笔头,趁着还记得住,写下备用.

来源：oschina

链接：https://my.oschina.net/u/4245884/blog/3223261