IDEA2020.2版本設置類和方法的自定義注釋模板


  IDEA是目前普遍使用的Java開發編輯器,添加自定義的注釋模板,一方面便捷好用,另外一方面可以規范開發。IDEA中設置模板分兩種:1、創建Java類的注釋,2、方法的注釋。

  一、Java類的注釋模板

  1、打開File→Settings,選擇Editor→File and Code Templates→Files→Class。可以看到創建類的時候引入了File Header.java。

 

   2、接下來我們可以看一下Files旁邊的Includes標簽,里面的File Header就是我們要創建的File Header.java,右側的空白出添加我們需要的模板就可以了,下面的描述是模板引用的變量使用方法,比如時間、包名、項目名等。

 

 

   3、比如我們設置如下的內容,點擊OK,再創建類的時候就會自動生成注釋。

 

   效果如下:

 

   二、方法的注釋模板

   1、打開File→Settings,選擇Editor→Live Templates。

 

   2、點擊右側的“+”選擇Template Group,創建分組,分組名自定義,例如:MyTemplates,點擊OK即可。

 

 

 

   3、找到剛創建的MyTemplates分組並選中,點擊右側的“+”,選擇Live Template,寫入要配置的內容:

 

   配置的內容:

  1)Abbreviation:模板的縮寫,可以是【/*】【/**】【*】等,看個人習慣了,后面會介紹用法。

  2)Description:模板的描述,方便自己以后查找。

  3)Template text:模板的內容,參數名用 $參數名$ 格式。

  4)Options→Expand with:模板的擴展快捷鍵,可以按照個人習慣選擇,我用的是Enter鍵,后面會介紹用法。

  4、配置模板格式

/**
 * 功能描述:
 * TODO
 *
$params$
 * @return $return$
 * @author JohanChan
 * @date $DATE$ $TIME$
 */

  如上,配置自己想要的格式,需要注意的是參數要頂頭寫,直接用$params$,前面不要有空格和【*】。

  5、設置變量參數

  點擊Edit variables,列表中顯示的就是剛剛配置的模板的參數 $參數名$,在Expression中下拉選擇方法為其賦值;對於 $params$ 參數需要注意,IDEA給我們默認的是methodParameters()方法,這個方法是把形參顯示在一行,我們需要的是一行一個參數這樣顯示,可以通過自定義腳本實現,把下面的腳本復制到Default value中,即可。

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) ? '\\n' : '')}; return result", methodParameters())

 

 

   6、測試效果

  點擊OK就可以完成配置,以上就配置完成。使用的時候,先創建一個方法,然后在方法外上一行中輸入 /* 點擊Enter鍵,就自動生成了對應的注釋,注意:在方法外使用注釋模板生成的注釋不能生成param和return,目前我不知道什么原因,有知道原因和解決辦法的小伙伴歡迎留言指教。這個問題的臨時解決辦法是:在方法內輸入 /* 點擊Enter鍵,生成注釋后copy到方法外面使用。最終效果如下:

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM