idea 模版之自定義類與方法注釋
很多公司都有要求的代碼注釋規范,我們每新建類或者方法的時候從新復制粘貼很麻煩,而且容易粘錯。
當然自定義模板還可以用到很多地方,比如系統自帶的 sout就是system.out.print(); 當你輸入某文本的時候,系統會自動替換成目標文本。
1定義java文件頭部的注釋
2給java類中的方法添加上注釋
2.1第一步勾選enable live templates
2.2第二步新建一個group
2.3第三步新建一個template
2.4第四步點擊define按鈕
2.5第五步填寫注釋模板
1、定義java文件頭部的注釋
打開設置面板,然后填寫注釋模板:
file => setting => editor => file and code templates
如圖:
2、給java類中的方法添加上注釋
2.1、第一步勾選enable live templates
首先要在上一章節的圖中勾選中 enable live templates
如圖:
2.2、第二步新建一個group
其次要打開livetemplates 然后新建一個group
如圖:
在彈窗口中輸入你想要的group名稱,例如我取名叫chenjiegroup
如圖:
點擊ok,你已經新建了一個模板組,名稱叫chenjiegroup
如圖:
2.3、第三步新建一個template
選中新建的group,也就是選中chenjiegroup,在這個group下新建一個livetemplate
如圖:
上圖中點擊live template之后,將會新建一個模板,并且光標定位到了需要你輸入快捷鍵的方框中
如圖:
我輸入了cjm意思是當我在java文件的某個方法內部,連續輸入cjm后,intellij將會在該方法的頭上為我自動生成注釋(根據我接下來定義的模板來生成)。
2.4、第四步點擊define按鈕
點擊上圖中的ok按鈕左上方的define
如圖:
在彈出的下拉框內選擇作用域,這里選擇java文件
如圖:
2.5、第五步填寫注釋模板
在第四步完成后,templatetext框內的內容可以編輯了,在template text 內寫入模板,例如我敲入的模板是:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
/** *@描述 *@參數 $params$ *@返回值 $return$ *@創建人 chenjie *@創建時間 $date$ *@修改人和其它信息 */ |
如圖:
說明:在此步驟中,模板內容你可以自己寫,兩個$號內部是參數名稱,都有哪些參數呢,你可以點擊editvariables,然后在彈窗口中自己查看和選擇
點擊edit variables會彈出框
如圖:
彈出框
如圖:
上圖中,name這一列是你可以設置的參數名稱,expression這一列是你可以選擇的表達式,點擊expression這一列的單元格,即可出現下拉框
如圖:
例如我依次給params、return、date這三個變量設置了表達式
如圖:
點擊ok(兩個窗口上的ok都要點擊)
好了,現在可以驗證了。
新建一個utils類
如圖:
取名utils
如圖:
可以看到,文件頭部的注釋已經有了
如圖:
新建一個方法,內容如下:
1
2
3
4
|
public static string sayhello(string username) { return "hello " +username; } |
如圖:
在上圖畫紅框的地方輸入我們剛才設置的快捷鍵cmj即可看到intellij給我們添加的注釋
如圖:
快捷鍵需要在方法內部,也就是花括號內部,至于是不是在紅框的位置都可以,例如在return語句的后面或者其他地方也可以,只要是在sayhello方法內部即可。我輸入cjm然后就可以得到提示
如圖:
好了,敲回車后,intellij將我輸入的cjm替換為了方法的注釋(根據我們上一步設置的模板來生成注釋)
如圖:
說明:此時有點2,還需要自己把注釋剪切到方法外部去,不過總比我們手動敲注釋好多了。快捷鍵可以在方法外部敲,也可以生成注釋,但是參數和返回值就沒法給你生成了,因為參數和返回的值只有在函數作用域內,intellij才能找到,所以快捷鍵最好還是在方法內部敲,我剛才的cjm就是在方法內部敲的。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持服務器之家。
原文鏈接:https://blog.csdn.net/qq_33315102/article/details/78991220