摘要:暴露接口如果是函數,就擴展,否則就是驗證數據使用金額校驗規(guī)則這樣運行能正常,也有擴展性性,但是對于代碼潔癖的來說,這樣寫法不優(yōu)雅。
重構不是對以前代碼的全盤否定,而是利用更好的方式,寫出更好,更有維護性代碼。不斷的追求與學習,才有更多的進步。1.前言
做前端開發(fā)有一段時間了,在這段時間里面,對于自己的要求,不僅僅是項目能完成,功能正常使用這一層面上。還盡力的研究怎么寫出優(yōu)雅的代碼,性能更好,維護性更強的代碼,通俗一點就是重構。這篇文章算是我一個小記錄,在此分享一下。該文章主要針對介紹,例子也簡單,深入復雜的例子等以后有適合的實例再進行寫作分享。如果大家對怎么寫出優(yōu)雅的代碼,可維護的代碼,有自己的見解,或者有什么重構的實力,歡迎指點評論。
關于重構,準備寫一個系列的文章,不定時更新,主要針對以下方案:邏輯混亂重構,分離職責重構,添加擴展性重構,簡化使用重構,代碼復用重構。其中會穿插以下原則:單一職責原則,最少知識原則,開放-封閉原則。如果大家對重構有什么好的想法,或者有什么好的實例,歡迎留言評論,留下寶貴的建議。2.什么是重構
首先,重構不是重寫。重構大概的意思是在不影響項目的功能使用前提下,使用一系列的重構方式,改變項目的內部結構。提高項目內部的可讀性,可維護性。
無論是什么項目,都有一個從簡單到復雜的一個迭代過程。在這個過程里面,在不影響項目的使用情況下,需要不斷的對代碼進行優(yōu)化,保持或者增加代碼的可讀性,可維護性。這樣一來,就可以避免在團隊協(xié)作開發(fā)上需要大量的溝通,交流。才能加入項目的開發(fā)中。
3.為什么重構衣服臟了就洗,破了就補,不合穿就扔。
隨著業(yè)務需求的不斷增加,變更,舍棄,項目的代碼也難免會出現瑕疵,這就會影響代碼的可讀性,可維護性,甚至影響項目的性能。而重構的目的,就是為了解決這些瑕疵,保證代碼質量和性能。但是前提是不能影響項目的使用。
至于重構的原因,自己總結了一下,大概有以下幾點
函數邏輯結構混亂,或因為沒注釋原因,連原代碼寫作者都很難理清當中的邏輯。
函數無擴展性可言,遇到新的變化,不能靈活的處理。
因為對象強耦合或者業(yè)務邏輯的原因,導致業(yè)務邏輯的代碼巨大,維護的時候排查困難。
重復代碼太多,沒有復用性。
隨著技術的發(fā)展,代碼可能也需要使用新特性進行修改。
隨著學習的深入,對于以前的代碼,是否有著更好的一個解決方案。
因為代碼的寫法,雖然功能正常使用,但是性能消耗較多,需要換方案進行優(yōu)化
4.何時重構在合適的時間,在合適的事情
在我的理解中,重構可以說是貫穿整一個項目的開發(fā)和維護周期,可以當作重構就是開發(fā)的一部分。通俗講,在開發(fā)的任何時候,只要看到代碼有別扭,激發(fā)了強迫癥,就可以考慮重構了。只是,重構之前先參考下面幾點。
首先,重構是需要花時間去做的一件事。花的時間可能比之前的開發(fā)時間還要多。
其次,重構是為了把代碼優(yōu)化,前提是不能影響項目的使用。
最后,重構的難度大小不一,可能只是稍微改動,可能難度比之前開發(fā)還要難。
基于上面的幾點,需要大家去評估是否要進行重構。評估的指標,可以參考下面幾點
數量: 需要重構的代碼是否過多。
質量: 可讀性,可維護性,代碼邏輯復雜度,等問題,對代碼的質量影響是否到了一個難以忍受的地步。
時間: 是否有充裕的時間進行重構和測試。
效果: 如果重構了代碼,得到哪些改善,比如代碼質量提高了,性能提升了,更好的支持后續(xù)功能等。
5.怎么重構選定目標,針對性出擊
怎么重構,這個就是具體情況,具體分析了。如同“為什么重構一樣”。發(fā)現代碼有什么問題就針對什么情況進行改進。
重構也是寫代碼,但是不止于寫,更在于整理和優(yōu)化。如果說寫代碼需要一個‘學習--了解-熟練’的過程,那么重構就需要一個‘學習-感悟-突破-熟練’的過程。
針對重構的情況,下面簡單的用幾個例子進行說明
5-1.函數無擴展性如下面一個例子,在我一個庫的其中一個 API
//檢測字符串 //checkType("165226226326","mobile") //result:false let checkType=function(str, type) { switch (type) { case "email": return /^[w-]+(.[w-]+)*@[w-]+(.[w-]+)+$/.test(str); case "mobile": return /^1[3|4|5|7|8][0-9]{9}$/.test(str); case "tel": return /^(0d{2,3}-d{7,8})(-d{1,4})?$/.test(str); case "number": return /^[0-9]$/.test(str); case "english": return /^[a-zA-Z]+$/.test(str); case "text": return /^w+$/.test(str); case "chinese": return /^[u4E00-u9FA5]+$/.test(str); case "lower": return /^[a-z]+$/.test(str); case "upper": return /^[A-Z]+$/.test(str); default: return true; } }
這個 API 看著沒什么毛病,能檢測常用的一些數據。但是有以下兩個問題。
1.但是如果想到添加其他規(guī)則的呢?就得在函數里面增加 case 。添加一個規(guī)則就修改一次!這樣違反了開放-封閉原則(對擴展開放,對修改關閉)。而且這樣也會導致整個 API 變得臃腫,難維護。
2.還有一個問題就是,比如A頁面需要添加一個金額的校驗,B頁面需要一個日期的校驗,但是金額的校驗只在A頁面需要,日期的校驗只在B頁面需要。如果一直添加 case 。就是導致A頁面把只在B頁面需要的校驗規(guī)則也添加進去,造成不必要的開銷。B頁面也同理。
建議的方式是給這個 API 增加一個擴展的接口
let checkType=(function(){ let rules={ email(str){ return /^[w-]+(.[w-]+)*@[w-]+(.[w-]+)+$/.test(str); }, mobile(str){ return /^1[3|4|5|7|8][0-9]{9}$/.test(str); }, tel(str){ return /^(0d{2,3}-d{7,8})(-d{1,4})?$/.test(str); }, number(str){ return /^[0-9]$/.test(str); }, english(str){ return /^[a-zA-Z]+$/.test(str); }, text(str){ return /^w+$/.test(str); }, chinese(str){ return /^[u4E00-u9FA5]+$/.test(str); }, lower(str){ return /^[a-z]+$/.test(str); }, upper(str){ return /^[A-Z]+$/.test(str); } }; //暴露接口 return { //校驗 check(str, type){ return rules[type]?rules[type](str):false; }, //添加規(guī)則 addRule(type,fn){ rules[type]=fn; } } })(); //調用方式 //使用mobile校驗規(guī)則 console.log(checkType.check("188170239","mobile")); //添加金額校驗規(guī)則 checkType.addRule("money",function (str) { return /^[0-9]+(.[0-9]{2})?$/.test(str) }); //使用金額校驗規(guī)則 console.log(checkType.check("18.36","money"));
上面的代碼,是多了一些,但是理解起來也沒怎么費勁,而且拓展性也有了。
上面這個改進其實是使用了策略模式(把一系列的算法進行封裝,使算法代碼和邏輯代碼可以相互獨立,并且不會影響算法的使用)進行改進的。策略模式的概念理解起來有點繞,但是大家看著代碼,應該不繞。
這里展開講一點,在功能上來說,通過重構,給函數增加擴展性,這里實現了。但是如果上面的 checkType是一個開源項目的 API ,重構之前調用方式是:checkType("165226226326","phone") 。重構之后調用方式是: checkType.check("188170239","phone") ;或者 checkType.addRule() ;。如果開源項目的作者按照上面的方式重構,那么之前使用了開源項目的 checkType 這個 API 的開發(fā)者,就可能悲劇了,因為只要開發(fā)者一更新這個項目版本,就有問題。因為上面的重構沒有做向下兼容。
如果要向下兼容,其實也不難。加一個判斷而已。
let checkType=(function(){ let rules={ email(str){ return /^[w-]+(.[w-]+)*@[w-]+(.[w-]+)+$/.test(str); }, mobile(str){ return /^1[3|4|5|7|8][0-9]{9}$/.test(str); }, tel(str){ return /^(0d{2,3}-d{7,8})(-d{1,4})?$/.test(str); }, number(str){ return /^[0-9]$/.test(str); }, english(str){ return /^[a-zA-Z]+$/.test(str); }, text(str){ return /^w+$/.test(str); }, chinese(str){ return /^[u4E00-u9FA5]+$/.test(str); }, lower(str){ return /^[a-z]+$/.test(str); }, upper(str){ return /^[A-Z]+$/.test(str); } }; //暴露接口 return function (str,type){ //如果type是函數,就擴展rules,否則就是驗證數據 if(type.constructor===Function){ rules[str]=type; } else{ return rules[type]?rules[type](str):false; } } })(); console.log(checkType("188170239","mobile")); checkType("money",function (str) { return /^[0-9]+(.[0-9]{2})?$/.test(str) }); //使用金額校驗規(guī)則 console.log(checkType("18.36","money"));
這樣運行能正常,也有擴展性性,但是對于代碼潔癖的來說,這樣寫法不優(yōu)雅。因為 checkType 違反了函數單一原則。一個函數負責過多的職責可能會導致以后不可估量的問題,使用方面也很讓人疑惑。
面對這樣的情況,就個人而言,了解的做法是:保留 checkType ,不做任何修改,在項目里面增加一個新的 API ,比如 checkTypOfString ,把重構的代碼寫到 checkTypOfString 里面。通過各種方式引導開發(fā)者少舊 checkType ,多用 checkTypOfString 。之后的項目迭代里面,合適的時候廢棄 checkType 。
5-2.函數違反單一原則函數違反單一原則最大一個后果就是會導致邏輯混亂。如果一個函數承擔了太多的職責,不妨試下:函數單一原則 -- 一個函數只做一件事。
如下例子
//現有一批的錄入學生信息,但是數據有重復,需要把數據進行去重。然后把為空的信息,改成保密。 let students=[ { id:1, name:"守候", sex:"男", age:"", }, { id:2, name:"浪跡天涯", sex:"男", age:"" }, { id:1, name:"守候", sex:"", age:"" }, { id:3, name:"鴻雁", sex:"", age:"20" } ]; function handle(arr) { //數組去重 let _arr=[],_arrIds=[]; for(let i=0;i{ for(let key in item){ if(item[key]===""){ item[key]="保密"; } } }); return _arr; } console.log(handle(students))
運行結果沒有問題,但是大家想一下,如果以后,如果改了需求,比如,學生信息不會再有重復的記錄,要求把去重的函數去掉。這樣一來,就是整個函數都要改了。還影響到下面的操作流程。相當于了改了需求,整個方法全跪。城門失火殃及池魚。
下面使用單一原則構造一下
let handle={ removeRepeat(arr){ //數組去重 let _arr=[],_arrIds=[]; for(let i=0;i{ for(let key in item){ if(item[key]===""){ item[key]="保密"; } } }); return arr; } }; students=handle.removeRepeat(students); students=handle.setInfo(students); console.log(students);
結果一樣,但是需求改下,比如不需要去重,把代碼注釋或者直接刪除就好。這樣相當于把函數的職責分離了,而且職責之前互不影響。中間去除那個步驟不會影響下一步。
//students=handle.removeRepeat(students); students=handle.setInfo(students); console.log(students);5-3.函數寫法優(yōu)化
這種情況就是,對于以前的函數,在不影響使用的情況下,現在有著更好的實現方式。就使用更好的解決方案,替換以前的解決方案。
比如下面的需求,需求是群里一個朋友發(fā)出來的,后來引發(fā)的一些討論。給出一個20180408000000字符串,formatDate函數要處理并返回2018-04-08 00:00:00。
以前的解法
let _dete="20180408000000" function formatStr(str){ return str.replace(/(d{4})(d{2})(d{2})(d{2})(d{2})(d{2})/, "$1-$2-$3 $4:$5:$6") } formatStr(_dete); //"2018-04-08 00:00:00"
后來研究了這樣的解法。這個方式就是根據x的位置進行替換填充數據,不難理解
let _dete="20180408000000" function formatStr(str,type){ let _type=type||"xxxx-xx-xx xx:xx:xx"; for(let i = 0; i < str.length; i++){ _type = _type.replace("x", str[i]); } return _type; } formatStr(_dete); result:"2018-04-08 00:00:00"
在之后的幾天,在掘金一篇文章(那些優(yōu)雅靈性的JS代碼片段,感謝提供的寶貴方式)的評論里面發(fā)現更好的實現方式,下面根據上面的需求自己進行改造。
let _dete="20180408000000" function formatStr(str,type){ let i = 0,_type = type||"xxxx-xx-xx xx:xx:xx"; return _type .replace(/x/g, () => str[i++]) } formatStr(_dete); result:"2018-04-08 00:00:00"5-4.代碼復用
上面幾個例子都是js的,說下與html沾邊一點的兩個例子--vue數據渲染。
下面代碼中,payChannelEn2Cn addZero formatDateTime函數都是在vue的methods里面。大家注意。
以前寫法
現金 支票 匯票 支付寶 微信支付 銀行轉賬 預付款
這樣寫的問題在于,首先是代碼多,第二是如果項目有10個地方這樣渲染數據,如果渲染的需求變了。比如銀行轉賬的值從 bank_trans 改成 bank ,那么就得在項目里面修改10次。時間成本太大。
后來就使用了下面的寫法,算是一個小重構吧
{{payChannelEn2Cn(cashType)}}
payChannelEn2Cn 函數,輸出結果
payChannelEn2Cn(tag){ let _obj = { "cash": "現金", "check": "支票", "draft": "匯票", "zfb": "支付寶", "wx_pay": "微信支付", "bank_trans": "銀行轉賬", "pre_pay": "預付款" }; return _obj[tag]; }
還有一個例子就是時間戳轉時間的寫法。原理一樣,只是代碼不同。下面是原來的代碼。
{{new Date(payTime).toLocaleDateString().replace(///g, "-")}}
{{addZero(new Date(payTime).getHours())}}:
{{addZero(new Date(payTime).getMinutes())}}:
{{addZero(new Date(payTime).getSeconds())}}
addZero時間補零函數
Example:3->03 addZero(i){ if (i < 10) { i = "0" + i; } return i; }
問題也和上面的一樣,這里就不多說了,就寫重構后的代碼
{{formatDateTime(payTime)}}
formatDateTime函數,格式化字符串
formatDateTime(dateTime){ return `${new Date(payTime).toLocaleDateString().replace(///g, "-")} ${this.addZero(new Date(payTime).getHours())}:${this.addZero(new Date(payTime).getMinutes())}:${this.addZero(new Date(payTime).getSeconds())}`; }
可能很多人看到這里,覺得重構很簡單,這樣想是對的,重構就是這么簡單。但是重構也難,因為重構一步登天,需要一個逐步的過程,甚至可以說重構就是一次次的小改動,逐步形成一個質變的過程。如何保證每一次的改動都是有意義的改善代碼;如何保證每一次的改動都不會影響到項目的正常使用;如果發(fā)現某次改動沒有意義,或者改動了反而讓代碼更糟糕的時候,可以隨時停止或回滾代碼,這些才是重構的難點。6.小結
關于重構就說到這里了,該文章主要是介紹重構,例子方面都是很簡單的一些例子。目的是為了好些理解重構的一些概念。關于重構,可能很復雜,可能很簡單。怎么重構也是具體情況,具體分析,重構也沒有標準的答案。以后,如果有好的例子,我會第一時間分享,給大家具體情況,具體分析的講述:為什么重構,怎么重構。
最后,如果大家對文章有什么建議,看法,歡迎交流,相互學習,共同進步。
-------------------------華麗的分割線--------------------
想了解更多,關注關注我的微信公眾號:守候書閣
文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/94524.html
摘要:無論如何,單元測試一直是一中非常重要卻常常被忽視的技能。在實踐中,重構的要求是很高的它需要有足夠詳盡的單元測試,需要有持續(xù)集成的環(huán)境,需要隨時隨地在小步伐地永遠讓代碼處于可工作狀態(tài)下去進行改善。 showImg(https://segmentfault.com/img/bVbttWF?w=1000&h=528); 五月初的時候朋友和我說《重構》出第 2 版了,我才興沖沖地下單,花了一個...
摘要:技術前端布局推進劑間距規(guī)范化利用變量實現令人震驚的懸浮效果很棒,但有些情況不適用布局說可能是最全的圖片版學習網格布局使用的九大誤區(qū)圖解布局布局揭秘和中新增功能探索版本迭代論基礎談展望對比探究繪圖中撤銷功能的實現方式即將更改的生命周期幾道高 技術 CSS 前端布局推進劑 - 間距規(guī)范化 利用CSS變量實現令人震驚的懸浮效果 Flexbox 很棒,但有些情況不適用 CSS布局說——可能是最...
摘要:函數改名問題函數的名稱未能揭示函數的用途。這些人甚至會在構造函數中使用設值函數。方法將構造函數替換為工廠函數。以上所說的情況,常會在返回迭代器或集合的函數身上發(fā)生。以異常取代錯誤碼問題某個函數返回一個特定的代碼,用以表示某種錯誤情況。 Rename Method 函數改名 問題 函數的名稱未能揭示函數的用途。 方法 修改函數名稱。 動機 好的函數需要有一個清晰的函數名。保證一看就懂 A...
閱讀 1626·2021-10-25 09:46
閱讀 3209·2021-10-08 10:04
閱讀 2354·2021-09-06 15:00
閱讀 2768·2021-08-19 10:57
閱讀 2077·2019-08-30 11:03
閱讀 971·2019-08-30 11:00
閱讀 2370·2019-08-26 17:10
閱讀 3545·2019-08-26 13:36