一个关于写好代码的案例

今天上班修复一个bug的时候,发现自己原来写的一个函数已经被改的丑陋不堪。作为一个有原则的程序员,这样的事情最不能忍受,拯救代码之余,也有了下边的一些关于如何写好代码的想法。

在订单系统里有一个计算发货倒计时和确认收货倒计时的逻辑. 这个函数刚刚写出来时是这个样子, 看起来没什么大问题问题, 函数不太长, 逻辑也很直观. 当然如果较儿真的话这个函数有优化的空间, 但是现在动力不足, 不至于去重构.

Paste_Image.png

如果没有新的需求驱动修改这个函数的话, 可能这个函数一辈子也就这样了.

突然有一天, 新的逻辑来了订单可以支持延迟发货和收货. 所以相应的这两个倒计时也要加上extend的天数. 接下来, 这个函数演变成这个样子.

Paste_Image.png

现在这个函数看起来不爽了. 1. 重复的代码: (Instant.now().getEpochSecond() - order.getUpdatedAt().toInstant().getEpochSecond())出现了两次, getEpochSecond()出现了四次; 2. 对××DaysCount > 0 的判断也出现了两次; 3. 冗余的,嵌套的if结构, 这直接影响了代码的整洁和美观. 函数不大, 坏味道不少. 除了这些坏味道, 里边还隐藏着时间单位的错误(姑且命名这个错误为坏坏). 其实这个时候重构的时机已经成熟了.

如果当时代码修改者在写完这段逻辑之后, 驻足反思, 重构一下, 那么这段代码会以一个全新的面孔面对下一个代码修改者. 无疑一个逻辑清晰, 展现美观的函数, 是你留给队友最大的惊喜.

但是, 这样的惊喜最终还是没有留给队友. 终于有一天, 坏坏浮出水面, 导致页面显示错误, 出现了离谱的天数. 这个bug交给了蛋蛋解决. 蛋蛋眼明手快一眼定位到了坏坏. 把时间单位统一为SECOND, 一切working as expected.

高兴之余, 蛋蛋点着一根烟, 眉头紧锁, 若有所思... 其实他脑子里在演绎着重构心法:

  1. 首先我要把计算日期差值的重复逻辑去掉. Java8, 提供了方便的Duration类, 哪个Low B笨到自己去计算(殊不知, 这段代码就是蛋蛋自己写的);
  2. xxDaysCount > 0, 这个if判断, 我想通过加法结合律去掉. 经过缜密的调查确实是这样可以这样做, xxDaysCount在程序的上下文中是非负的, 用加法结合律改进没有问题;
  3. time这个命名也有问题, 词不达意.
    "啪啪啪..." 半根烟之后, 尘埃落定. 代码被整容成下边这个样子. 蛋蛋拿起剩下的半根烟, "嗯, 代码少了六行, 明显的重复代码也没了, 讨厌的if也被我干了..." 看起来比较顺眼了.
Paste_Image.png

心得:

  1. 代码不会变好, 只会逐渐变烂. 每一次修改代码都会让代码变烂, 多思考, 多重构可以代码变烂的速度减慢.
  2. 每次修改代码都是重构的最好契机.
  3. DRY & DRFY. 好代码最基本的两个原则: Don't Repeat Youself; Don't Repeat Fucking Yourself.
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容