黃山歸來不看岳:《Java 開發手冊(黃山版)》新增 11 條規約

五岳歸來不看山,黃山歸來不看岳!從 2015 年到 2022 年,希望這是愛因斯坦的第三個小板凳,點點滴滴,希望對大家的程序員生涯有幫助

1. 聊聊版本沿革

最初的版本,沒有名稱,只有版本號,從 1.0.0 開始,后來感覺并不利于傳播,改成以五岳來命名。因為華山最有武俠淵源,所以第一個版本叫做《華山版》,邊上的碼出真功有點向周星馳電影功夫最后的場景《如來神掌》致敬的味道;華山之后,去五岳至尊泰山朝圣,感受東海日出的壯觀;泰山之后,去往嵩山,因為那里有一個金庸先生筆下武功最高的人物——掃地僧,所以封面用了掃地僧的原型。印象最深的是封面,太陽下的掃地僧在臺階上的影子,來來回回還改了好幾次,為了逼真,我覺得影子需要有點折子的感覺,表達這是臺階上的影子;嵩山之后,不出意外是恒山版,為此還去了懸空寺,結果無意中發現恒山和衡山的發音居然完全相同,這個在表達上是大忌,增加無謂的共同成本;為此還公開征集下一個版本名稱,收到:天山版,屏峰版,玉山版,黃山版...,最后選擇了黃山版,是那句詩:五岳歸來不看山,黃山歸來不看岳,那就遺忘掉以前的版本。

image.png

2. 以上四個版本的共同之處?

第一、都是使用了武俠的水墨畫風格;第二、都是使用的紅色印章的方式表達版本號;第三、推廣中國元素和風景區;

3. 黃山版的更新之處?

一、排版上

統一字號改小一號,條目之間統一留出 0.5 行的間距,即使本次新增 11 條,總頁數還是從嵩山版的 63 頁減少到本次的 55 頁:

image.png
image.png

二、內容上的其他更新如最后的版本歷史所示:

image.png

回歸初心,碼出高效,碼出質量,碼出快樂,從 2015 到 2022,痛并快樂著,堅持公益,堅持我的,一路走到黃山。無論是排版,樣式,說明,正反例,過年也是仔仔校對,細細勘察,相信黃山歸來不看岳,《Java 開發手冊(黃山版)》,相信我輩程序員值得擁有哈~

注意?。。。?/h1>
需要這份資料的朋友可以直接加下vx:lxmtim 免費領取

《Java 開發手冊(黃山版)》

孤盡老師,一直是我的榜樣。你看,即使是在 2022 年的春節大聯歡的時候,他還在“內卷”,于 2 月 3 日整理發布出《Java 開發手冊(黃山版)》。

記得從《Java 開發手冊》剛發布時,自己拿到時的欣喜感,像是“撿了個大便宜”--終于有一個國產的 JAVA 編碼的系統總結?;诖耍约阂苍趫F隊中組織培訓了多次。

特別是其中的編碼規約--并發處理,對于剛工作的開發人員,提前規避了很多坑,也幫助自身快速熟悉了 JUC 常見集合的原理和異常處理。而對于高級開發人員,其中的設計規約,從剛開始的理論熟悉,慢慢有了心悅誠服的認可。

所以,當《Java 開發手冊(黃山版)》發布后,我也迫不及待的通讀了一遍,我知道這又是一個“修武”的好機會,哈哈。

看完《Java 開發手冊(黃山版)》,有三大感受: 例子更詳實了,說明更醒目了,規約更完善了(多了 11 條,下文會一一列舉)

期待后面的版本有分布式,架構圖,系統設計更多的內容。(哈哈,免費的,還這么貪心)

1. 例子更詳實了

1.1 常量定義-魔法值

image.png

1.2 OOP 規約--構造方法

image.png

1.3 日期時間

image.png

1.4 并發處理-線程池

image.png

2. 說明更醒目了

2.1 代碼格式

image.png
image.png

3. 規約更完善了

3.1 浮點數類型的數值后綴統一為大寫的 D 或 F

image.png

3.2 枚舉 enum(括號內)的屬性字段必須是私有且不可變

image.png

3.3 【推薦】為了保護用戶隱私,日志文件中的用戶敏感信息需要進行脫敏處理。

image.png

3.4【強制】對于文件上傳功能,需要對于文件大小、類型進行嚴格檢查和控制。

3.5【強制】配置文件中的密碼需要加密。

image.png

3.6 【強制】在數據庫中不能使用物理刪除操作,要使用邏輯刪除。

image.png

3.7 【強制】二方庫定制包的命名方式,在規定的版本號之后加“-英文說明[序號]”,英文說明可以是部門簡稱、業務名稱,序號直接緊跟在英文說明之后,表示此定制包的順序號。

image.png

3.8【強制】調用遠程操作必須有超時設置。

說明:類似于 HttpClient 的超時設置需要自己明確去設置 Timeout。根據經驗表明,無數次的故障都是因為沒有設置

超時時間。

3.9【推薦】客戶端設置遠程接口方法的具體超時時間(單位 ms)

超時設置生效順序一般為:1)客戶端 Special Method;2)客戶端接口級別;3)服務端 Special Method;4)服務端接口級別。

3.10【推薦】了解每個服務大致的平均耗時,可以通過獨立配置線程池,將較慢的服務與主線程池隔離開,免得不同服務的線程同歸于盡。

image.png

3.11 【強制】系統設計時要準確識別出弱依賴,并針對性地設計降級和應急預案,保證核心系統正常可用。

image.png
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,412評論 6 532
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,514評論 3 416
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,373評論 0 374
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,975評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,743評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,199評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,262評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,414評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,951評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,780評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,983評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,527評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,218評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,649評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,889評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,673評論 3 391
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,967評論 2 374

推薦閱讀更多精彩內容