文章目錄

• • 前言
  • 發布錯誤碼統一解決方案
  • 新增 34 條新的規約
  • • 1）日期時間
    • 2）三目運算的 NPE 問題
    • 3）Collectors 類的 toMap() 方法
  • 修改描述 90 處
  • 完善若干處示例
  • 最后

前言

東岳泰山；西岳華山；南岳衡山；北岳恒山；中岳嵩山
其中以東岳泰山為首，而這本阿里出品的泰山版 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.NullPointerExceptionat 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已經有了的程序員，請忽略。

總結

以上是生活随笔為你收集整理的《码出高效-阿里巴巴Java开发手册-泰山版》阿里最新出品的泰山版Java开发手册，告别垃圾代码的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。