eal 取值 補齊 idea proc scrip list == images

在使用IDEA開發的過程中，我們可以通過設置代碼註釋模版，實現註釋信息的自動補齊，提高編碼效率。
我使用的是Mac電腦，就以Mac環境來進行說明吧。

在Mac上配置IDEA的代碼註釋模版，主要包括兩個部分：一個是File Head文件頭註釋，用於描述類文件的信息；一個是方法頭註釋，用於描述類方法的信息。具體配置過程如下。

一、配置類文件頭註釋模版
點擊IDEA編譯器左上角的“IntelliJ IDEA”按鈕，選擇“Preferences...”，在彈出窗口中，選擇“Editor-->File and Code Templates”，在窗口的右邊“Schema”下拉欄選擇“Default”，然後點擊“Includes”標簽，在右邊模版欄中填寫註釋模版。最後點擊右下角OK按鈕生效。

參考內容如下：

/**
 * 項目名稱：${PROJECT_NAME}
 * 類 名 稱：${NAME}
 * 類 描 述：TODO
 * 創建時間：${DATE} ${TIME}
 * 創 建 人：${USER}
 */

其中${...}裏填寫的是自動填充內容的標簽。窗口右下角有IDEA當前支持的標簽列表。

二、配置方法頭註釋模版
點擊IDEA編譯器左上角的“IntelliJ IDEA”按鈕，選擇“Preferences...”，在彈出窗口中，選擇“Editor-->Live Templates”，進入方法頭註釋模版編輯界面，如下圖。

添加方法頭的註釋，需要有以下步驟：
（1）首先通過點擊圖中第二步中的“+”號，創建註釋模版分組，比如我們命名為：MethodGroup；

（2）在第四步中的“Abbreviation”輸入框中添加填充註釋時需要輸入的指令關鍵字，此處我們使用“add”作為關鍵字，並在第五步中添加指令說明。經過這個步驟後，指令關鍵字會出現在上一步創建的註釋分組MethodGroup中，效果如圖中的第三步；
（3）編輯註釋內容模版，參考如下（註意：不需要以 /* 開頭，因為需要我們在添加註釋時會手動輸入）：

* 
 * @name: $enclosing_method$ 
 * @description: TODO  $param$
 * @return: $return$
 * @date: $date$ $time$
 * @auther: $user$
 * 
*/
 

（4）點擊第七步按鈕，在彈窗中指定註釋代碼裏參數的取值方式。

需要註意的是，如果param參數默認系統的methodParam()，那麽在註釋語句中，將以 “@param: [pa1, pa2...]”形式展現。我們使用groovyScript腳本來設置param的註釋語句格式，讓每個參數占一行。
腳本內容為：

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

（5）接下來指定填充註釋語句的提示字符，通過窗口中的“Expand with”來指定。"Space"表示空格，"Tab"表示 Tab鍵。
（6）最後是指定註釋的使用範圍，通過點擊窗口下面的“...Change"來完成。

三、使用代碼註釋模版
上述操作完成後，就可以使用註釋模版了。可以新建一個類，類文件頭註釋會自動生成。

在類中新建一個方法，然後在方法上面輸入 /*add ，並按 Space鍵(空格鍵) ，就會自動補齊整段註釋代碼了。

在Mac版本下的IDEA中設置代碼註釋模版