致全球Java開發者：

 

程式碼是二進位制世界的交流方式，極致的程式碼是我們的榮耀。

 

2017年春天，《阿里巴巴Java開發手冊》釋出，我們希望在涵蓋程式設計規約、異常日誌、單元測試、安全規約、MySQL資料庫、工程規約、設計規約等7個維度上為開發工作提供一點幫助。

 

目前已有超過260萬位工程師下載及查閱手冊，在數以千計的企業應用，手冊成為受業界認可的開發規範。我們也有幸為全行業的研發效能、人才培養、系統穩定性作出力所能及的一點貢獻。

 

兩年來，Java開發者們熱心參與，以幫助這本不夠完美的手冊日臻完善。曾有開發者追蹤問題長達半年之久，反覆探討、論證其正確性。這樣的開發者難以計數，也許相隔重洋，可能相逢不識，我們用程式碼確認一致的熱愛，也讓這本手冊的價值超越了單一公司。

 

因此，我們決定將手冊正式更名為《Java開發手冊》，它屬於所有參與其中的貢獻者，也以此聊表我們對全球Java開發者的感謝。

 

 

同時在今天，時隔一年，《Java開發手冊》正式推出更新版，涵蓋史無前例的三大升級：

 

1.新增21條新規約。比如，switch的空指標問題、浮點數的比較、無泛型限制引起的型別混亂、加鎖與解鎖的注意事項、YYYY的日期格式問題等；

 

2.修改描述112處。比如，IFNULL的判斷方式、集合的toArray的陣列長度、日誌佔位符的處理等；

 

3.完善若干處示例。比如，變數命名示例、衛語句示例、列舉示例、finally的return示例等。

 

如何免費下載？

 

掃描上方二維碼

免費下載《Java開發手冊》最新版

 

新版手冊有哪些值得關注的亮點？

 

首先是關於新增的21條故障相關的規範，全部源於業界經典事實故障，經過廣大開發者深度討論提煉而成。表面看似簡單，實質是直擊程式碼靈魂的考究，唯有內功深厚之人方能看透底層。隨手列舉其中三條，一起來感受下：

 

1.Lock 鎖的使用往往稍微不注意，可能導致死鎖的問題。

 

在使用阻塞等待獲取鎖的方式中，必須在 try 程式碼塊之外，並且在加鎖方法與 try 程式碼塊之間沒有任何可能丟擲異常的方法呼叫，避免加鎖成功後，在 finally 中無法解鎖。

 

如果在 lock 方法與 try 程式碼塊之間的方法呼叫丟擲異常，那麼無法解鎖，造成其它執行緒無法成功獲取鎖。如果 lock 方法在 try 程式碼塊之內，可能由於其它方法丟擲異常，導致在 finally程式碼塊中，unlock 對未加鎖的物件解鎖，它會呼叫 AQS 的 tryRelease 方法（取決於具體實現類），丟擲 IllegalMonitorStateException 異常。在 Lock 物件的 lock方法實現中可能丟擲 unchecked 異常。而在使用嘗試機制來獲取鎖的方式中，比如 tryLock()，在進入業務程式碼塊之前，必須先判斷當前執行緒是否持有鎖。

 

鎖的釋放規則與鎖的阻塞等待方式相同。Lock 物件的 unlock 方法在執行時，它會呼叫 AQS 的 tryRelease 方法（取決於具體實現類），如果當前執行緒不持有鎖，則丟擲 IllegalMonitorStateException 異常。

 

2.switch 的 NPE 問題。

 

當 switch 括號內的變數型別為 String 並且此變數為外部引數時，必須先進行 null 判斷。如下的程式碼輸出是什麼？

 

