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

五岳歸來不看山,黃山歸來不看岳逗噩!從 2015 年到 2022 年掉丽,希望這是愛因斯坦的第三個小板凳,點(diǎn)點(diǎn)滴滴异雁,希望對大家的程序員生涯有幫助

1. 聊聊版本沿革

最初的版本捶障,沒有名稱,只有版本號纲刀,從 1.0.0 開始项炼,后來感覺并不利于傳播,改成以五岳來命名示绊。因為華山最有武俠淵源锭部,所以第一個版本叫做《華山版》,邊上的碼出真功有點(diǎn)向周星馳電影功夫最后的場景《如來神掌》致敬的味道面褐;華山之后拌禾,去五岳至尊泰山朝圣,感受東海日出的壯觀展哭;泰山之后湃窍,去往嵩山,因為那里有一個金庸先生筆下武功最高的人物——掃地僧匪傍,所以封面用了掃地僧的原型您市。印象最深的是封面,太陽下的掃地僧在臺階上的影子役衡,來來回回還改了好幾次茵休,為了逼真,我覺得影子需要有點(diǎn)折子的感覺映挂,表達(dá)這是臺階上的影子泽篮;嵩山之后,不出意外是恒山版柑船,為此還去了懸空寺帽撑,結(jié)果無意中發(fā)現(xiàn)恒山和衡山的發(fā)音居然完全相同,這個在表達(dá)上是大忌鞍时,增加無謂的共同成本亏拉;為此還公開征集下一個版本名稱扣蜻,收到:天山版,屏峰版及塘,玉山版莽使,黃山版...,最后選擇了黃山版笙僚,是那句詩:五岳歸來不看山芳肌,黃山歸來不看岳,那就遺忘掉以前的版本肋层。

image.png

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

第一、都是使用了武俠的水墨畫風(fēng)格栋猖;第二净薛、都是使用的紅色印章的方式表達(dá)版本號;第三蒲拉、推廣中國元素和風(fēng)景區(qū)肃拜;

3. 黃山版的更新之處?

一、排版上

統(tǒng)一字號改小一號,條目之間統(tǒng)一留出 0.5 行的間距魄懂,即使本次新增 11 條辫狼,總頁數(shù)還是從嵩山版的 63 頁減少到本次的 55 頁:

image.png
image.png

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

image.png

回歸初心,碼出高效,碼出質(zhì)量,碼出快樂枢舶,從 2015 到 2022,痛并快樂著替久,堅持公益凉泄,堅持我的,一路走到黃山蚯根。無論是排版后众,樣式,說明颅拦,正反例蒂誉,過年也是仔仔校對,細(xì)細(xì)勘察距帅,相信黃山歸來不看岳右锨,《Java 開發(fā)手冊(黃山版)》,相信我輩程序員值得擁有哈~

注意B到铡I芤啤G那浴!

需要這份資料的朋友可以直接加下vx:lxmtim 免費(fèi)領(lǐng)取

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

孤盡老師蹂窖,一直是我的榜樣轧抗。你看,即使是在 2022 年的春節(jié)大聯(lián)歡的時候瞬测,他還在“內(nèi)卷”横媚,于 2 月 3 日整理發(fā)布出《Java 開發(fā)手冊(黃山版)》。

記得從《Java 開發(fā)手冊》剛發(fā)布時涣楷,自己拿到時的欣喜感分唾,像是“撿了個大便宜”--終于有一個國產(chǎn)的 JAVA 編碼的系統(tǒng)總結(jié)∈ǘ罚基于此,自己也在團(tuán)隊中組織培訓(xùn)了多次弧蝇。

特別是其中的編碼規(guī)約--并發(fā)處理碳褒,對于剛工作的開發(fā)人員,提前規(guī)避了很多坑看疗,也幫助自身快速熟悉了 JUC 常見集合的原理和異常處理沙峻。而對于高級開發(fā)人員,其中的設(shè)計規(guī)約两芳,從剛開始的理論熟悉摔寨,慢慢有了心悅誠服的認(rèn)可。

所以怖辆,當(dāng)《Java 開發(fā)手冊(黃山版)》發(fā)布后是复,我也迫不及待的通讀了一遍,我知道這又是一個“修武”的好機(jī)會竖螃,哈哈淑廊。

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

期待后面的版本有分布式腻格,架構(gòu)圖画拾,系統(tǒng)設(shè)計更多的內(nèi)容。(哈哈菜职,免費(fèi)的青抛,還這么貪心)

1. 例子更詳實(shí)了

1.1 常量定義-魔法值

image.png

1.2 OOP 規(guī)約--構(gòu)造方法

image.png

1.3 日期時間

image.png

1.4 并發(fā)處理-線程池

image.png

2. 說明更醒目了

2.1 代碼格式

image.png
image.png

3. 規(guī)約更完善了

