20200928更新 添加 预定义函数 groovyScript 的使用方式
live template是什么?
live template是一个预定义的代码模板,其中的内容能够根据上下文信息自动推断.
首先放下效果图
demonstrate.gif
相对于手动打出整块代码,很简洁有没有?如果这种毫无技术含量的代码都通过live template 来自动生成,有下面两个好处
1. 有更多的时间关注于业务逻辑,核心代码可以更优雅
2. 减少低级错误出现的可能,之前手写拼错和括号错位真是血和泪的教训
笔者很早之前就注意到这个功能,也查看过官方文档和博客,都不能尽如人意.本文会以上面为例,从头到尾完成一个live template,并介绍其大部分功能
一个完整的示范
-
新建一个live template
image.png -
填写缩写和说明
image.png
这样使用时如果输入了对应的缩写,会有如下的提示
image.png
-
设置模板的作用范围
刚创建模板时idea应该会提示设置作用范围,我这里是已经设置过了,所以提示更改, 这里应该相差不大
image.png
这里我只勾选了在表达式和语句时输入会触发, 其他情况下不会触发.例如在方法外输入unq,ide不会给任何提示
image.png 设置模板
live template中模板变量使用$包裹的,并且是可复用的,下面的模板就是将会变动的字段提取为变量
Object result = $CACHE_NAME$.get(String.valueOf($PARAMETER$),
x -> getSession().createCriteria($RETURN_TYPE$.class)
.add(Restrictions.eq("$END$$PARAMETER$", $PARAMETER$)).setMaxResults(1)
.uniqueResult());
return result == null ? null : ($RETURN_TYPE$) result;
- 设置强大的
预定义函数
关于预定义函数参见官方文档
进入编辑变量页面,对变量设置需要的函数(这里很坑,我还以为是在模板里直接使用预定义函数,结果是预定义函数要附在变量上),个人认为这个功能很强大
image.png
这里可以调整变量的填充顺序,设置需要的预定义函数,这里就简单介绍下用到的两个函数
1. complete() 光标跳转到该变量位置时会打开智能补全,不确定要用什么就用它
2. methodReturnType() 使用当前方法的返回类型设置当前变量
image.png
进阶篇: 使用预定义函数groovyScript
groovyScript使用Groovy提供更强大的能力,例如打印当前类中所有实例字段的名称.演示前说明几点
- groovyScript的Expression可以是一段groovy代码,也可以是指向Groovy脚本文件的绝对位置,它执行后需要返回一个字符串表示结果
- groovyScript中可以使用_editor,表示当前编辑器窗口,是EditorImpl的实例
下面开始演示
IDEA添加必备jar包
IDEA安装路径/lib目录添加 qdox jar包,我们需要用它去读取源文件定义 groovy脚本文件
这段脚本读取当前编辑器窗口对应的java源文件,读取并返回所有实例字段的名称
//FieldPrinter.groovy
import com.thoughtworks.qdox.JavaProjectBuilder
import java.nio.charset.StandardCharsets
import java.util.stream.Collectors
def builder = new JavaProjectBuilder();
builder.setEncoding(StandardCharsets.UTF_8.toString())
def file = new File(_editor.getVirtualFile().getPath())
builder.addSource(file)
def clazz = builder.getClasses().iterator().next();
def fieldNames = clazz.getFields().stream().filter({f -> !f.isStatic()}).map({f -> f.getName()}).collect(Collectors.toList())
return fieldNames.stream().collect(Collectors.joining(","));
-
定义 live template
image.png -
运行结果
image.png
-
$END$是特殊的预定义变量,表示模板结束后的光标位置 - idea有很多预定义的live template.很值得参考
