idea 导入template_idea中live template的详细使用教程

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.很值得参考