黄山归来不看岳:《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 开发手册(黄山版)》,相信我辈程序员值得拥有哈~

注意!!!!

需要这份资料的朋友可以直接加下vx:lxmtim 免费领取

《Java 开发手册(黄山版)》

孤尽老师,一直是我的榜样。你看,即使是在 2022 年的春节大联欢的时候,他还在“内卷”,于 2 月 3 日整理发布出《Java 开发手册(黄山版)》。

记得从《Java 开发手册》刚发布时,自己拿到时的欣喜感,像是“捡了个大便宜”--终于有一个国产的 JAVA 编码的系统总结。基于此,自己也在团队中组织培训了多次。

特别是其中的编码规约--并发处理,对于刚工作的开发人员,提前规避了很多坑,也帮助自身快速熟悉了 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阅读 203,098评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,213评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,960评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,519评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,512评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,533评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,914评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,574评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,804评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,563评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,644评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,350评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,933评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,908评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,146评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,847评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,361评论 2 342

推荐阅读更多精彩内容