Idea Live Template代碼片段總結


Idea Live Template總結

live template是idea中提高效率的利器之一,以前看過一些教程,平時經常在使用,減少了我很多繁復的工作,但是沒有系統的去整理過,最近准備系統的整理下,主要是自己平時用到的和官方文檔的說明,如果有不正確的地方。

定義: Live template可以讓你快速、高效、正確的插入平時經常使用的或者自定義的代碼片段。

一、演示

在開始之前,為了引起大家的興趣,我們先來看下使用live template的演示效果:

上面使用的就是live template,其中有預定義的sout,psvm和fori,還有自定義的todo和log等。可以看到使用live template可以用縮略詞產出設置好的代碼片段。

二、詳細介紹

2.1 類型

live template一共有三種類型分別是簡單、參數化和環繞類型。

  1. 簡單類型
    簡單類型就是固定的代碼片段,當通過縮略詞展開的時候,會在源代碼中展開。如最簡單和常用的pdvm展開就是main函數的定義。
  2. 參數類型
    參數類型就是代碼片段中帶有參數的模板,參數用$界定,如參數MY,這位$MY$,參數類型非常有用,我們自定義的模板很多都會用到參數,等會再設置中在進行講解。
  3. 環繞類型
    環繞模板指的是那種包裹代碼塊的模板,比如try catch,還有下面演示的callable語句。
    三種類型的演示如下:

2.2設置(win默認快捷鍵win+alt+s)

路徑如下圖箭頭1處:

