一.文件注释

创建文件后, 编译器会在类名前面生成固定的注释, 来丰富代码的可读性, 在阿里巴巴Java开发手册里也明确写到所有的类都必须添加创建者和创建日期.

image

/**
 * description: ${NAME} <br>
 * date: ${DATE} ${TIME} <br>
 * author: ${USER} <br>
 * version: 1.0 <br>
 */

我们来看一下效果吧

image

其中以$开头的都是IDE中的内置变量, 我们把它引用过来, 也可以自定义成常量.

二.方法注释

写方法的时候也要带上相应的注释, 这样可以增加方法的可读性, 下面我们就来添加一个自定义注释模板, 方法注释的配置要比文件注释复杂一些

1.创建一个group名字随便起

image

2.选中group并新建一个模板

image

3.选择模板类型

image

勾选java

image

4.填写模板内容

image

*
 * description: $description$ <br>
 * version: 1.0 <br>
 * date: $date$ $time$ <br>
 * author: objcat <br>
$params$
 * @return $return$
 */ 

注意上述文字一定要一个字不差的填写, 我的模板并没有写歪, 而是必须要这么写才能正常使用, 关键字需要用*, 不要改动.

添加快捷键与注释

Abbreviation 关键字
Description 模板说明

5.关联变量

点击关联按钮

image

按照图中的方式去关联变量

image

变量不用手打, 可以下拉选择

image

注意第三个参数是一个groovy脚本目的是把参数罗列出来

groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+=' * @param ' + params[i] + ((i < params.size() - 1) ? '\\n' : '')}; return result", methodParameters())

这里说一下为什么要关联变量 你应该可以发现在模板中有
$date$ $time$ $params$ $return$ 这些用$符号包括的代码 这些都是自定义变量, 而我想在写注释的时候实时获取这些, 比如时间, 日期, 参数名, 返回值类型 所以需要关联编译器的变量自动填入.

到了这一步 设置都结束了

使用方法 只需要打 /** + tab 就可以了

好的我们来看一看效果吧

image

我们来生成一个javadoc看看效果
Tools -> Generate JavaDoc

image

如果出现编码问题请如图填入下面这句话(屏幕一大堆问号)

-charset utf-8 -encoding utf-8

image

image

finally enjoy it

作者：objcat
链接：https://www.jianshu.com/p/812d06702437
来源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。