為什么阿里巴巴Java開發(fā)手冊(cè)中不允許魔法值出現(xiàn)在代碼中来氧?

在閱讀《阿里巴巴Java開發(fā)手冊(cè)》時(shí),發(fā)現(xiàn)有一條關(guān)于關(guān)于常量定義的規(guī)約巷蚪,具體內(nèi)容如下:

圖中的反例是將數(shù)據(jù)緩存起來病毡,并使用魔法值加鏈路 id 組成 key,這就可能會(huì)出現(xiàn)其他開發(fā)人員在復(fù)制粘貼的時(shí)候屁柏,少?gòu)?fù)制 _ 的情況發(fā)生啦膜,這種錯(cuò)誤很難去檢查到,因?yàn)樽x取緩存不存在淌喻,可能會(huì)去數(shù)據(jù)庫(kù)讀取僧家,很難察覺到。

如果在生產(chǎn)環(huán)境中裸删,大量的請(qǐng)求進(jìn)來八拱,緩存全部失效,直接請(qǐng)求數(shù)據(jù)庫(kù)涯塔,導(dǎo)致數(shù)據(jù)庫(kù)連接過多肌稻,查詢效率變低的問題發(fā)生,因此看來魔法值確實(shí)應(yīng)該避免出現(xiàn)在代碼中伤塌。

另外在 《Clean Code》 和 《重構(gòu)》 等書中也提到了類似的問題灯萍,在代碼中出現(xiàn)原始形態(tài)數(shù)字通常來說是壞現(xiàn)象,應(yīng)該用命名良好的常量類隱藏它每聪。

靜態(tài)常量取代魔法值

像下面這個(gè)例子:

if (billCount > 75) {
    //todo
} else {
    //todo
}

如果在不了解這塊的業(yè)務(wù)的同事旦棉,在讀到這塊代碼的時(shí)候齿风,可能會(huì)想,75 是什么鬼绑洛,為啥和這個(gè)數(shù)比較救斑,背后深藏著什么秘密嗎?可能只有當(dāng)時(shí)的開發(fā)人員記得了真屯,導(dǎo)致代碼可讀性和可維護(hù)性極差脸候。

如果聲明一個(gè)常量,來替換該魔法值绑蔫,可能就會(huì)使代碼的可讀性和可維護(hù)性大大增加运沦。

static final Integer BASIC_BILL_COUNT = 75;

還有些魔法表達(dá)式,比如:

if (value > 60 && value <= 80 && type = 1) {
    // todo
}

比如這個(gè)表達(dá)式是表示狀態(tài)為正常且項(xiàng)目活躍配深,就可以定義:

boolean isActiveProject = value > 60 && value <= 80 && type = 1;

這樣是不是可讀性就提高了携添,一眼就可以看出來這塊代碼的邏輯。

枚舉類取代魔法值

還有一種消除魔法值的方式是使用枚舉類代替篓叶,下面讓我們舉個(gè)例子:

if (eventId == 1) {
    System.out.println("睡覺");
} else if (eventId == 2) {
    System.out.println("吃飯");
} else if (eventId == 3) {
    System.out.println("打豆豆");
}

如上代碼是針對(duì)事件 id 去執(zhí)行相應(yīng)的事件烈掠,如果事件比較少,大家還可以勉強(qiáng)記住每個(gè) eventId 對(duì)應(yīng)的含義缸托,但是隨著事件 id 的增多左敌,很可能會(huì)發(fā)生,新來的員工把事件 id 給搞混了俐镐,導(dǎo)致執(zhí)行錯(cuò)誤的事件矫限,發(fā)生 bug。

那么我們可以使用枚舉類來表示相應(yīng)的事件:

public enum EventEnum {

    /**
     * 睡覺
     */
    SLEEP_EVENT(1, "睡覺"),

    /**
     * 吃飯
     */
    EAT_EVENT(2, "吃飯"),

    /**
     * 打豆豆
     */
    FIGHT_PEA_EVENT(3, "打豆豆");

    private int eventId;
    private String desc;

    EventEnum(int eventId, String desc) {
        this.eventId = eventId;
        this.desc = desc;
    }

    public int getEventId() {
        return eventId;
    }

    public String getDesc() {
        return desc;
    }
}

修改完之后的代碼如下:

if (eventId == EventEnum.SLEEP_EVENT.getEventId()) {
    System.out.println("睡覺");
} else if (eventId == EventEnum.EAT_EVENT.getEventId()) {
    System.out.println("吃飯");
} else if (eventId == EventEnum.FIGHT_PEA_EVENT.getEventId()) {
    System.out.println("打豆豆");
}