3.1 浮點(diǎn)數(shù)類型的數(shù)值后綴統(tǒng)一為大寫的 D 或 F

image.png

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

image.png

3.3 【推薦】為了保護(hù)用戶隱私,日志文件中的用戶敏感信息需要進(jìn)行脫敏處理些楣。

image.png

3.4【強(qiáng)制】對于文件上傳功能脂凶,需要對于文件大小宪睹、類型進(jìn)行嚴(yán)格檢查和控制。

3.5【強(qiáng)制】配置文件中的密碼需要加密蚕钦。

image.png

3.6 【強(qiáng)制】在數(shù)據(jù)庫中不能使用物理刪除操作亭病,要使用邏輯刪除。

image.png

3.7 【強(qiáng)制】二方庫定制包的命名方式嘶居,在規(guī)定的版本號之后加“-英文說明[序號]”罪帖,英文說明可以是部門簡稱、業(yè)務(wù)名稱邮屁,序號直接緊跟在英文說明之后整袁,表示此定制包的順序號。

image.png

3.8【強(qiáng)制】調(diào)用遠(yuǎn)程操作必須有超時設(shè)置佑吝。

說明:類似于 HttpClient 的超時設(shè)置需要自己明確去設(shè)置 Timeout坐昙。根據(jù)經(jīng)驗表明,無數(shù)次的故障都是因為沒有設(shè)置

超時時間芋忿。

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

超時設(shè)置生效順序一般為:1)客戶端 Special Method炸客;2)客戶端接口級別;3)服務(wù)端 Special Method戈钢;4)服務(wù)端接口級別痹仙。

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

image.png

3.11 【強(qiáng)制】系統(tǒng)設(shè)計時要準(zhǔn)確識別出弱依賴薪铜,并針對性地設(shè)計降級和應(yīng)急預(yù)案众弓,保證核心系統(tǒng)正常可用痕囱。

image.png
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末田轧,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子鞍恢,更是在濱河造成了極大的恐慌傻粘,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,657評論 6 505
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件帮掉,死亡現(xiàn)場離奇詭異弦悉,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)蟆炊,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,889評論 3 394
  • 文/潘曉璐 我一進(jìn)店門稽莉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人涩搓,你說我怎么就攤上這事污秆∨恚” “怎么了?”我有些...
    開封第一講書人閱讀 164,057評論 0 354
  • 文/不壞的土叔 我叫張陵良拼,是天一觀的道長战得。 經(jīng)常有香客問我,道長庸推,這世上最難降的妖魔是什么常侦? 我笑而不...
    開封第一講書人閱讀 58,509評論 1 293
  • 正文 為了忘掉前任,我火速辦了婚禮贬媒,結(jié)果婚禮上聋亡,老公的妹妹穿的比我還像新娘。我一直安慰自己际乘,他們只是感情好坡倔,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,562評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著脖含,像睡著了一般致讥。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上器赞,一...
    開封第一講書人閱讀 51,443評論 1 302
  • 那天,我揣著相機(jī)與錄音墓拜,去河邊找鬼港柜。 笑死,一個胖子當(dāng)著我的面吹牛咳榜,可吹牛的內(nèi)容都是我干的夏醉。 我是一名探鬼主播,決...
    沈念sama閱讀 40,251評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼涌韩,長吁一口氣:“原來是場噩夢啊……” “哼畔柔!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起臣樱,我...
    開封第一講書人閱讀 39,129評論 0 276
  • 序言:老撾萬榮一對情侶失蹤靶擦,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后雇毫,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體玄捕,經(jīng)...
    沈念sama閱讀 45,561評論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,779評論 3 335
  • 正文 我和宋清朗相戀三年棚放,在試婚紗的時候發(fā)現(xiàn)自己被綠了枚粘。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,902評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡飘蚯,死狀恐怖馍迄,靈堂內(nèi)的尸體忽然破棺而出福也,到底是詐尸還是另有隱情,我是刑警寧澤攀圈,帶...
    沈念sama閱讀 35,621評論 5 345
  • 正文 年R本政府宣布暴凑,位于F島的核電站,受9級特大地震影響量承,放射性物質(zhì)發(fā)生泄漏搬设。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,220評論 3 328
  • 文/蒙蒙 一撕捍、第九天 我趴在偏房一處隱蔽的房頂上張望拿穴。 院中可真熱鬧,春花似錦忧风、人聲如沸默色。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,838評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽腿宰。三九已至,卻和暖如春缘厢,著一層夾襖步出監(jiān)牢的瞬間吃度,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,971評論 1 269
  • 我被黑心中介騙來泰國打工贴硫, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留椿每,地道東北人。 一個月前我還...
    沈念sama閱讀 48,025評論 2 370
  • 正文 我出身青樓英遭,卻偏偏與公主長得像间护,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子挖诸,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,843評論 2 354

推薦閱讀更多精彩內(nèi)容