《碼出高效-阿里巴巴Java開發手冊-泰山版》阿里最新出品的泰山版Java開發手冊，告別垃圾程式碼

文章目錄

前言

東嶽泰山；西嶽華山；南嶽衡山；北嶽恆山；中嶽嵩山
其中以東嶽泰山為首，而這本阿里出品的泰山版 Java 開發手冊經過阿里巴巴技術團隊的集體智慧結晶和經驗總結，經歷了多次大規模一線實戰的檢驗及不斷的完善，系統化地整理成冊，是迄今為止最重量級的。

新版都更新了哪些內容呢？可以從官方的版本歷史中看得出來。

釋出錯誤碼統一解決方案

阿里巴巴

錯誤碼用來幹嘛呢？答案是異常紀錄檔，方便我們快速知曉錯誤來源，判斷是誰那出的問題。

上圖中 A 表示錯誤來源於使用者；
還有 B 級的，表示錯誤來源於當前系統；
C 級的，表示錯誤來源於第三方服務，比如 CDN 伺服器。

這個解決方案還是值得借鑑的，很多成熟的系統都在使用錯誤碼，如果你對接過微信支付的話，應該對錯誤碼不會感到陌生。看到錯誤碼，然後在手冊中搜尋一下，就能快速知曉錯誤的型別，還是很不錯的。

點選此處免費領取手冊，暗號csdn

新增 34 條新的規約

34 條太多了，我就挑幾個重要的拉出來說一說吧。

1）日期時間

還記得之前技術圈的刷屏事件吧？就是那個 YYYY 和 yyyy 造成的問題。大寫的 Y 表示的是當天所在的這一週是屬於哪個年份的，小寫的 y 表示的是當天所在的年份，差別還是挺大的。你品，你細品。

還有，大寫的 M 和小寫的 m 是不同的，大寫的 H 和小寫的 h 也是不同的。

阿里巴巴

另外，像獲取當前毫秒數應該使用 System.currentTimeMillis()，而不是 new Date().getTime()，這些細緻的規約，都應該牢記在心中，不要去犯這些低階的錯誤。

2）三目運算的 NPE 問題

說實話，這個問題我之前從來沒有注意，這次看到了，就一起來學習一下。先來看下面這段程式碼：

public class TestCondition {
    public static void main(String[] args) {
        Integer a = 1;
        Integer b = 2;
        Integer c = null;
        Boolean flag = false;
        Integer result = flag ? a * b : c;
    }
}

條件 a * b 屬於算術運算，它倆相乘後的結果是一個 int 型別，這就會導致 c 這個 Integer 型別自動拆箱，由於值為 null，就丟擲了以下錯誤：

Exception in thread "main" java.lang.NullPointerException
    at com.cmower.mkyong.TestCondition.main(TestCondition.java:9)

那可能你會感到好奇，為什麼兩個 Integer 型別的變數相乘後會是一個 int 型別呢，這主要是由編譯器決定的，它就是這麼設計的，來看一下反編譯後的位元組碼：

public class TestCondition
{
    public static void main(String args[])
    {
        Integer a = Integer.valueOf(1);
        Integer b = Integer.valueOf(2);
        Integer c = null;
        Boolean flag = Boolean.valueOf(false);
        Integer result = Integer.valueOf(flag.booleanValue() ? a.intValue() * b.intValue() : c.intValue());
    }
}

a * b 時發生了自動拆箱，呼叫了 intValue() 方法，而三元運算的兩個表示式的型別必須一致，這就導致 c 也呼叫了 intValue() 方法，由於 c 本身為 null，那就只能 NPE 了。明白了吧？

3）Collectors 類的 toMap() 方法

手冊上說，在使用 java.util.stream.Collectors 類的 toMap() 方法轉 Map 時，一定要使用含有引數型別為 BinaryOperator，引數名為 mergeFunction 的方法，否則當出現相同 key 值時會丟擲 IllegalStateException 異常。
這段話可能理解上有點難度，那先來看一段程式碼吧！

String[] departments = new String[] {"芸芸", "芸芸", "芸芸";
Map<Integer, String> map = Arrays.stream(departments)
        .collect(Collectors.toMap(String::hashCode, str -> str));

執行這段程式碼的時候，就會丟擲異常，堆疊資訊如下所示：

Exception in thread "main" java.lang.IllegalStateException: Duplicate key 867758096 (attempted merging values 芸芸and 芸芸)
    at java.base/java.util.stream.Collectors.duplicateKeyException(Collectors.java:133)
    at java.base/java.util.stream.Collectors.lambda$uniqKeysMapAccumulator$1(Collectors.java:180)

key 重複了，因為兩個「芸芸」的 hashCode 相同，那這時候的解決辦法呢？

String[] departments = new String[] {"芸芸", "芸芸", "芸芸"};
Map<Integer, String> map = Arrays.stream(departments)
        .collect(Collectors.toMap(String::hashCode, str -> str, (v1, v2) -> v2));

多加個引數 (v1, v2) -> v2，也就是重複的時候選一個。來看看此時呼叫的 toMap() 方法吧。

public static <T, K, U>
Collector<T, ?, Map<K,U>> toMap(Function<? super T, ? extends K> keyMapper,
                                Function<? super T, ? extends U> valueMapper,
                                BinaryOperator<U> mergeFunction) {
    return toMap(keyMapper, valueMapper, mergeFunction, HashMap::new);
}

BinaryOperator 和 mergeFunction 是不是出現了？

點選此處免費領取手冊，暗號csdn

修改描述 90 處

手冊上說，比如，阻塞等待鎖、建表的小數型別等描述有修改，我特麼花了半個小時也沒有找出來和上一個版本之間的差別。
阿里巴巴

不知道是不是手冊的小編在瞎說，你要是能發現差別，告訴我一聲。

點選此處免費領取手冊，暗號csdn

完善若干處範例

比如說 SQL 語句欄目裡的 ISNULL 的範例，確實比華山版追加了一個更詳細的反例，見下圖。

在這裡插入圖片描述
但說實話，這段反例的描述我看了至少六遍才搞懂是什麼意思。首先，不要在 null 前換行，影響閱讀性，這倒是真的；其次呢，不要使用 column is null 進行判空，使用 ISNULL(column) 判空，效率更高，也不會出現換行的情況。

select * from cms_subject where column is null and
column1 is not null;

select * from cms_subject where ISNULL(column) and
column1 is not null;

最後

2016 年 12 月份，阿里首次向業界開放了這份《Java 開發手冊》，到泰山版釋出，已經過去了 3 年多時間了，這份手冊也在全球 Java 開發者共同的努力下，成為業界普遍遵循的開發規範。這份手冊包含的知識點非常全面，七大維度程式設計規約、異常紀錄檔、單元測試、安全規約、MySQL資料庫、工程規約、設計規約都有羅列。

如果你想成為一名優秀的 Java 工程師，那麼這份手冊上的內容幾乎是必須要掌握的。如果你手上還沒有這份手冊，可以點選此處免費領取，暗號csdn。已經有了的程式設計師，請忽略。最後，我衷心地祝福你，希望你能學有所成，加油！

阿里巴巴

需要此檔案的可以點選此處免費領取，暗號csdn已經有了的程式設計師，請忽略。