是不是可讀性急劇提升京革,還不快看看自己代碼中有沒有這樣的魔法值出現(xiàn)奇唤,有的話趕緊改造起來幸斥。

還有如果你需要在不同的地點(diǎn)引用同一數(shù)值匹摇,魔法數(shù)會(huì)讓你煩惱不已,因?yàn)橐坏┻@些數(shù)字發(fā)生改變甲葬,就必須在程序中找到所有的魔法值廊勃,并將它們?nèi)啃薷囊槐椋@樣就太費(fèi)時(shí)費(fèi)力了经窖。

其實(shí)不只是 Java 不應(yīng)該在代碼中使用魔法值坡垫,其他語(yǔ)言亦是如此。

總結(jié)

本文主要介紹了為什么不允許在代碼中出現(xiàn)魔法值以及如何將代碼中已有的魔法值去除掉画侣。

代碼可讀性還是比較重要的冰悠,你肯定不希望別人在接手你的代碼的時(shí)候,罵到這數(shù)字啥意思配乱,這代碼寫得跟粑粑一樣溉卓。

最好的關(guān)系就是互相成就皮迟,大家的在看、轉(zhuǎn)發(fā)桑寨、留言三連就是我創(chuàng)作的最大動(dòng)力伏尼。

參考

《Java開發(fā)手冊(cè)》泰山版

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市尉尾,隨后出現(xiàn)的幾起案子爆阶,更是在濱河造成了極大的恐慌,老刑警劉巖沙咏,帶你破解...
    沈念sama閱讀 212,718評(píng)論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件辨图,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡肢藐,警方通過查閱死者的電腦和手機(jī)徒役,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,683評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來窖壕,“玉大人忧勿,你說我怎么就攤上這事≌胺恚” “怎么了鸳吸?”我有些...
    開封第一講書人閱讀 158,207評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)速勇。 經(jīng)常有香客問我晌砾,道長(zhǎng),這世上最難降的妖魔是什么烦磁? 我笑而不...
    開封第一講書人閱讀 56,755評(píng)論 1 284
  • 正文 為了忘掉前任养匈,我火速辦了婚禮,結(jié)果婚禮上都伪,老公的妹妹穿的比我還像新娘呕乎。我一直安慰自己,他們只是感情好陨晶,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,862評(píng)論 6 386
  • 文/花漫 我一把揭開白布猬仁。 她就那樣靜靜地躺著,像睡著了一般先誉。 火紅的嫁衣襯著肌膚如雪湿刽。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 50,050評(píng)論 1 291
  • 那天褐耳,我揣著相機(jī)與錄音诈闺,去河邊找鬼。 笑死铃芦,一個(gè)胖子當(dāng)著我的面吹牛雅镊,可吹牛的內(nèi)容都是我干的把曼。 我是一名探鬼主播,決...
    沈念sama閱讀 39,136評(píng)論 3 410
  • 文/蒼蘭香墨 我猛地睜開眼漓穿,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼嗤军!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起晃危,我...
    開封第一講書人閱讀 37,882評(píng)論 0 268
  • 序言:老撾萬榮一對(duì)情侶失蹤叙赚,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后僚饭,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體震叮,經(jīng)...
    沈念sama閱讀 44,330評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,651評(píng)論 2 327
  • 正文 我和宋清朗相戀三年鳍鸵,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了苇瓣。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,789評(píng)論 1 341
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡偿乖,死狀恐怖击罪,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情贪薪,我是刑警寧澤媳禁,帶...
    沈念sama閱讀 34,477評(píng)論 4 333
  • 正文 年R本政府宣布,位于F島的核電站画切,受9級(jí)特大地震影響竣稽,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜霍弹,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 40,135評(píng)論 3 317
  • 文/蒙蒙 一毫别、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧典格,春花似錦岛宦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,864評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至私恬,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間炼吴,已是汗流浹背本鸣。 一陣腳步聲響...
    開封第一講書人閱讀 32,099評(píng)論 1 267
  • 我被黑心中介騙來泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留硅蹦,地道東北人荣德。 一個(gè)月前我還...
    沈念sama閱讀 46,598評(píng)論 2 362
  • 正文 我出身青樓闷煤,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親涮瞻。 傳聞我的和親對(duì)象是個(gè)殘疾皇子鲤拿,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,697評(píng)論 2 351