代码生成利器：IDEA 强大的 Live Templates

   <p>Java 开发过程经常需要编写有固定格式的代码，例如说声明一个私有变量， logger 或者 bean 等等。对于这种小范围的代码生成，我们可以利用 IDEA 提供的 Live Templates 功能。刚开始觉得它只是一个简单的 Code Snippet ，后来发现它支持变量函数配置，可以支持很复杂的代码生成。下面我来介绍一下 Live Templates 的用法。</p>    <h2>基本使用</h2>    <p>IDEA 自带很多常用的动态模板，在 Java 代码中输入 fori ，回车就会出现</p>    <pre>  <code class="language-java">for (int i = 0; i < ; i++) {    }  </code></pre>    <p><img src="https://simg.open-open.com/show/dfc35ca371fedef11080fcc39913c1a1.gif"> 按 Tab 可以在各个空白处跳转，手动填值。</p>    <h2>自定义 Template</h2>    <p>官方自带模板毕竟不能满足我们个人编码风格的需要， Live Templates 提供了变量函数的方式供我们自定义。</p>    <h3>简单用法</h3>    <p>新增自定义模板，首先需要填写触发单词（即 Abbreviation），描述是可选的，然后定义模板的上下文，点击 define 选择 Java ，这样在编辑 Java 的时候就会触发当前模板，定义完上下文之后，就可以填写模板了。</p>    <p><img src="https://simg.open-open.com/show/b62100cb24bf6be57c2850e6d89f0e7e.gif"> 下面列举几个我常用的简单模板</p>    <pre>  <code class="language-java">==========  <out>  ----------  System.out.println($END$)  ==========  <pfs>  ----------  private final static String $varName$  = "$var$";`  ==========  <privateField>  ----------  /**   * $COMMENT$   */  @Getter  @Setter  private $TYPE$ $NAME$;  ==========  <main>  ----------  public static void main(String[] args) {       $END$  }  ==========  </code></pre>    <p>模板支持变量的定义，使用 $$ 包围的字符表示一个变量。 $END$ 是一个特殊的预定义变量，表示光标最后跳转的位置。每个变量的位置都可以跳转过去。</p>    <h3>高级用法</h3>    <p>如果你用过 vim 的 Code Sinppet 插件，你会发现模板里面是可以执行函数的，强大的 Live Templates 当然也支持，而且 IDEA 能够感知代码的语义，例如说当前编辑的函数的参数。但这一点就能够让我们玩出花来。我们从易到难来研究模板函数的功能。</p>    <p><img src="https://simg.open-open.com/show/915a405338d652c6e3ec7f12ee6752b6.gif"></p>    <p>前面我们提到的变量可以绑定函数，配置方式如上图所示。</p>    <p>快速声明变量</p>    <p>声明变量是一个常用的操作，特别是需要声明变量需要加注解，注释的时候，这些代码写起来就很枯燥。下面是我定义的模板：</p>    <pre>  <code class="language-java"><osgiRef>  ----------  /**   * $END$   */  @OsgiReference  @Setter  private $TYPE$ $NAME$;  </code></pre>    <p>乍一看这个模板跟我上面定义的 privateField 差不多，唯一的不同在于我给这些变量绑定了函数。</p>    <ol>     <li>clipboard() ：返回当前粘贴板的字符串</li>     <li>decapitalize() ：将输入的字符串首字母变为小写</li>    </ol>    <p>下面我们演示一下，我们先拷贝当前类名，然后输入 osgiRef<br> <img src="https://simg.open-open.com/show/e5b4d2ba5f45ad244aceff99081f1cb9.gif"></p>    <p>快速声明 logger</p>    <p>声明 logger 也是一个常用的操作，上面我们是利用了粘贴函数来快速声明变量，现在我们来利用另一个函数 className() ，顾名思义，它的作用就是返回当前类名。</p>    <pre>  <code class="language-java"><logger>  ----------  /** logger */  private static final Logger LOGGER = LoggerFactory.getLogger($CLASS$.class);  </code></pre>    <p><img src="https://simg.open-open.com/show/a2310d46a4880cd641541bae6d1cdba2.gif"></p>    <p>最强大的 groovyScript()</p>    <p>如果说上面用到的函数提供的能力有限，不够灵活，那么 groovyScript() 提供了一切你想要的能力，它支持执行 Groovy 脚本处理输入，然后输出处理后的字符串。</p>    <pre>  <code class="language-java">groovyScript("code", ...)    |  code   |   一段Groovy代码或者Groovy脚本代码绝对路径    |  |  ...    |   可选入参，这些参数会绑定到`_1, _2, _3, ..._n`, 在 Groovy 代码中使用。|  </code></pre>    <p>下面我们来看一下它的实际应用。</p>    <p>快速 bean 配置</p>    <p>新增一个服务都要在 Spring 中注册一个 bean，一般这个配置无非就是将指明 id 和 class ，由于我们是在 xml 中配置，所以不能利用 className() 函数，但是我们可以利用 clipboard() 函数获取到类的全引用，在 IDEA 中我们直接右键类名，点击 Copy Reference 就行。然后执行 groovy 脚本获取类名。</p>    <pre>  <code class="language-java"><bean>  ----------  <bean id="$id$" class="$REF$" />  </code></pre>    <p>id 绑定 decapitalize(groovyScript("_1.tokenize('.')[-1]", clipboard())) ，首先取 clipboard() 的值得到类的全引用，然后执行 groovy 代码 _1.tokenize('.')[-1] （按 . 分割为字符串数组，然后取最后一个即可得到类名，然后用 decapitalize() 将首字母小写即可得到 id 。</p>    <p><img src="https://simg.open-open.com/show/2e5adcaaf775c19b0e693559d2686bd0.gif"></p>    <p>快速打印当前上下文信息</p>    <p>打印错误日志的时候需要打印当前上下文信息的，例如说入参，有时候入参很多的时候，写起来很痛苦，好在有模板函数 methodParameters() ，返回当前函数参数的列表，当然这个列表我们不能直接使用，需要结合 groovyScript 对它进行转化。</p>    <pre>  <code class="language-java"><printContext>  ---------------  LogUtil.$TYPE$(LOGGER, "$MSG$ " + $params$);  </code></pre>    <p>将 params 绑定到 groovyScript("'\"' + _1.collect { it + ' = [\" + ' + it + ' + \"]'}.join(', ') + '\"'", methodParameters()) ，就能够自动将当前函数的参数格式化后输出。</p>    <p><img src="https://simg.open-open.com/show/d2b69c765da2a6ed54fdc4205c836eca.gif"></p>    <h2>总结</h2>    <p>上面我们简单介绍了常用的模板函数，其实 IDEA 还有很多其它模板函数，具体参考 <a href="/misc/goto?guid=4959742162480814255" rel="nofollow,noindex">Creating and Editing Template Variables</a> 。IDEA 是一个很强大的工具，善用工具能够极大的提高工作效率，将精力投入到关键的事情上，而不是将时间浪费在编写重复代码上面。一些更高级的用法还有待大家去发掘。最后推广一波我写的代码生成插件 <a href="/misc/goto?guid=4959742162583132703" rel="nofollow,noindex">CodeMaker</a> ，好好利用也能节省很多重复编写代码的时间。</p>    <p> </p>    <p>来自：http://blog.xiaohansong.com/2017/03/17/idea-live-templates/</p>    <p> </p>