IDEA中设置注释模板的方法

　　IDEA中设置注释模板主要分为两个部分，分别是建立java文件时类的注释和方法的注释。

　　这里为你们详细介绍一下方法，按MyEclipse的风格设置（MyEclipse的请看：MyEclipse中设置注释模板的方法），你们能够根据本身的习惯生成本身喜欢的注释模板。效果以下：

 

 

1、设置类的注释模板

一、选择File→Settings→Editor→File and Code Templates→Files→Class。能够看到建立Class时引入了一个参数"File Header.java"。对应的是Files旁边的Includes→File Header文件。

 

二、File Header里就是建立类时的注释模板，下面Description中有描述一些能够配置的参数，能够根据本身须要选用。

 

2、设置方法的注释模板

一、选择File→Settings→Editor→Live Templates。点击右边的加号，选择Template Group，建立一个分组。

 

二、再点击加号，选择Live Template，建立一个模板。其中：

Abbreviation：填模板的缩写，可使用*号做为代号，方便后面调用模板。

Options→Expand with：填注释模板的扩展快捷键，根据使用习惯，这里使用默认的Tab。

Template text：填写注释模板的内容。参数名使用${参数名}$的格式。（注意：注释模板开头的/不要填写，缘由能够看文章末尾的解释）

 

三、点击模板页面最下方的警告define，来设置将模板应用于哪些场景，选择Everywhere-->Java便可。（若是曾经修改过，则显示为change而不是define，如上图）

 

四、而后点击Edit variables，会读取刚刚在注释模板中的配置的参数${参数名}$。在Expression的下拉框中选择方法为其赋值。

 

五、参数赋值优化

（1）若是param参数使用默认的methodParameters()来获取方法参数值，其注释参数是在一行展现的，以下图。这里咱们但愿像MyEclipse中同样，一行一个参数的样式，能够经过脚原本实现。将如下脚本复制进Expression，能够获得文章开头效果图的样式：

groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+=' * @param ' + params[i] + ((i < params.size() - 1) ? '\\r\\n' : '')}; return result", methodParameters())

 

（2）若是return参数使用默认的methodReturnType()来获取参数值，模板里使用了@link来跳转结果类型，那么当方法返回值为void时，注释会报错，以下图。能够经过脚原本避免，将上面模板中的@link参数去掉，将如下脚本复制进Expression：

groovyScript("def result=\"${_1}\"; if(result == \"void\"){return \"\";}else{return \"{@link \"+result+\"}\";}", methodReturnType())

 

六、注释模板的调用。经过输入 / + * + Tab键，即先输 /* 再按Tab键，就能够调用模板。由于刚刚咱们把*被设置为模板的代号，Tab键设置为模板的扩展快捷键，也能够把Tab改成Enter键，更加还原MyEclipse。

 

PS:（1）注意，注释模板开头不要使用/，由于设置后虽然能够更便捷的使用 * + Tab键，调用模板。可是会存在param为null的状况（缘由暂时未知），以下图，须要在方法内调用才能获取参数，但这样还须要将注释复制到方法外反而使用不便。

 

（2）注释模板中的user参数是获取系统的用户（固然注释做者也能够直接写固定值，可是配置更有意思，哈哈），常常不是本身须要的做者名，能够在IDEA中进行配置。打开→IDEA的安装目录\bin\idea64.exe.vmoptions。在最下面增长一行-Duser.name=username。

其中username就是你但愿为user参数的赋值。