1.錯(cuò)誤碼規(guī)范

之前版本中是沒(méi)有關(guān)于「錯(cuò)誤碼」的整體說(shuō)明的，而這個(gè)版本增加了很大的篇幅，來(lái)把這個(gè)前后端配合的重要環(huán)節(jié)「錯(cuò)誤碼」部分，做了詳細(xì)的規(guī)范和說(shuō)明，可謂非常的香，具體規(guī)范如下：

• 【強(qiáng)制】錯(cuò)誤碼的制定原則：快速溯源、簡(jiǎn)單易記、溝通標(biāo)準(zhǔn)化。
• 【強(qiáng)制】錯(cuò)誤碼不體現(xiàn)版本號(hào)和錯(cuò)誤等級(jí)信息。
• 【強(qiáng)制】全部正常，但不得不填充錯(cuò)誤碼時(shí)返回五個(gè)零：00000。
• 【強(qiáng)制】錯(cuò)誤碼為字符串類型，共 5 位，分成兩個(gè)部分：錯(cuò)誤產(chǎn)生來(lái)源 + 四位數(shù)字編號(hào)。

說(shuō)明：錯(cuò)誤產(chǎn)生來(lái)源分為 A/B/C：

• A：表示錯(cuò)誤來(lái)源于用戶，比如參數(shù)錯(cuò)誤，用戶安裝版本過(guò)低，用戶支付超時(shí)等問(wèn)題；
• B：表示錯(cuò)誤來(lái)源于當(dāng)前系統(tǒng)，往往是業(yè)務(wù)邏輯出錯(cuò)，或程序健壯性差等問(wèn)題；
• C：表示錯(cuò)誤來(lái)源于第三方服務(wù)，比如 cdn 服務(wù)出錯(cuò)，消息投遞超時(shí)等問(wèn)題；四位數(shù)字編號(hào)從 0001 到 9999，大類之間的步長(zhǎng)間距預(yù)留 100，詳情可見(jiàn)《Java開(kāi)發(fā)手冊(cè)》正文。

2.擴(kuò)充了日期處理方案

一個(gè)寫(xiě)死為 365 天的年份天數(shù)，在閏年里讓大家嘗盡了悲傷痛楚，比如，緩存有效期 = 3652460*60 秒，結(jié)果提前一天所有緩存同時(shí)失效，高并發(fā)訪問(wèn)時(shí)數(shù)據(jù)庫(kù)就跪了。

【強(qiáng)制】不要在程序中寫(xiě)死一年為 365 天，避免在公歷閏年時(shí)出現(xiàn)日期轉(zhuǎn)換錯(cuò)誤或程序邏輯錯(cuò)誤。

正例：

// 獲取今年的天數(shù)
int daysOfThisYear = LocalDate.now().lengthOfYear();
// 獲取指定某年的天數(shù)
LocalDate.of(2011, 1, 1).lengthOfYear();

反例：

// 第一種情況：在閏年 366 天時(shí)，出現(xiàn)數(shù)組越界異常
int[] dayArray = new int[365];
// 第二種情況：一年有效期的會(huì)員制，今年 1 月 26 日注冊(cè)，硬編碼 365 返回的卻是 1 月 25 日
Calendar calendar = Calendar.getInstance();
calendar.set(2020, 1, 26);
calendar.add(Calendar.DATE, 365);

3.表別名規(guī)范

【強(qiáng)制】對(duì)于數(shù)據(jù)庫(kù)中表記錄的查詢和變更，只要涉及多個(gè)表，都需 表名）進(jìn)行限定。說(shuō)明：對(duì)多表進(jìn)行查詢記錄、更新記錄、刪除記錄時(shí)，如果對(duì)操作列沒(méi)有限定表的別名（或表名），并且 操作列在多個(gè)表中存在時(shí)，就會(huì)拋異常。正例：select t1.name from table_first as t1 , table_second as t2 where t1.id=t2.id;

反例：在某業(yè)務(wù)中，由于多表關(guān)聯(lián)查詢語(yǔ)句沒(méi)有加表的別名（或表名）的限制，正常運(yùn)行兩年后，最近在 某個(gè)表中增加一個(gè)同名字段，在預(yù)發(fā)布環(huán)境做數(shù)據(jù)庫(kù)變更后，線上查詢語(yǔ)句出現(xiàn)出 1052 異常：Column 'name' in field list is ambiguous。

【推薦】SQL 語(yǔ)句中表的別名前加 as，并且以 t1、t2、t3、...的順序依次命名。說(shuō)明：

• 別名可以是表的簡(jiǎn)稱，或者是根據(jù)表出現(xiàn)的順序，以 t1、t2、t3 的方式命名。
• 別名前加 as 使別名更容易識(shí)別。正例：select t1.name from table_first as t1, table_second as t2 where t1.id=t2.id;

4.三目運(yùn)算符規(guī)范

原來(lái)在三目運(yùn)算符中：

condition ? 表達(dá)式1 : 表達(dá)式2

表達(dá)式 1 和 2 在涉及算術(shù)計(jì)算或數(shù)據(jù)類型轉(zhuǎn)換時(shí)，會(huì)觸發(fā)自動(dòng)拆箱。拆箱操作本來(lái)沒(méi)有問(wèn)題，但是當(dāng)其中的操作數(shù)為 null 值時(shí)，一個(gè)大大的 NPE（NullPointerException）就砸到了我滴臉上，如下代碼所示：

Integer a = 1;
Integer b = 2;
Integer c = null;
Boolean flag = false;
Integer result = (flag ?  a * b  :  c);

注意：a*b 的結(jié)果是 int 類型，那么 c 會(huì)強(qiáng)制拆箱成 int 類型，拋出 NPE 異常。

【強(qiáng)制】三目運(yùn)算符 condition? 表達(dá)式 1 : 表達(dá)式 2 中，高度注意表達(dá)式 1 和 2 在類型對(duì)齊時(shí)，可能拋出因自動(dòng)拆箱導(dǎo)致的 NPE 異常。

說(shuō)明：以下兩種場(chǎng)景會(huì)觸發(fā)類型對(duì)齊的拆箱操作：

• 表達(dá)式 1 或表達(dá)式 2 的值只要有一個(gè)是原始類型。
• 表達(dá)式 1 或表達(dá)式 2 的值的類型不一致，會(huì)強(qiáng)制拆箱升級(jí)成表示范圍更大的那個(gè)類型。