golang在1.6.2的時(shí)候還沒(méi)有自己的context,在1.7的版本中就把golang.org/x/net/context包被加入到了官方的庫(kù)中。中文譯作“上下文”,它主要包含了goroutine 的運(yùn)行狀態(tài)、環(huán)境等信息。
創(chuàng)新互聯(lián)公司是一家集網(wǎng)站建設(shè),桑植企業(yè)網(wǎng)站建設(shè),桑植品牌網(wǎng)站建設(shè),網(wǎng)站定制,桑植網(wǎng)站建設(shè)報(bào)價(jià),網(wǎng)絡(luò)營(yíng)銷(xiāo),網(wǎng)絡(luò)優(yōu)化,桑植網(wǎng)站推廣為一體的創(chuàng)新建站企業(yè),幫助傳統(tǒng)企業(yè)提升企業(yè)形象加強(qiáng)企業(yè)競(jìng)爭(zhēng)力??沙浞譂M(mǎn)足這一群體相比中小企業(yè)更為豐富、高端、多元的互聯(lián)網(wǎng)需求。同時(shí)我們時(shí)刻保持專(zhuān)業(yè)、時(shí)尚、前沿,時(shí)刻以成就客戶(hù)成長(zhǎng)自我,堅(jiān)持不斷學(xué)習(xí)、思考、沉淀、凈化自己,讓我們?yōu)楦嗟钠髽I(yè)打造出實(shí)用型網(wǎng)站。
context 主要用來(lái)在 goroutine 之間傳遞上下文信息,包括:同步信號(hào)、超時(shí)時(shí)間、截止時(shí)間、請(qǐng)求相關(guān)值等。
該接口定義了四個(gè)需要實(shí)現(xiàn)的方法:
如果有個(gè)網(wǎng)絡(luò)請(qǐng)求Request,然后這個(gè)請(qǐng)求又可以開(kāi)啟多個(gè)goroutine做一些事情,當(dāng)這個(gè)網(wǎng)絡(luò)請(qǐng)求出現(xiàn)異常和超時(shí)時(shí),這個(gè)請(qǐng)求結(jié)束了,這時(shí)候就可以通過(guò)context來(lái)跟蹤這些goroutine,并且通過(guò)Context來(lái)取消他們,然后系統(tǒng)才可回收所占用的資源。
為了更方便的創(chuàng)建Context,包里頭定義了Background來(lái)作為所有Context的根,它是一個(gè)emptyCtx的實(shí)例。
Background返回一個(gè)非空的Context。它永遠(yuǎn)不會(huì)被取消。它通常用來(lái)初始化和測(cè)試使用,作為一個(gè)頂層的context,也就是說(shuō)一般我們創(chuàng)建的context都是基于Background。
TODO返回一個(gè)非空的Context。當(dāng)不清楚要使用哪個(gè)上下文的時(shí)候可以使用TODO。
他們兩個(gè)本質(zhì)上都是emptyCtx結(jié)構(gòu)體類(lèi)型,是一個(gè)不可取消,沒(méi)有設(shè)置截止時(shí)間,沒(méi)有攜帶任何值的Context。
有了如上的根Context,那么是如何衍生更多的子Context的呢?這就要靠context包為我們提供的With系列的函數(shù)了。
通過(guò)這些函數(shù),就創(chuàng)建了一顆Context樹(shù),樹(shù)的每個(gè)節(jié)點(diǎn)都可以有任意多個(gè)子節(jié)點(diǎn),節(jié)點(diǎn)層級(jí)可以有任意多個(gè)。
WithCancel函數(shù),最常用的派生 context 方法。該方法接受一個(gè)父 context。父 context 可以是一個(gè) background context 或其他 context。
WithDeadline函數(shù),該方法會(huì)創(chuàng)建一個(gè)帶有 deadline 的 context。當(dāng) deadline 到期后,該 context 以及該 context 的可能子 context 會(huì)受到 cancel 通知。另外,如果 deadline 前調(diào)用 cancelFunc 則會(huì)提前發(fā)送取消通知。
WithTimeout和WithDeadline基本上一樣,這個(gè)表示是超時(shí)自動(dòng)取消,是多少時(shí)間后自動(dòng)取消Context的意思。
WithValue函數(shù)和取消Context無(wú)關(guān),它是為了生成一個(gè)綁定了一個(gè)鍵值對(duì)數(shù)據(jù)的Context,這個(gè)綁定的數(shù)據(jù)可以通過(guò)Context.Value方法訪問(wèn)到,一般我們想要通過(guò)上下文來(lái)傳遞數(shù)據(jù)時(shí),可以通過(guò)這個(gè)方法,如我們需要tarce追蹤系統(tǒng)調(diào)用棧的時(shí)候。
使用Context的程序應(yīng)遵循以下規(guī)則,以使各個(gè)包之間的接口保持一致:
1.不要將 Context 塞到結(jié)構(gòu)體里。直接將 Context 類(lèi)型作為函數(shù)的第一參數(shù),而且一般都命名為 ctx。
2.不要向函數(shù)傳入一個(gè) nil 的 context,如果你實(shí)在不知道傳什么,標(biāo)準(zhǔn)庫(kù)給你準(zhǔn)備好了一個(gè) context:todo。
3.不要把本應(yīng)該作為函數(shù)參數(shù)的類(lèi)型塞到 context 中,context 存儲(chǔ)的應(yīng)該是一些共同的數(shù)據(jù)。例如:登陸的 session、cookie 等。
4.同一個(gè) context 可能會(huì)被傳遞到多個(gè) goroutine,別擔(dān)心,context 是并發(fā)安全的。
本教程介紹 Go 中多模塊工作區(qū)的基礎(chǔ)知識(shí)。使用多模塊工作區(qū),您可以告訴 Go 命令您正在同時(shí)在多個(gè)模塊中編寫(xiě)代碼,并輕松地在這些模塊中構(gòu)建和運(yùn)行代碼。
在本教程中,您將在共享的多模塊工作區(qū)中創(chuàng)建兩個(gè)模塊,對(duì)這些模塊進(jìn)行更改,并在構(gòu)建中查看這些更改的結(jié)果。
本教程需要 go1.18 或更高版本。使用go.dev/dl中的鏈接確保您已在 Go 1.18 或更高版本中安裝了 Go 。
首先,為您要編寫(xiě)的代碼創(chuàng)建一個(gè)模塊。
1、打開(kāi)命令提示符并切換到您的主目錄。
在 Linux 或 Mac 上:
在 Windows 上:
2、在命令提示符下,為您的代碼創(chuàng)建一個(gè)名為工作區(qū)的目錄。
3、初始化模塊
我們的示例將創(chuàng)建一個(gè)hello依賴(lài)于 golang.org/x/example 模塊的新模塊。
創(chuàng)建你好模塊:
使用 . 添加對(duì) golang.org/x/example 模塊的依賴(lài)項(xiàng)go get。
在 hello 目錄下創(chuàng)建 hello.go,內(nèi)容如下:
現(xiàn)在,運(yùn)行 hello 程序:
在這一步中,我們將創(chuàng)建一個(gè)go.work文件來(lái)指定模塊的工作區(qū)。
在workspace目錄中,運(yùn)行:
該go work init命令告訴為包含目錄中模塊的工作空間go創(chuàng)建一個(gè)文件 。go.work./hello
該go命令生成一個(gè)go.work如下所示的文件:
該go.work文件的語(yǔ)法與go.mod相同。
該go指令告訴 Go 應(yīng)該使用哪個(gè)版本的 Go 來(lái)解釋文件。它類(lèi)似于文件中的go指令go.mod 。
該use指令告訴 Go在進(jìn)行構(gòu)建時(shí)hello目錄中的模塊應(yīng)該是主模塊。
所以在模塊的任何子目錄中workspace都會(huì)被激活。
2、運(yùn)行工作區(qū)目錄下的程序
在workspace目錄中,運(yùn)行:
Go 命令包括工作區(qū)中的所有模塊作為主模塊。這允許我們?cè)谀K中引用一個(gè)包,即使在模塊之外。在模塊或工作區(qū)之外運(yùn)行g(shù)o run命令會(huì)導(dǎo)致錯(cuò)誤,因?yàn)樵揼o命令不知道要使用哪些模塊。
接下來(lái),我們將golang.org/x/example模塊的本地副本添加到工作區(qū)。然后,我們將向stringutil包中添加一個(gè)新函數(shù),我們可以使用它來(lái)代替Reverse.
在這一步中,我們將下載包含該模塊的 Git 存儲(chǔ)庫(kù)的副本golang.org/x/example,將其添加到工作區(qū),然后向其中添加一個(gè)我們將從 hello 程序中使用的新函數(shù)。
1、克隆存儲(chǔ)庫(kù)
在工作區(qū)目錄中,運(yùn)行g(shù)it命令來(lái)克隆存儲(chǔ)庫(kù):
2、將模塊添加到工作區(qū)
該go work use命令將一個(gè)新模塊添加到 go.work 文件中。它現(xiàn)在看起來(lái)像這樣:
該模塊現(xiàn)在包括example.com/hello模塊和 `golang.org/x/example 模塊。
這將允許我們使用我們將在模塊副本中編寫(xiě)的新代碼,而不是使用命令stringutil下載的模塊緩存中的模塊版本。
3、添加新功能。
我們將向golang.org/x/example/stringutil包中添加一個(gè)新函數(shù)以將字符串大寫(xiě)。
將新文件夾添加到workspace/example/stringutil包含以下內(nèi)容的目錄:
4、修改hello程序以使用該功能。
修改workspace/hello/hello.go的內(nèi)容以包含以下內(nèi)容:
從工作區(qū)目錄,運(yùn)行
Go 命令在go.work文件指定的hello目錄中查找命令行中指定的example.com/hello模塊 ,同樣使用go.work文件解析導(dǎo)入golang.org/x/example。
go.work可以用來(lái)代替添加replace 指令以跨多個(gè)模塊工作。
由于這兩個(gè)模塊在同一個(gè)工作區(qū)中,因此很容易在一個(gè)模塊中進(jìn)行更改并在另一個(gè)模塊中使用它。
現(xiàn)在,要正確發(fā)布這些模塊,我們需要發(fā)布golang.org/x/example 模塊,例如在v0.1.0. 這通常通過(guò)在模塊的版本控制存儲(chǔ)庫(kù)上標(biāo)記提交來(lái)完成。發(fā)布完成后,我們可以增加對(duì) golang.org/x/example模塊的要求hello/go.mod:
這樣,該go命令可以正確解析工作區(qū)之外的模塊。
Go語(yǔ)言中沒(méi)有“類(lèi)”的概念,也不支持“類(lèi)”的繼承等面向?qū)ο蟮母拍?。Go語(yǔ)言中通過(guò)結(jié)構(gòu)體的內(nèi)嵌再配合接口比面向?qū)ο缶哂懈叩臄U(kuò)展性和靈活性。
自定義類(lèi)型
在Go語(yǔ)言中有一些基本的數(shù)據(jù)類(lèi)型,如string、整型、浮點(diǎn)型、布爾等數(shù)據(jù)類(lèi)型, Go語(yǔ)言中可以使用type關(guān)鍵字來(lái)定義自定義類(lèi)型。
自定義類(lèi)型是定義了一個(gè)全新的類(lèi)型。我們可以基于內(nèi)置的基本類(lèi)型定義,也可以通過(guò)struct定義。例如:
通過(guò)Type關(guān)鍵字的定義,MyInt就是一種新的類(lèi)型,它具有int的特性。
類(lèi)型別名
類(lèi)型別名是Go1.9版本添加的新功能。
類(lèi)型別名規(guī)定:TypeAlias只是Type的別名,本質(zhì)上TypeAlias與Type是同一個(gè)類(lèi)型。就像一個(gè)孩子小時(shí)候有小名、乳名,上學(xué)后用學(xué)名,英語(yǔ)老師又會(huì)給他起英文名,但這些名字都指的是他本人。
type TypeAlias = Type
我們之前見(jiàn)過(guò)的rune和byte就是類(lèi)型別名,他們的定義如下:
類(lèi)型定義和類(lèi)型別名的區(qū)別
類(lèi)型別名與類(lèi)型定義表面上看只有一個(gè)等號(hào)的差異,我們通過(guò)下面的這段代碼來(lái)理解它們之間的區(qū)別。
結(jié)果顯示a的類(lèi)型是main.NewInt,表示main包下定義的NewInt類(lèi)型。b的類(lèi)型是int。MyInt類(lèi)型只會(huì)在代碼中存在,編譯完成時(shí)并不會(huì)有MyInt類(lèi)型。
Go語(yǔ)言中的基礎(chǔ)數(shù)據(jù)類(lèi)型可以表示一些事物的基本屬性,但是當(dāng)我們想表達(dá)一個(gè)事物的全部或部分屬性時(shí),這時(shí)候再用單一的基本數(shù)據(jù)類(lèi)型明顯就無(wú)法滿(mǎn)足需求了,Go語(yǔ)言提供了一種自定義數(shù)據(jù)類(lèi)型,可以封裝多個(gè)基本數(shù)據(jù)類(lèi)型,這種數(shù)據(jù)類(lèi)型叫結(jié)構(gòu)體,英文名稱(chēng)struct。 也就是我們可以通過(guò)struct來(lái)定義自己的類(lèi)型了。
Go語(yǔ)言中通過(guò)struct來(lái)實(shí)現(xiàn)面向?qū)ο蟆?/p>
結(jié)構(gòu)體的定義
使用type和struct關(guān)鍵字來(lái)定義結(jié)構(gòu)體,具體代碼格式如下:
其中:
舉個(gè)例子,我們定義一個(gè)Person(人)結(jié)構(gòu)體,代碼如下:
同樣類(lèi)型的字段也可以寫(xiě)在一行,
這樣我們就擁有了一個(gè)person的自定義類(lèi)型,它有name、city、age三個(gè)字段,分別表示姓名、城市和年齡。這樣我們使用這個(gè)person結(jié)構(gòu)體就能夠很方便的在程序中表示和存儲(chǔ)人信息了。
語(yǔ)言?xún)?nèi)置的基礎(chǔ)數(shù)據(jù)類(lèi)型是用來(lái)描述一個(gè)值的,而結(jié)構(gòu)體是用來(lái)描述一組值的。比如一個(gè)人有名字、年齡和居住城市等,本質(zhì)上是一種聚合型的數(shù)據(jù)類(lèi)型
結(jié)構(gòu)體實(shí)例化
只有當(dāng)結(jié)構(gòu)體實(shí)例化時(shí),才會(huì)真正地分配內(nèi)存。也就是必須實(shí)例化后才能使用結(jié)構(gòu)體的字段。
基本實(shí)例化
舉個(gè)例子:
我們通過(guò).來(lái)訪問(wèn)結(jié)構(gòu)體的字段(成員變量),例如p1.name和p1.age等。
匿名結(jié)構(gòu)體
在定義一些臨時(shí)數(shù)據(jù)結(jié)構(gòu)等場(chǎng)景下還可以使用匿名結(jié)構(gòu)體。
創(chuàng)建指針類(lèi)型結(jié)構(gòu)體
我們還可以通過(guò)使用new關(guān)鍵字對(duì)結(jié)構(gòu)體進(jìn)行實(shí)例化,得到的是結(jié)構(gòu)體的地址。 格式如下:
從打印的結(jié)果中我們可以看出p2是一個(gè)結(jié)構(gòu)體指針。
需要注意的是在Go語(yǔ)言中支持對(duì)結(jié)構(gòu)體指針直接使用.來(lái)訪問(wèn)結(jié)構(gòu)體的成員。
取結(jié)構(gòu)體的地址實(shí)例化
使用對(duì)結(jié)構(gòu)體進(jìn)行取地址操作相當(dāng)于對(duì)該結(jié)構(gòu)體類(lèi)型進(jìn)行了一次new實(shí)例化操作。
p3.name = "七米"其實(shí)在底層是(*p3).name = "七米",這是Go語(yǔ)言幫我們實(shí)現(xiàn)的語(yǔ)法糖。
結(jié)構(gòu)體初始化
沒(méi)有初始化的結(jié)構(gòu)體,其成員變量都是對(duì)應(yīng)其類(lèi)型的零值。
使用鍵值對(duì)初始化
使用鍵值對(duì)對(duì)結(jié)構(gòu)體進(jìn)行初始化時(shí),鍵對(duì)應(yīng)結(jié)構(gòu)體的字段,值對(duì)應(yīng)該字段的初始值。
也可以對(duì)結(jié)構(gòu)體指針進(jìn)行鍵值對(duì)初始化,例如:
當(dāng)某些字段沒(méi)有初始值的時(shí)候,該字段可以不寫(xiě)。此時(shí),沒(méi)有指定初始值的字段的值就是該字段類(lèi)型的零值。
使用值的列表初始化
初始化結(jié)構(gòu)體的時(shí)候可以簡(jiǎn)寫(xiě),也就是初始化的時(shí)候不寫(xiě)鍵,直接寫(xiě)值:
使用這種格式初始化時(shí),需要注意:
結(jié)構(gòu)體內(nèi)存布局
結(jié)構(gòu)體占用一塊連續(xù)的內(nèi)存。
輸出:
【進(jìn)階知識(shí)點(diǎn)】關(guān)于Go語(yǔ)言中的內(nèi)存對(duì)齊推薦閱讀:在 Go 中恰到好處的內(nèi)存對(duì)齊
面試題
請(qǐng)問(wèn)下面代碼的執(zhí)行結(jié)果是什么?
構(gòu)造函數(shù)
Go語(yǔ)言的結(jié)構(gòu)體沒(méi)有構(gòu)造函數(shù),我們可以自己實(shí)現(xiàn)。 例如,下方的代碼就實(shí)現(xiàn)了一個(gè)person的構(gòu)造函數(shù)。 因?yàn)閟truct是值類(lèi)型,如果結(jié)構(gòu)體比較復(fù)雜的話,值拷貝性能開(kāi)銷(xiāo)會(huì)比較大,所以該構(gòu)造函數(shù)返回的是結(jié)構(gòu)體指針類(lèi)型。
調(diào)用構(gòu)造函數(shù)
方法和接收者
Go語(yǔ)言中的方法(Method)是一種作用于特定類(lèi)型變量的函數(shù)。這種特定類(lèi)型變量叫做接收者(Receiver)。接收者的概念就類(lèi)似于其他語(yǔ)言中的this或者 self。
方法的定義格式如下:
其中,
舉個(gè)例子:
方法與函數(shù)的區(qū)別是,函數(shù)不屬于任何類(lèi)型,方法屬于特定的類(lèi)型。
指針類(lèi)型的接收者
指針類(lèi)型的接收者由一個(gè)結(jié)構(gòu)體的指針組成,由于指針的特性,調(diào)用方法時(shí)修改接收者指針的任意成員變量,在方法結(jié)束后,修改都是有效的。這種方式就十分接近于其他語(yǔ)言中面向?qū)ο笾械膖his或者self。 例如我們?yōu)镻erson添加一個(gè)SetAge方法,來(lái)修改實(shí)例變量的年齡。
調(diào)用該方法:
值類(lèi)型的接收者
當(dāng)方法作用于值類(lèi)型接收者時(shí),Go語(yǔ)言會(huì)在代碼運(yùn)行時(shí)將接收者的值復(fù)制一份。在值類(lèi)型接收者的方法中可以獲取接收者的成員值,但修改操作只是針對(duì)副本,無(wú)法修改接收者變量本身。
什么時(shí)候應(yīng)該使用指針類(lèi)型接收者
任意類(lèi)型添加方法
在Go語(yǔ)言中,接收者的類(lèi)型可以是任何類(lèi)型,不僅僅是結(jié)構(gòu)體,任何類(lèi)型都可以擁有方法。 舉個(gè)例子,我們基于內(nèi)置的int類(lèi)型使用type關(guān)鍵字可以定義新的自定義類(lèi)型,然后為我們的自定義類(lèi)型添加方法。
注意事項(xiàng): 非本地類(lèi)型不能定義方法,也就是說(shuō)我們不能給別的包的類(lèi)型定義方法。
結(jié)構(gòu)體的匿名字段
匿名字段默認(rèn)采用類(lèi)型名作為字段名,結(jié)構(gòu)體要求字段名稱(chēng)必須唯一,因此一個(gè)結(jié)構(gòu)體中同種類(lèi)型的匿名字段只能有一個(gè)。
嵌套結(jié)構(gòu)體
一個(gè)結(jié)構(gòu)體中可以嵌套包含另一個(gè)結(jié)構(gòu)體或結(jié)構(gòu)體指針。
嵌套匿名結(jié)構(gòu)體
當(dāng)訪問(wèn)結(jié)構(gòu)體成員時(shí)會(huì)先在結(jié)構(gòu)體中查找該字段,找不到再去匿名結(jié)構(gòu)體中查找。
嵌套結(jié)構(gòu)體的字段名沖突
嵌套結(jié)構(gòu)體內(nèi)部可能存在相同的字段名。這個(gè)時(shí)候?yàn)榱吮苊馄缌x需要指定具體的內(nèi)嵌結(jié)構(gòu)體的字段。
結(jié)構(gòu)體的“繼承”
Go語(yǔ)言中使用結(jié)構(gòu)體也可以實(shí)現(xiàn)其他編程語(yǔ)言中面向?qū)ο蟮睦^承。
結(jié)構(gòu)體字段的可見(jiàn)性
結(jié)構(gòu)體中字段大寫(xiě)開(kāi)頭表示可公開(kāi)訪問(wèn),小寫(xiě)表示私有(僅在定義當(dāng)前結(jié)構(gòu)體的包中可訪問(wèn))。
結(jié)構(gòu)體與JSON序列化
JSON(JavaScript Object Notation) 是一種輕量級(jí)的數(shù)據(jù)交換格式。易于人閱讀和編寫(xiě)。同時(shí)也易于機(jī)器解析和生成。JSON鍵值對(duì)是用來(lái)保存JS對(duì)象的一種方式,鍵/值對(duì)組合中的鍵名寫(xiě)在前面并用雙引號(hào)""包裹,使用冒號(hào):分隔,然后緊接著值;多個(gè)鍵值之間使用英文,分隔。
結(jié)構(gòu)體標(biāo)簽(Tag)
Tag是結(jié)構(gòu)體的元信息,可以在運(yùn)行的時(shí)候通過(guò)反射的機(jī)制讀取出來(lái)。 Tag在結(jié)構(gòu)體字段的后方定義,由一對(duì)反引號(hào)包裹起來(lái),具體的格式如下:
`key1:"value1" key2:"value2"`
結(jié)構(gòu)體標(biāo)簽由一個(gè)或多個(gè)鍵值對(duì)組成。鍵與值使用冒號(hào)分隔,值用雙引號(hào)括起來(lái)。鍵值對(duì)之間使用一個(gè)空格分隔。 注意事項(xiàng): 為結(jié)構(gòu)體編寫(xiě)Tag時(shí),必須嚴(yán)格遵守鍵值對(duì)的規(guī)則。結(jié)構(gòu)體標(biāo)簽的解析代碼的容錯(cuò)能力很差,一旦格式寫(xiě)錯(cuò),編譯和運(yùn)行時(shí)都不會(huì)提示任何錯(cuò)誤,通過(guò)反射也無(wú)法正確取值。例如不要在key和value之間添加空格。
例如我們?yōu)镾tudent結(jié)構(gòu)體的每個(gè)字段定義json序列化時(shí)使用的Tag:
當(dāng)客戶(hù)端在 發(fā)出POST請(qǐng)求時(shí)/albums,您希望將請(qǐng)求正文中描述的專(zhuān)輯添加到現(xiàn)有專(zhuān)輯數(shù)據(jù)中。
為此,您將編寫(xiě)以下內(nèi)容:
1、編寫(xiě)代碼
a.添加代碼以將專(zhuān)輯數(shù)據(jù)添加到專(zhuān)輯列表。
在此代碼中:
1)用于Context.BindJSON 將請(qǐng)求正文綁定到newAlbum。
2) album將從 JSON 初始化的結(jié)構(gòu)附加到albums 切片。
3)向響應(yīng)添加201狀態(tài)代碼,以及表示您添加的專(zhuān)輯的 JSON。
b.更改您的main函數(shù),使其包含該router.POST函數(shù),如下所示。
在此代碼中:
1)將路徑中的POST方法與 /albumspostAlbums函數(shù)相關(guān)聯(lián)。
使用 Gin,您可以將處理程序與 HTTP 方法和路徑組合相關(guān)聯(lián)。這樣,您可以根據(jù)客戶(hù)端使用的方法將發(fā)送到單個(gè)路徑的請(qǐng)求單獨(dú)路由。
a.如果服務(wù)器從上一節(jié)開(kāi)始仍在運(yùn)行,請(qǐng)停止它。
b.從包含 main.go 的目錄中的命令行,運(yùn)行代碼。
c.從不同的命令行窗口,用于curl向正在運(yùn)行的 Web 服務(wù)發(fā)出請(qǐng)求。
該命令應(yīng)顯示添加專(zhuān)輯的標(biāo)題和 JSON。
d.與上一節(jié)一樣,使用curl檢索完整的專(zhuān)輯列表,您可以使用它來(lái)確認(rèn)添加了新專(zhuān)輯。
該命令應(yīng)顯示專(zhuān)輯列表。
當(dāng)客戶(hù)端向 發(fā)出請(qǐng)求時(shí)GET /albums/[id],您希望返回 ID 與id路徑參數(shù)匹配的專(zhuān)輯。
為此,您將:
a.在您在上一節(jié)中添加的函數(shù)下方postAlbums,粘貼以下代碼以檢索特定專(zhuān)輯。
此getAlbumByID函數(shù)將提取請(qǐng)求路徑中的 ID,然后找到匹配的專(zhuān)輯。
在此代碼中:
(1)Context.Param用于從 URL 中檢索id路徑參數(shù)。當(dāng)您將此處理程序映射到路徑時(shí),您將在路徑中包含參數(shù)的占位符。
(2)循環(huán)album切片中的結(jié)構(gòu),尋找其ID 字段值與id參數(shù)值匹配的結(jié)構(gòu)。如果找到,則將該album結(jié)構(gòu)序列化為 JSON,并將其作為帶有200 OK HTTP 代碼的響應(yīng)返回。
如上所述,實(shí)際使用中的服務(wù)可能會(huì)使用數(shù)據(jù)庫(kù)查詢(xún)來(lái)執(zhí)行此查找。
(3)如果找不到專(zhuān)輯,則返回 HTTP 404錯(cuò)誤。
b.最后,更改您的main,使其包含對(duì)router.GET的新調(diào)用,路徑現(xiàn)在為/albums/:id ,如以下示例所示。
在此代碼中:
(1)將/albums/:id路徑與getAlbumByID功能相關(guān)聯(lián)。在 Gin 中,路徑中項(xiàng)目前面的冒號(hào)表示該項(xiàng)目是路徑參數(shù)。
a.如果服務(wù)器從上一節(jié)開(kāi)始仍在運(yùn)行,請(qǐng)停止它。
b.在包含 main.go 的目錄中的命令行中,運(yùn)行代碼以啟動(dòng)服務(wù)器。
c.從不同的命令行窗口,用于curl向正在運(yùn)行的 Web 服務(wù)發(fā)出請(qǐng)求。
該命令應(yīng)顯示您使用其 ID 的專(zhuān)輯的 JSON。如果找不到專(zhuān)輯,您將收到帶有錯(cuò)誤消息的 JSON。
恭喜!您剛剛使用 Go 和 Gin 編寫(xiě)了一個(gè)簡(jiǎn)單的 RESTful Web 服務(wù)。
本節(jié)包含您使用本教程構(gòu)建的應(yīng)用程序的代碼。
作為C語(yǔ)言家族的一員,go和c一樣也支持結(jié)構(gòu)體??梢灶?lèi)比于java的一個(gè)POJO。
在學(xué)習(xí)定義結(jié)構(gòu)體之前,先學(xué)習(xí)下定義一個(gè)新類(lèi)型。
新類(lèi)型 T1 是基于 Go 原生類(lèi)型 int 定義的新自定義類(lèi)型,而新類(lèi)型 T2 則是 基于剛剛定義的類(lèi)型 T1,定義的新類(lèi)型。
這里要引入一個(gè)底層類(lèi)型的概念。
如果一個(gè)新類(lèi)型是基于某個(gè) Go 原生類(lèi)型定義的, 那么我們就叫 Go 原生類(lèi)型為新類(lèi)型的底層類(lèi)型
在上面的例子中,int就是T1的底層類(lèi)型。
但是T1不是T2的底層類(lèi)型,只有原生類(lèi)型才可以作為底層類(lèi)型,所以T2的底層類(lèi)型還是int
底層類(lèi)型是很重要的,因?yàn)閷?duì)兩個(gè)變量進(jìn)行顯式的類(lèi)型轉(zhuǎn)換,只有底層類(lèi)型相同的變量間才能相互轉(zhuǎn)換。底層類(lèi)型是判斷兩個(gè)類(lèi)型本質(zhì)上是否相同的根本。
這種類(lèi)型定義方式通常用在 項(xiàng)目的漸進(jìn)式重構(gòu),還有對(duì)已有包的二次封裝方面
類(lèi)型別名表示新類(lèi)型和原類(lèi)型完全等價(jià),實(shí)際上就是同一種類(lèi)型。只不過(guò)名字不同而已。
一般我們都是定義一個(gè)有名的結(jié)構(gòu)體。
字段名的大小寫(xiě)決定了字段是否包外可用。只有大寫(xiě)的字段可以被包外引用。
還有一個(gè)點(diǎn)提一下
如果換行來(lái)寫(xiě)
Age: 66,后面這個(gè)都好不能省略
還有一個(gè)點(diǎn),觀察e3的賦值
new返回的是一個(gè)指針。然后指針可以直接點(diǎn)號(hào)賦值。這說(shuō)明go默認(rèn)進(jìn)行了取值操作
e3.Age 等價(jià)于 (*e3).Age
如上定義了一個(gè)空的結(jié)構(gòu)體Empty。打印了元素e的內(nèi)存大小是0。
有什么用呢?
基于空結(jié)構(gòu)體類(lèi)型內(nèi)存零開(kāi)銷(xiāo)這樣的特性,我們?cè)谌粘?Go 開(kāi)發(fā)中會(huì)經(jīng)常使用空 結(jié)構(gòu)體類(lèi)型元素,作為一種“事件”信息進(jìn)行 Goroutine 之間的通信
這種以空結(jié)構(gòu)體為元素類(lèi)建立的 channel,是目前能實(shí)現(xiàn)的、內(nèi)存占用最小的 Goroutine 間通信方式。
這種形式需要說(shuō)的是幾個(gè)語(yǔ)法糖。
語(yǔ)法糖1:
對(duì)于結(jié)構(gòu)體字段,可以省略字段名,只寫(xiě)結(jié)構(gòu)體名。默認(rèn)字段名就是結(jié)構(gòu)體名
這種方式稱(chēng)為 嵌入字段
語(yǔ)法糖2:
如果是以嵌入字段形式寫(xiě)的結(jié)構(gòu)體
可以省略嵌入的Reader字段,而直接訪問(wèn)ReaderName
此時(shí)book是一個(gè)各個(gè)屬性全是對(duì)應(yīng)類(lèi)型零值的一個(gè)實(shí)例。不是nil。這種情況在Go中稱(chēng)為零值可用。不像java會(huì)導(dǎo)致npe
結(jié)構(gòu)體定義時(shí)可以在字段后面追加標(biāo)簽說(shuō)明。
tag的格式為反單引號(hào)
tag的作用是可以使用[反射]來(lái)檢視字段的標(biāo)簽信息。
具體的作用還要看使用的場(chǎng)景。
比如這里的tag是為了幫助 encoding/json 標(biāo)準(zhǔn)包在解析對(duì)象時(shí)可以利用的規(guī)則。比如omitempty表示該字段沒(méi)有值就不打印出來(lái)。
為什么需要context
在go服務(wù)器中,對(duì)于每個(gè)請(qǐng)求的request都是在單獨(dú)的goroutine中進(jìn)行的,處理一個(gè)request也可能設(shè)計(jì)多個(gè)goroutine之間的交互, 使用context可以使開(kāi)發(fā)者方便的在這些goroutine里傳遞request相關(guān)的數(shù)據(jù)、取消goroutine的signal或截止日期
在并發(fā)程序中,由于超時(shí)、取消操作或者一些異常情況,往往需要進(jìn)行搶占操作或者中斷后續(xù)操作。熟悉channel的朋友應(yīng)該都見(jiàn)過(guò)使用done channel來(lái)處理此類(lèi)問(wèn)題。比如以下這個(gè)例子:
上述例子中定義了一個(gè)buffer為0的channel done, 子協(xié)程運(yùn)行著定時(shí)任務(wù)。如果主協(xié)程需要在某個(gè)時(shí)刻發(fā)送消息通知子協(xié)程中斷任務(wù)退出,那么就可以讓子協(xié)程監(jiān)聽(tīng)這個(gè)done channel,一旦主協(xié)程關(guān)閉done channel,那么子協(xié)程就可以推出了,這樣就實(shí)現(xiàn)了主協(xié)程通知子協(xié)程的需求。這很好,但是這也是有限的。
如果我們可以在簡(jiǎn)單的通知上附加傳遞額外的信息來(lái)控制取消:為什么取消,或者有一個(gè)它必須要完成的最終期限,更或者有多個(gè)取消選項(xiàng),我們需要根據(jù)額外的信息來(lái)判斷選擇執(zhí)行哪個(gè)取消選項(xiàng)。
考慮下面這種情況:假如主協(xié)程中有多個(gè)任務(wù)1, 2, …m,主協(xié)程對(duì)這些任務(wù)有超時(shí)控制;而其中任務(wù)1又有多個(gè)子任務(wù)1, 2, …n,任務(wù)1對(duì)這些子任務(wù)也有自己的超時(shí)控制,那么這些子任務(wù)既要感知主協(xié)程的取消信號(hào),也需要感知任務(wù)1的取消信號(hào)。
如果還是使用done channel的用法,我們需要定義兩個(gè)done channel,子任務(wù)們需要同時(shí)監(jiān)聽(tīng)這兩個(gè)done channel。嗯,這樣其實(shí)好像也還行哈。但是如果層級(jí)更深,如果這些子任務(wù)還有子任務(wù),那么使用done channel的方式將會(huì)變得非常繁瑣且混亂。
我們需要一種優(yōu)雅的方案來(lái)實(shí)現(xiàn)這樣一種機(jī)制:
上層任務(wù)取消后,所有的下層任務(wù)都會(huì)被取消;中間某一層的任務(wù)取消后,只會(huì)將當(dāng)前任務(wù)的下層任務(wù)取消,而不會(huì)影響上層的任務(wù)以及同級(jí)任務(wù)。
這個(gè)時(shí)候context就派上用場(chǎng)了。我們首先看看context的結(jié)構(gòu)設(shè)計(jì)和實(shí)現(xiàn)原理。
context接口
先看Context接口結(jié)構(gòu),看起來(lái)非常簡(jiǎn)單。
}
Context接口包含四個(gè)方法:
Deadline返回綁定當(dāng)前context的任務(wù)被取消的截止時(shí)間;如果沒(méi)有設(shè)定期限,將返回ok == false。
Done 當(dāng)綁定當(dāng)前context的任務(wù)被取消時(shí),將返回一個(gè)關(guān)閉的channel;如果當(dāng)前context不會(huì)被取消,將返回nil。
Err 如果Done返回的channel沒(méi)有關(guān)閉,將返回nil;如果Done返回的channel已經(jīng)關(guān)閉,將返回非空的值表示任務(wù)結(jié)束的原因。如果是context被取消,Err將返回Canceled;如果是context超時(shí),Err將返回DeadlineExceeded。
Value 返回context存儲(chǔ)的鍵值對(duì)中當(dāng)前key對(duì)應(yīng)的值,如果沒(méi)有對(duì)應(yīng)的key,則返回nil。
可以看到Done方法返回的channel正是用來(lái)傳遞結(jié)束信號(hào)以搶占并中斷當(dāng)前任務(wù);Deadline方法指示一段時(shí)間后當(dāng)前goroutine是否會(huì)被取消;以及一個(gè)Err方法,來(lái)解釋goroutine被取消的原因;而Value則用于獲取特定于當(dāng)前任務(wù)樹(shù)的額外信息。而context所包含的額外信息鍵值對(duì)是如何存儲(chǔ)的呢?其實(shí)可以想象一顆樹(shù),樹(shù)的每個(gè)節(jié)點(diǎn)可能攜帶一組鍵值對(duì),如果當(dāng)前節(jié)點(diǎn)上無(wú)法找到key所對(duì)應(yīng)的值,就會(huì)向上去父節(jié)點(diǎn)里找,直到根節(jié)點(diǎn)。
emptyCtx
emptyCtx是一個(gè)int類(lèi)型的變量,但實(shí)現(xiàn)了context的接口。emptyCtx沒(méi)有超時(shí)時(shí)間,不能取消,也不能存儲(chǔ)任何額外信息,所以emptyCtx用來(lái)作為context樹(shù)的根節(jié)點(diǎn)。
Background和TODO只是用于不同場(chǎng)景下: Background通常被用于主函數(shù)、初始化以及測(cè)試中,作為一個(gè)頂層的context,也就是說(shuō)一般我們創(chuàng)建的context都是基于Background;而TODO是在不確定使用什么context的時(shí)候才會(huì)使用。
用法 :