Java開發(fā) 控制語句

2021-03-23 10:19 更新

\1. 【強制】在一個 switch 塊內(nèi),每個 case 要么通過 continue/break/return 等來終止,要么注釋說明程序?qū)⒗^續(xù)執(zhí)行到哪一個 case 為止;在一個 switch 塊內(nèi),都必須包含一個 default語句并且放在最后,即使它什么代碼也沒有。

  • 說明:注意 break 是退出 switch 語句塊,而 return 是退出方法體。

\2. 【強制】當 switch 括號內(nèi)的變量類型為 String 并且此變量為外部參數(shù)時,必須先進行 null判斷。

  • 反例:如下的代碼輸出是什么?

public class SwitchString {
    public static void main(String[] args) {
        method(null);
    }
    public static void method(String param) {
        switch (param) {
            // 肯定不是進入這里
            case "sth":
            System.out.println("it's sth");
            break;
            // 也不是進入這里
            case "null":
            System.out.println("it's null");
            break;
            // 也不是進入這里
            default:
            System.out.println("default");
        }
    } 
}

\3. 【強制】在 if/else/for/while/do 語句中必須使用大括號。

  • 說明:即使只有一行代碼,也禁止不采用大括號的編碼方式:if (condition) statements;

\4. 【強制】三目運算符 condition? 表達式 1 : 表達式 2 中,高度注意表達式 1 和 2 在類型對齊時,可能拋出因自動拆箱導致的 NPE 異常。

  • 說明:以下兩種場景會觸發(fā)類型對齊的拆箱操作: 1) 表達式 1 或表達式 2 的值只要有一個是原始類型。 2) 表達式 1 或表達式 2 的值的類型不一致,會強制拆箱升級成表示范圍更大的那個類型。

  • 反例:

Integer a = 1;
Integer b = 2;
Integer c = null;
Boolean flag = false;
// a*b 的結(jié)果是 int 類型,那么 c 會強制拆箱成 int 類型,拋出 NPE 異常
Integer result=(flag? a*b : c);

\5. 【強制】在高并發(fā)場景中,避免使用”等于”判斷作為中斷或退出的條件。

  • 說明:如果并發(fā)控制沒有處理好,容易產(chǎn)生等值判斷被“擊穿”的情況,使用大于或小于的區(qū)間判斷條件來代替。

  • 反例:判斷剩余獎品數(shù)量等于 0 時,終止發(fā)放獎品,但因為并發(fā)處理錯誤導致獎品數(shù)量瞬間變成了負數(shù),這樣的話,活動無法終止。

\6. 【推薦】當某個方法的代碼總行數(shù)超過 10 行時,return / throw 等中斷邏輯的右大括號后均需要加一個空行。

  • 說明:這樣做邏輯清晰,有利于代碼閱讀時重點關(guān)注。

\7. 【推薦】表達異常的分支時,少用 if-else 方式,這種方式可以改寫成:

if (condition) { 
    ...
    return obj; 
}
// 接著寫 else 的業(yè)務(wù)邏輯代碼; 

  • 說明:如果非使用 if()...else if()...else...方式表達邏輯,避免后續(xù)代碼維護困難,請勿超過 3 層。

  • 正例:超過 3 層的 if-else 的邏輯判斷代碼可以使用衛(wèi)語句、策略模式、狀態(tài)模式等來實現(xiàn),其中衛(wèi)語句

示例如下:

public void findBoyfriend (Man man) {
    if (man.isUgly()) {
        System.out.println("本姑娘是外貌協(xié)會的資深會員");
        return;
    }
    if (man.isPoor()) {
        System.out.println("貧賤夫妻百事哀");
        return;
    }
    if (man.isBadTemper()) {
        System.out.println("銀河有多遠,你就給我滾多遠");
        return; 
    }
    System.out.println("可以先交往一段時間看看");
}

\8. 【推薦】除常用方法(如 getXxx/isXxx)等外,不要在條件判斷中執(zhí)行其它復雜的語句,將復雜邏輯判斷的結(jié)果賦值給一個有意義的布爾變量名,以提高可讀性。

  • 說明:很多 if 語句內(nèi)的邏輯表達式相當復雜,與、或、取反混合運算,甚至各種方法縱深調(diào)用,理解成本非常高。如果賦值一個非常好理解的布爾變量名字,則是件令人爽心悅目的事情。

  • 正例:

// 偽代碼如下
final boolean existed = (file.open(fileName, "w") != null) && (...) || (...);
if (existed) {
    ...
}

  • 反例:

public final void acquire ( long arg) {
    if (!tryAcquire(arg) &&
    acquireQueued(addWaiter(Node.EXCLUSIVE), arg)) {
        selfInterrupt();
    }
}

\9. 【推薦】不要在其它表達式(尤其是條件表達式)中,插入賦值語句。

說明:賦值點類似于人體的穴位,對于代碼的理解至關(guān)重要,所以賦值語句需要清晰地單獨成為一行。

  • 反例:

public Lock getLock(boolean fair) {
    // 算術(shù)表達式中出現(xiàn)賦值操作,容易忽略 count 值已經(jīng)被改變
    threshold = (count = Integer.MAX_VALUE) - 1;
    // 條件表達式中出現(xiàn)賦值操作,容易誤認為是 sync==fair
    return (sync = fair) ? new FairSync() : new NonfairSync();
}

10.【推薦】循環(huán)體中的語句要考量性能,以下操作盡量移至循環(huán)體外處理,如定義對象、變量、獲取數(shù)據(jù)庫連接,進行不必要的 try-catch 操作(這個try-catch 是否可以移至循環(huán)體外)。

11.【推薦】避免采用取反邏輯運算符。

  • 說明:取反邏輯不利于快速理解,并且取反邏輯寫法一般都存在對應(yīng)的正向邏輯寫法。
  • 正例:使用 if (x < 628) 來表達 x 小于 628。
  • 反例:使用 if (!(x >= 628)) 來表達 x 小于 628。

12.【推薦】公開接口需要進行入?yún)⒈Wo,尤其是批量操作的接口。

  • 反例:某業(yè)務(wù)系統(tǒng),提供一個用戶批量查詢的接口,API 文檔上有說最多查多少個,但接口實現(xiàn)上沒做任何保護,導致調(diào)用方傳了一個 1000 的用戶 id 數(shù)組過來后,查詢信息后,內(nèi)存爆了。

13.【參考】下列情形,需要進行參數(shù)校驗:

1) 調(diào)用頻次低的方法。

2) 執(zhí)行時間開銷很大的方法。此情形中,參數(shù)校驗時間幾乎可以忽略不計,但如果因為參數(shù)錯誤導致 中間執(zhí)行回退,或者錯誤,那得不償失。

3) 需要極高穩(wěn)定性和可用性的方法。

4) 對外提供的開放接口,不管是 RPC/API/HTTP 接口。

5) 敏感權(quán)限入口。

14.【參考】下列情形,不需要進行參數(shù)校驗:

1) 極有可能被循環(huán)調(diào)用的方法。但在方法說明里必須注明外部參數(shù)檢查。

2) 底層調(diào)用頻度比較高的方法。畢竟是像純凈水過濾的最后一道,參數(shù)錯誤不太可能到底層才會暴露問題。一般 DAO 層與 Service 層都在同一個應(yīng)用中,部署在同一臺服務(wù)器中,所以 DAO 的參數(shù)校驗,可以省略。

3) 被聲明成 private 只會被自己代碼所調(diào)用的方法,如果能夠確定調(diào)用方法的代碼傳入?yún)?shù)已經(jīng)做過檢查或者肯定不會有問題,此時可以不校驗參數(shù)。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號