控制語(yǔ)句
1. 【強(qiáng)制】在一個(gè) switch 塊內(nèi),每個(gè) case 要么通過 break / return 等來終止,要么注釋說明程序?qū)⒗^續(xù)執(zhí)行到哪一個(gè) case 為止 ; 在一個(gè) switch 塊內(nèi),都必須包含一個(gè) default 語(yǔ)句并且放在最后,即使它什么代碼也沒有。
2. 【強(qiáng)制】在 if / else / for / while / do 語(yǔ)句中必須使用大括號(hào),即使只有一行代碼,避免使用下面的形式: if (condition) statements;
3. 【推薦】推薦盡量少用 else , if - else 的方式可以改寫成:
if(condition){ ... return obj; }
// 接著寫 else 的業(yè)務(wù)邏輯代碼;
說明:如果非得使用 if()...else if()...else... 方式表達(dá)邏輯,【強(qiáng)制】請(qǐng)勿超過 3 層,超過請(qǐng)使用狀態(tài)設(shè)計(jì)模式。
正例:邏輯上超過 3 層的 if-else 代碼可以使用衛(wèi)語(yǔ)句,或者狀態(tài)模式來實(shí)現(xiàn)。
4. 【推薦】除常用方法(如 getXxx/isXxx)等外,不要在條件判斷中執(zhí)行其它復(fù)雜的語(yǔ)句,將復(fù)雜邏輯判斷的結(jié)果賦值給一個(gè)有意義的布爾變量名,以提高可讀性。
說明:很多 if 語(yǔ)句內(nèi)的邏輯相當(dāng)復(fù)雜,閱讀者需要分析條件表達(dá)式的最終結(jié)果,才能明確什么
樣的條件執(zhí)行什么樣的語(yǔ)句,那么,如果閱讀者分析邏輯表達(dá)式錯(cuò)誤呢?
正例:
//偽代碼如下 boolean existed = (file.open(fileName, "w") != null) && (...) || (...); if (existed) { ... }
反例:
if ((file.open(fileName, "w") != null) && (...) || (...)) { ... }
5. 【推薦】循環(huán)體中的語(yǔ)句要考量性能,以下操作盡量移至循環(huán)體外處理,如定義對(duì)象、變量、獲取數(shù)據(jù)庫(kù)連接,進(jìn)行不必要的 try - catch 操作 ( 這個(gè) try - catch 是否可以移至循環(huán)體外 ) 。
6. 【推薦】接口入?yún)⒈Wo(hù),這種場(chǎng)景常見的是用于做批量操作的接口。
7. 【參考】方法中需要進(jìn)行參數(shù)校驗(yàn)的場(chǎng)景:
1 ) 調(diào)用頻次低的方法。
2 ) 執(zhí)行時(shí)間開銷很大的方法,參數(shù)校驗(yàn)時(shí)間幾乎可以忽略不計(jì),但如果因?yàn)閰?shù)錯(cuò)誤導(dǎo)致中間執(zhí)行回退,或者錯(cuò)誤,那得不償失。
3 ) 需要極高穩(wěn)定性和可用性的方法。
4 ) 對(duì)外提供的開放接口,不管是 RPC / API / HTTP 接口。
5) 敏感權(quán)限入口。
8. 【參考】方法中不需要參數(shù)校驗(yàn)的場(chǎng)景:
1 ) 極有可能被循環(huán)調(diào)用的方法,不建議對(duì)參數(shù)進(jìn)行校驗(yàn)。但在方法說明里必須注明外部參數(shù)檢查。
2 ) 底層的方法調(diào)用頻度都比較高,一般不校驗(yàn)。畢竟是像純凈水過濾的最后一道,參數(shù)錯(cuò)誤不太可能到底層才會(huì)暴露問題。一般 DAO 層與 Service 層都在同一個(gè)應(yīng)用中,部署在同一臺(tái)服務(wù)器中,所以 DAO 的參數(shù)校驗(yàn),可以省略。
3 ) 被聲明成 private 只會(huì)被自己代碼所調(diào)用的方法,如果能夠確定調(diào)用方法的代碼傳入?yún)?span style="line-height: 1.76em;">數(shù)已經(jīng)做過檢查或者肯定不會(huì)有問題,此時(shí)可以不校驗(yàn)參數(shù)。