•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  

     publicclass SwitchString {         publicstaticvoidmain(String[] args){             method(null);         }          publicstaticvoidmethod(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.浮點數的比較問題。

 

1-0.9=0.1是天經地義的，但在計算機的世界裡，0.1恰恰是無法精確表示的一個小數，只有2的冪次倍小數才能夠精確表示，如：0.5、0.25、0.125等。由於0.1是近似表達，在各種情形中的計算存在數位的取捨精度不一樣，所以1-0.9未必等於0.9-0.8，所以浮點數之間的等值判斷，基本資料型別不能用==來比較，包裝資料型別不能用equals來判斷。

 

說明：浮點數採用“尾數+階碼”的編碼方式，類似於科學計數法的“有效數字+指數”的表示方式。二進位制無法精確表示大部分的十進位制小數，具體原理參考《碼出高效》。示例如下：

 

•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  

    float a = 1.0f - 0.9f;    float b = 0.9f - 0.8f;     if (a == b) {        // 預期進入此程式碼塊，執行其它業務邏輯        // 但是 a==b 的結果為false    }     Float x = Float.valueOf(a);    Float y = Float.valueOf(b);    if (x.equals(y)) {        // 預期進入此程式碼塊，執行其它業務邏輯        // 但是 x.equals(y) 的結果為false    }  

 

《Java開發手冊》自始至終不是最完美的，但是有了業界所有開發者的關注與支援，我們相信它在一步步走向完美。在廣大開發者的建議下，此次“華山版”修正了過往歷史版本的兩個錯誤。

 

1.集合轉陣列時的傳入陣列的空間設定。有讀者追蹤這個問題長達半年之久，大家可以到P3C的ISSUE裡找到關於這段論戰的歷史軌跡。他指出，toArray 的陣列長度必須設定為0。後來我們發現在高併發情況下，他的說法是對的。

 

2.關於 ScheduleService 的刪除。關於這個方法建立執行緒池，雖然可以模仿出來它的 OOM 情況，但是找遍 JDK 沒有任何替代的方式。所以我們回到它的原點問題上，深入地思考會不會有人使用 ScheduleService 的方式，不斷地加入佇列中呢？它是一個定時執行的執行緒池，這種操作方式是不是過於暴力、為賦新詞強說愁？權衡之下，最後新版手冊去掉這條規約的檢測。

 

為了讓更多基礎入門的開發者能更快、準確理解規約背後的思路，此次新版也對部分略顯艱澀的示例做了更生動的解釋。以貼合實際生活場景的視角，幫助讀者理解程式碼世界中的邏輯原理。

 

比如，關於衛語句的說明，原來的例子理解起來是有難度的，修正為從女孩子相親的視角來看待。在巢狀語句的要求中，如果非得使用 if()…else if()…else…方式表達邏輯，請勿超過3層，超過請使用狀態設計模式。超過3層的 if-else 的邏輯判斷程式碼可以使用衛語句、策略模式、狀態模式等來實現，其中衛語句示例如下：

•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  

public class GuardSatementsDemo{             public void findBoyfriend(Man man) {if(man.isBadTemper()) {                     System.out.println(“月球有多遠，你就給我滾多遠.”);                     return;                 }                  if (man.isShort()) {                     System.out.println(“我不需要武大郎一樣的男友.”);                     return;                 }                  if (man.isPoor()) {                     System.out.println(“貧賤夫妻百事哀.”);                     return;                 }                  System.out.println(“可以先交往一段時間看看.”);             }         }

 

特別感謝過去兩年中為《Java開發手冊》提供過寶貴意見與建議的所有開發者，你們是讀者，更是作者，這份榮譽屬於你們！

 

---

 

One more thing，週一Java測試題的正確答案為“BBBCB”，大家可以在手冊新版中找到解題思路。此外，6月27日，我們誠摯地邀請你與作者孤盡暢聊新版背後的故事，詳解題目深意，並有多本Java好書相贈。

 

歡迎點選“閱讀原文”，訪問阿里雲開發者社群，預約直播，下週三我們不見不散～

 

小彩蛋來啦！

 

對於時隔一年釋出的《Java開發手冊》最新版，你有哪些感想或建議？歡迎在留言區討論分享，我們將挑選5位最用心的同學送出《碼出高效》技術好書。

下載地址：

https://alitech-private.oss-cn-beijing.aliyuncs.com/1560932768000/Java%20huashan.pdf?Expires=1560944937&OSSAccessKeyId=LTAIqKGWQyF6Vd3W&Signature=Hsau8EUtCfJn5i8bpkPK1ClSJVQ%3D&nsukey=ljkSvnAz%2FB4VbPL0IPdtKfQjclvQJSkzq3O29dEKOjPd%2BJxMO5DyGERhQu4RBU7TWCzz10aCV1IvPJWOz8gAuFLkffaoueu650FXQDgiMzqTxmfUy1h0UBq7ciga91a%2BugXn8zdJhhKOS0BQOp%2BuASIcLw3H7%2Fw%2FZZCunaGTJdsaiYCbk%2FDTwct4Lk36xVKEYKxxOD6CsFyrTpBGyKM0Dw%3D%3D

相關推薦