wordpress企业网站模板网络营销知名企业
本文目标：开发人员，在了解利用Live Template动态获取方法输入输出参数、创建日期时间方法的条件下，进行自动生成方法注释，达到自动添加方法注释的程度；
文章目录
- 1 场景
- 2 要点
- 2.1 新增LiveTemplate模版
- 2.2 模版内容填写
- 3 练习手段
1 场景
方法的注释，一般包含作者、创建时间、功能描述、输入参数、返回值，如果每个方法的注释都手写，非常耗时，且容易随着后期变更代码导致差异，不好维护。
public class Pencil {/*** @Author 张三 010223* @date 2024-08-08 14:08:09* @description 计算两数的和* @param a* @param b* @return java.lang.String*/public String addTowNumber(int a, int b) {return String.valueOf(a+b);}
}
IDEA使用LiveTemplate快速生成方法注释，可以自动生成方法注释中的“作者、创建时间、输入参数、返回值”，仅需要手写“功能描述”，减少因写注释带来的工作量。
这里的addTowNumber方法的注释，内容为输入“/**”，加“回车”后自动生成，只有功能描述的“计算两数的和”为手动添加。
2 要点
2.1 新增LiveTemplate模版
按顺序点击菜单 File->Settings->Editor->Live Templates，来到LiveTemplate的配置页面。
点击右侧“+”按钮，先选择“2.Template Group”新增一个组别，再在该组别下，选择“1.Live Template”新增一个模板。
这里新增了“UserTemplate”组，以及内部新增了“*”模版。
内容填写下文会继续介绍。
2.2 模版内容填写
（1）Abbreviation: *
“*”表示匹配字符，在使用时，一般先输入“/**”，其中第二个“*”就会被替换成“Template text”中的内容。
（2）Description: 方法注释
模版的描述信息，不写也没事。
（3）Template text:
模版内容，即匹配字符会被替换成的目标内容，其中$date$、$time$、$param$、$return$表示变量，需要继续配置来源填充。
** @Author 姓名 工号* @date $date$ $time$* @description 功能描述$param$* @return $return$*/
注意，此处的开头不能偷懒写成“/**”，这会导致$date$、$time$、$param$、$return$被块注释包裹，无法实现变量赋值。
（4）define: java
必须配置，否则无法匹配对应语言的文件类型，无法生效。
（5）Expand with: Enter
匹配字符后面的快捷键生效方式，Enter表示回车，即前面输入“/**”后，接着“回车”即可实现替换。
（6）EDIT VARIABLES:
编辑$date$、$time$、$param$、$return$变量的取值来源。
1）date: date(“yyyy-MM-dd”)
2）time: time(“HH:MM:ss”)
3）param:
groovyScript("def result = '';def params = \"${_1}\".replaceAll('[\\\\[|\\\\]\\\\s]', '').split(',').toList();for (i=0; i<params.size(); i++) {if (params[i] != '') {result += ' * @param ' + params[i] + ((i < params.size()-1) ? '\\r\\n' : '')}};return result == '' ? null : result;", methodParameters())
4）return:
groovyScript("def result = '';def param = \"${_1}\".replaceAll('[\\\\[|\\\\]\\\\s]', '');result = param;return result == '' ? null : result;", methodReturnType())
输入参数param、输出参数return使用了groovyScript脚本，代码都在一行比较难读，展开如下：
//param输入参数
groovyScript("def result = ''; //定义返回变量def params = \"${_1}\".replaceAll('[\\\\[|\\\\]\\\\s]', '').split(',').toList(); //获取mothodParamters()函数的第一个返回值，并去除[、]、空格字符//遍历params，将每一个参数转换成字符串，赋予resultfor (i=0; i<params.size(); i++) {if (params[i] != '') {result += ' * @param ' + params[i] + ((i < params.size()-1) ? '\\r\\n' : '')}};//返回resultreturn result == '' ? null : result;", methodParameters())//return输出参数
groovyScript("def result = ''; //定义返回变量def param = \"${_1}\".replaceAll('[\\\\[|\\\\]\\\\s]', ''); //获取methodReturnType()函数的第一个返回值，并去除[、]、空格字符result = param; //设置返回值return result == '' ? null : result; //返回result", methodReturnType())
3 练习手段
可以参考“2 要点”章节，在自己的项目中尝试用LiveTemplate配置方法注解，提升效率。