本文將介紹一個(gè) Golang 下的 Http 請(qǐng)求封裝庫(kù)侦香〕菟耄可以與 Python 的 requests 庫(kù)類似的配置請(qǐng)求和處理返回外盯。
獲取 Goreq
go get -u github.com/zhshch2002/goreq
Quick start
首先蜡饵，我們來發(fā)起一個(gè) GET 請(qǐng)求局装，代碼非常簡(jiǎn)單蜕该。如下：
func main() {
res := goreq.Do(goreq.Get("https://httpbin.org/get"))
if res.Err != nil {
fmt.Println(res.Err)
} else {
fmt.Println(res.Text)
}
}
其中res包含了相應(yīng)的數(shù)據(jù)茄唐，res.Err為非空時(shí)表示請(qǐng)求中遇到錯(cuò)誤孝扛。
除了 GET芋肠，HTTP 還有其他一系列方法乎芳，包括 POST、PUT帖池、DELETE奈惑、HEAD、OPTIONS碘裕。更換goreq.Get為goreq.Post即可携取。
func main() {
res := goreq.Post("https://httpbin.org/post").Do()
if res.Err != nil {
fmt.Println(res.Err)
} else {
fmt.Println(res.Text)
}
}
URL 參數(shù)
指在 UR?L 之后用&隔開的鍵值對(duì)數(shù)據(jù)。手工構(gòu)建 URL 會(huì)比較麻煩帮孔，我們可以只用 Goreq 提供的鏈?zhǔn)胶瘮?shù)來構(gòu)建雷滋。
func main() {
res := goreq.Get("https://httpbin.org/get?hi=myself").
AddParam("aaa", "111"). // set a single param
AddParams(map[string]string{
"bbb": "222",
}).Do()
if res.Err != nil {
fmt.Println(res.Err)
} else {
fmt.Println(res.Text)
}
}
此時(shí)發(fā)出的請(qǐng)求的 URL 為https://httpbin.org/get?hi=myself&aaa=111&bbb=222。Goreq 會(huì)自動(dòng)編碼參數(shù)文兢。
由此晤斩，我們可以發(fā)現(xiàn) Gore 去對(duì)請(qǐng)求配置的方式——鏈?zhǔn)脚渲谩１仍嫉?HTTP 庫(kù)提供的方式要快捷很多姆坚。
原始的參數(shù)構(gòu)建方式澳泵。
req, err := http.NewRequest(http.MethodGet, "http://httpbin.org/get", nil)
if err != nil {
panic(err)
}
params := make(url.Values) // 參數(shù)在此出
params.Add("key1", "value1")
params.Add("key2", "value2")
req.URL.RawQuery = params.Encode()
r, err := http.DefaultClient.Do(req)
重新另起數(shù)據(jù)結(jié)構(gòu)再轉(zhuǎn)化打斷了一開始的編程思路。
Goreq 配置請(qǐng)求
-
AddParam(k, v string)添URL參數(shù) -
AddParams(v map[string]string)添加一組URL參數(shù) -
AddHeader(key, value string)添加請(qǐng)求頭部 -
AddHeaders(v map[string]string)添加一組請(qǐng)求頭部 -
AddCookie(c *http.Cookie)添加Cookie -
SetUA(ua string)設(shè)置UA -
SetBasicAuth(username, password string)設(shè)置HTTP身份驗(yàn)證 -
SetProxy(urladdr string)為此請(qǐng)求設(shè)置代理 -
SetTimeout(t time.Duration)為此請(qǐng)求設(shè)置超時(shí)時(shí)間 -
DisableRedirect()禁用重定向跟隨 -
SetCheckRedirect(fn func(req *http.Request, via []*http.Request) error)為此請(qǐng)求設(shè)置重定向跟隨檢查函數(shù) - 設(shè)置POST數(shù)據(jù)
SetBody(b io.Reader)SetRawBody(b []byte)SetFormBody(v map[string]string)SetJsonBody(v interface{})-
SetMultipartBody(data ...interface{})設(shè)置Multipart格式的數(shù)據(jù)
-
Callback(fn func(resp *Response)設(shè)置一個(gè)在Do方法調(diào)用完成之后執(zhí)行的回調(diào)函數(shù)
響應(yīng)數(shù)據(jù)
func main() {
res := goreq.Post("https://httpbin.org/post").Do()
fmt.Println(res.Body) // []byte格式的數(shù)據(jù)
fmt.Println(res.Text) // 自動(dòng)處理編碼后解析的字符串
}
Goreq一開始是為了API和網(wǎng)頁(yè)請(qǐng)求設(shè)計(jì)的庫(kù)兼呵，會(huì)自動(dòng)根據(jù)響應(yīng)內(nèi)容和響應(yīng)頭推斷編碼類型兔辅，并自動(dòng)解析為字符串。
如果我們要處理JSON格式的響應(yīng)數(shù)據(jù)击喂，這樣寫可以更優(yōu)雅维苔。
func main() {
var data map[string]interface{}
err := goreq.Post("https://httpbin.org/post").Do().BindJSON(&data)
fmt.Println(data, err)
}
Goreq為響應(yīng)res提供了一些快速解析的方法，*goreq.Response可以通過下述函數(shù)來獲取響應(yīng)數(shù)據(jù)懂昂。
-
Resp() (*Response, error)獲取響應(yīng)本身以及網(wǎng)絡(luò)請(qǐng)求錯(cuò)誤介时。 -
Txt() (string, error)自動(dòng)處理完編碼并解析為文本后的內(nèi)容以及網(wǎng)絡(luò)請(qǐng)求錯(cuò)誤。 HTML() (*goquery.Document, error)XML() (*xmlpath.Node, error)BindXML(i interface{}) errorJSON() (gjson.Result, error)BindJSON(i interface{}) error-
Error() error網(wǎng)絡(luò)請(qǐng)求錯(cuò)誤凌彬。（正常情況下為nil）
老爹說：還有一件事……
Goreq基本使用就是這樣沸柔，更完整的API請(qǐng)見GitHub。其中還包括自定義Client和中間件的使用铲敛。