如圖中所示,iterations是idea自帶的group,fori是縮略詞,顧名思義這個組是針對迭代等操作的。
在使用時我們可以輸入10.fori,list.fori或者直接輸入fori然后按tab鍵(箭頭7處)插入代碼。idea會根據上下文生成不同的代碼片段,如10.fori直接生成了“for (int i = 0; i < 10; i++) {”,而直接輸入fori則是“for (int i = 0; i < ; i++) {”,注意此時10沒有自動生成需要你手動輸入。
我們可以點擊2處新建自己的template,template的縮略詞在同一group內不能重復,所以為了不和自帶的鍵重復我們最好新建自己的一個group比如MY,不同的group中的縮略詞可以重復。箭頭5是描述用來助記的。
我們來自定義一個如下圖:

圖中是一個非常常用的輸入,根據類名來生成log靜態變量。你可以看到用$包裹的字符,這個就是上面介紹的參數類型,在生成的代碼片段中,如果要輸出$,需要用$轉義,即輸出$則在代碼片段中輸入$$。系統自帶兩個預定義的只讀變量,$END$和$SELECTION$,$END$代表代碼片段展開后光標最終停留的位置(如果有用戶自定義變量且需要用戶輸入的話則會一次停留在用戶變量處),默認如果不寫$END$光標會停留在最后,如果加和不加效果是一樣的。$SELECTION$代表的是你用光標選中的所有字符,屬於環繞類型,等會用例子會很明白。用戶變量需要我們賦值,點擊edit variables,在箭頭2處進行編輯。可以輸入兩種,一種是直接輸入字符串(需要用雙引號包裹)用的比較少因為是寫死的,另一種是idea的預定義函數(即通過下拉菜單選擇),比如這里就是取類名。idea有很多預定義的函數,比如日期,行數,方法名,作者等等。一般用到這些預定義的函數就已經足夠了,但是有時復雜的輸出,就需要使用groovy腳本(下拉菜單groovyScript,這里需要用到的語法很簡單)來進行。比如輸入方法的所有參數,如下圖:

我自定義了一個info(代碼片段:"$CLASS$.$METHOD$ linenum:$LINE$, param:{$PARAM$} info:$MY$"$END$),輸出了類名、方法名、行數和參數,這些信息在記錄日志的時候非常有必要。其中$PARAM$變量就用到了腳本。我們來看下

// methodParameters是預定義函數,其中雙引號里的就是腳本,_1占位符只帶methodParameters參數
groovyScript("_1.collect { it + ' = [\" + ' + it + ' + \"]'}.join(', ') ", methodParameters())

關於備份和分享:live template文件保存在“{user}\{version}\config\templates”,user是指用戶目錄,version是idea目錄,如我的目錄就是C:\Users\chen.IntelliJIdea2017.3\config\templates,其中的文件名以group為名字。也可以在在File->Export Settings對話框中選中live template可以保存配置。
說明:在設置變量的值時有一列是Skip if define,這一列的意思是,如果有值了是否跳過(即光標是否停留),光標停留的位置是變量對話框中的順序來定的,可以用右邊的箭頭排序。如果所有的變量填充完了便會跳到$END$變量的位置,如果沒有定義$END$則跳到代碼片段結尾。

2.3 快捷鍵

win平台默認的快捷鍵主要是三個ctrl+j(insert live template)、ctrl+alt+j(sround with live template)和ctrl+alt+t(sround with)。

快捷鍵是live template中經常需要用到的,所以需要記住。由於每個平台不一樣,也有可能有人修改了快捷鍵,所以我用括號注明了快捷鍵對應的名字,如果你的idea該快捷鍵不生效可以直接按圖中搜索名字。

  • ctrl+j:插入普通的live template
  • ctrl+alt+j:插入包裹的live template
  • ctrl+alt+t:插入包裹的代碼片段,這個包含了ctrl+alt+j但是又包含一些系統自帶的語句塊,比如if,while和for等等。

這里就需要重點介紹下包裹的代碼片段,其實就是指的你用光標選中的代碼。使用這種代碼片段需要我們用光標去選擇然后輸入快捷鍵ctrl+alt+t或者ctrl+alt+j選中需要的使用的縮略詞。在自定義的代碼片段中有個自帶的$SELECTION$指的就是你用光標選中的代碼,在插入代碼片段時,就會將你選中的代碼插入到$SELECTION$。讓我們在實現一個帶包裹代碼片段的sloge,設置如下:

注意設置中箭頭的位置,選擇java,表示快捷鍵應用的上下文。
使用方法: 用鼠標選中代碼,輸入ctrl+alt+j或者ctrl+alt+t選擇sloge。如下圖:

2.4 實戰

我自定義了幾個非常常用的代碼片段,分別是

  • "info":輸出調試信息
    // 代碼片段      
    "$CLASS$.$METHOD$  linenum:$LINE$, param:{$PARAM$} info:$MY$"$END$      
    // 變量定義     
    $CLASS$:className()      
    $METHOD$:methodName()   
    $LINE$:lineNumber()   
    $PARAM$:groovyScript("_1.collect { it + ' = [\" + ' + it + ' + \"]'}.join(', ') ",      methodParameters())   
  • "fen":分割線的注釋
    // 代碼片段 
    /* ---------------- $E$ -------------- */$END$
  • "log":定義日志常量
    // 代碼片段 
    private static final Logger logger= LoggerFactory.getLogger($CLASS$.class);
    // 變量定義     
    $CLASS$:className()  
  • "zhushi":帶名字和日期的注釋
    // 代碼片段 
    // comment --$USER$-- $D$ ------>$ANNOTATION$
    // 變量定義     
    $USER$:"chenfangzhi"    
    $D$ :date("YYYY-MM-DD hh:mm:ss")
  • "todo":todo注釋
    // 代碼片段 
    // todoBy$USER$ ---- $D$ ------>$TODO$
    // 變量定義     
    $USER$:"chenfangzhi"    
    $D$ :date("YYYY-MM-DD hh:mm:ss")

說明:todo的作用我就不講解了,這里的第4和第5項可能很像,有很多地方需要標注是誰操作的,現在的項目很多都是多人開發,如果都是使用默認的todo,就會很混亂,這時候我們就需要自己來定義屬於自己的todo注釋,這時候就需要帶上名字。代碼片段可以自己定義,可以同時帶上todo和名字,這樣在查看todo列表的時候就可以進行篩選。如下圖:

圖上有兩個todo,在todo列表中可以點擊箭頭2處的過濾器篩選自己想要的看到的類型。我就是直接看chen這個類型。2處有個Edit Filter可以編輯過濾類型,很簡單的正則匹配。


免責聲明!

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



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