IDEA使用LiveTemplate快速生成方法注释

  本文目标：开发人员，在了解利用Live Template动态获取方法输入输出参数、创建日期时间方法的条件下，进行自动生成方法注释，达到自动添加方法注释的程度；

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配置方法注解，提升效率。