Go 中常用的四大重構(gòu)技術(shù)
大家好,我是程序員幽鬼。
Martin Fowler 在他的書(shū)中[1]將重構(gòu)定義為*“對(duì)軟件的內(nèi)部結(jié)構(gòu)進(jìn)行的更改,以使其更易于理解,并且在不更改其可觀察到的行為的情況下更低廉地進(jìn)行修改”*。本書(shū)包含大量重構(gòu)技術(shù),這些重構(gòu)技術(shù)旨在在某些情況下應(yīng)用,并旨在消除代碼壞味道[2]。
重構(gòu)是一個(gè)非常廣泛的話題,我發(fā)現(xiàn)重構(gòu)在軟件開(kāi)發(fā)過(guò)程中起著重要的作用。它們的相關(guān)性很高,因此它們是TDD[3]生命周期的重要組成部分。
由于它們的重要性,在這篇文章中,我想分享一下軟件開(kāi)發(fā)人員中使用最多的 4 種重構(gòu)技術(shù)。但是在開(kāi)始之前,因?yàn)榭梢宰詣?dòng)應(yīng)用重構(gòu)技術(shù)(即某些 IDE 為你提供了幫助,通過(guò)應(yīng)用重構(gòu)工具,只需單擊幾下鼠標(biāo)和進(jìn)行選擇,即可使你的生活更輕松),在這里,我將通過(guò)使用 Go 語(yǔ)言手動(dòng)重構(gòu)進(jìn)行描述,并嘗試將其作為參考指南。我們的開(kāi)發(fā)團(tuán)隊(duì)意識(shí)到,在應(yīng)用任何重構(gòu)技術(shù)之前,應(yīng)將可觀察到的功能包含在單元測(cè)試中,并通過(guò)所有測(cè)試。
01 提取方法
這是我常應(yīng)用于代碼的技術(shù)。它包括提取一段按意圖分組的代碼,并轉(zhuǎn)移到新方法中。通過(guò)提取可以將一個(gè)長(zhǎng)方法或函數(shù)拆分為一些小方法,這些小方法將邏輯組合在一起。通常,小方法或函數(shù)的名稱可以更好地了解該邏輯是什么。
下面的示例顯示了應(yīng)用此重構(gòu)技術(shù)之前和之后的情況。我的主要目標(biāo)是通過(guò)將復(fù)雜度分為不同的功能,這樣來(lái)抽象其復(fù)雜度。
- func StringCalculator(exp string) int {
- if exp == "" {
- return 0
- }
- var sum int
- for _, number := range strings.Split(exp, ",") {
- n, err := strconv.Atoi(number)
- if err != nil {
- return 0
- }
- sum += n
- }
- return sum
- }
重構(gòu)為:
- func StringCalculator(exp string) int {
- if exp == "" {
- return 0
- }
- return sumAllNumberInExpression(exp)
- }
- func sumAllNumberInExpression(exp string) int {
- var sum int
- for _, number := range strings.Split(exp, ",") {
- sum += toInt(number)
- }
- return sum
- }
- func toInt(exp string) int {
- n, err := strconv.Atoi(exp)
- if err != nil {
- return 0
- }
- return n
- }
StringCalculator 函數(shù)更簡(jiǎn)單了,但是當(dāng)添加了兩個(gè)新的函數(shù)時(shí),它會(huì)增加復(fù)雜性。這是一個(gè)我愿意做出慎重決定的犧牲,我將此作為參考而不是規(guī)則,從某種意義上說(shuō),了解應(yīng)用重構(gòu)技術(shù)的結(jié)果可以很好地判斷是否應(yīng)用重構(gòu)技術(shù)。
02 移動(dòng)方法
有時(shí),在使用提取方法后,我發(fā)現(xiàn)了另一個(gè)問(wèn)題:此方法應(yīng)該屬于此結(jié)構(gòu)或包嗎?Move Method 是一種簡(jiǎn)單的技術(shù),包括將方法從一個(gè)結(jié)構(gòu)移動(dòng)到另一個(gè)結(jié)構(gòu)。我發(fā)現(xiàn)一個(gè)技巧,來(lái)確定某個(gè)方法是否應(yīng)該屬于該結(jié)構(gòu):弄清楚該方法是否訪問(wèn)了另一個(gè)結(jié)構(gòu)依賴項(xiàng)的內(nèi)部??聪旅娴睦樱?/p>
- type Book struct {
- ID int
- Title string
- }
- type Books []Book
- type User struct {
- ID int
- Name string
- Books Books
- }
- func (u User) Info() {
- fmt.Printf("ID:%d - Name:%s", u.ID, u.Name)
- fmt.Printf("Books:%d", len(u.Books))
- fmt.Printf("Books titles: %s", u.BooksTitles())
- }
- func (u User) BooksTitles() string {
- var titles []string
- for _, book := range u.Books {
- titles = append(titles, book.Title)
- }
- return strings.Join(titles, ",")
- }
如你所見(jiàn),User 的方法BooksTitles 使用了 books(具體是 Title)中的內(nèi)部字段多于User,這表明該方法應(yīng)歸于Books。應(yīng)用這種重構(gòu)技術(shù)將該方法移動(dòng)到Books類型上,然后由用戶的Info方法調(diào)用。
- func (b Books) Titles() string {
- var titles []string
- for _, book := range b {
- titles = append(titles, book.Title)
- }
- return strings.Join(titles, ",")
- }
- func (u User) Info() {
- fmt.Printf("ID:%d - Name:%s", u.ID, u.Name)
- fmt.Printf("Books:%d", len(u.Books))
- fmt.Printf("Books titles: %s", u.Books.Titles())
- }
應(yīng)用此方法后,Books類型會(huì)更內(nèi)聚,因?yàn)樗俏ㄒ粨碛锌刂茩?quán)和對(duì)它的字段和內(nèi)部屬性訪問(wèn)權(quán)的人。同樣,這是在深思熟慮之前進(jìn)行的思考過(guò)程,知道應(yīng)用重構(gòu)會(huì)帶來(lái)什么結(jié)果。
03 引入?yún)?shù)對(duì)象
你見(jiàn)過(guò)多少像下面方法一樣,有很多參數(shù)的:
- func (om *OrderManager) Filter(startDate, endDate time.Time, country, state, city, status string) (Orders, error) {
- ...
即使我們看不到函數(shù)內(nèi)部的代碼,當(dāng)我們看到大量這樣的參數(shù)時(shí),我們也可以考慮它執(zhí)行的大量操作。
有時(shí),我發(fā)現(xiàn)這些參數(shù)之間高度相關(guān),并在以后定義它們的方法中一起使用。這為重構(gòu)提供了一種使該場(chǎng)景更加面向?qū)ο蟮姆绞竭M(jìn)行處理的方法,并且建議將這些參數(shù)分組為一個(gè)結(jié)構(gòu),替換方法簽名以將該對(duì)象用作參數(shù),并在方法內(nèi)部使用該對(duì)象。
- type OrderFilter struct {
- StartDate time.Time
- EndDate time.Time
- Country string
- State string
- City string
- Status string
- }
- func (om *OrderManager) Filter(of OrderFilter) (Orders, error) {
- // use of.StartDate, of.EndDate, of.Country, of.State, of.City, of.Status.
看起來(lái)更干凈,并且可以確定這些參數(shù)的身份,但是這將要求我更改調(diào)用此方法的所有引用,并且需要OrderFilter在傳遞給該方法之前創(chuàng)建一個(gè)新類型的對(duì)象作為參數(shù)。同樣,在嘗試進(jìn)行此重構(gòu)之前,我會(huì)盡力思考并考慮后果。當(dāng)你的代碼中的影響程度很低時(shí),我認(rèn)為此技術(shù)非常有效。
04 用符號(hào)常量替換魔數(shù)
該技術(shù)包括用常數(shù)變量替換硬編碼值以賦予其意圖和意義。
- func Add(input string) int {
- if input == "" {
- return 0
- }
- if strings.Contains(input, ";") {
- n1 := toNumber(input[:strings.Index(input, ";")])
- n2 := toNumber(input[strings.Index(input, ";")+1:])
- return n1 + n2
- }
- return toNumber(input)
- }
- func toNumber(input string) int {
- n, err := strconv.Atoi(input)
- if err != nil {
- return 0
- }
- return n
- }
其中 ; 字符是什么意思?如果答案對(duì)我來(lái)說(shuō)不太明確,我可以創(chuàng)建一個(gè)臨時(shí)變量,并使用硬編碼字符設(shè)置該值,以賦予其意義。
- func Add(input string) int {
- if input == "" {
- return 0
- }
- numberSeparator := ";"
- if strings.Contains(input, numberSeparator) {
- n1 := toNumber(input[:strings.Index(input, numberSeparator)])
- n2 := toNumber(input[strings.Index(input, numberSeparator)+1:])
- return n1 + n2
- }
- return toNumber(input)
- }
- func toNumber(input string) int {
- n, err := strconv.Atoi(input)
- if err != nil {
- return 0
- }
- return n
- }
總結(jié)
感謝閱讀,希望對(duì)你有所幫助。重構(gòu)是一個(gè)非常廣泛的話題,本文舉例說(shuō)明了重構(gòu)中使用最多的四個(gè)。不要將此處提到的內(nèi)容視為理所當(dāng)然,自己嘗試一下。此處描述的重構(gòu)技術(shù)僅用作指導(dǎo)原則,而未作為規(guī)則遵循,意味著它們?cè)谛枰獣r(shí)可以有針對(duì)性地進(jìn)行調(diào)整。最后,我想說(shuō)我們對(duì)所編寫的所有代碼和所使用的所有工具負(fù)責(zé),我們的經(jīng)驗(yàn)和知識(shí)可以指導(dǎo)我們掌握在每種情況下最適合的技能,我認(rèn)為重構(gòu)技術(shù)確實(shí)值得。
原文鏈接:https://wawand.co/blog/posts/four-most-refactoring-techniques-i-use/
參考資料
[1]書(shū)中: https://martinfowler.com/books/refactoring.html
[2]壞味道代碼: https://en.wikipedia.org/wiki/Code_smell
[3]TDD: https://en.wikipedia.org/wiki/Test-driven_development#/media/File:TDD_Global_Lifecycle.png
本文轉(zhuǎn)載自微信公眾號(hào)「幽鬼」,可以通過(guò)以下二維碼關(guān)注。轉(zhuǎn)載本文請(qǐng)聯(lián)系幽鬼公眾號(hào)。