Golang 语言极简 HTTP 客户端 GoRequest

开发 后端
GoRequest 是一个极简的 HTTP 客户端,作者灵感来源于 Node.js 库 SuperAgent。相比 Golang 标准库 net/http,GoRequest 使用起来更加简单。GoRequest 官方的口号是 “像机枪一样发送请求”。

[[429410]]

1介绍

GoRequest 是一个极简的 HTTP 客户端,作者灵感来源于 Node.js 库 SuperAgent。相比 Golang 标准库 net/http,GoRequest 使用起来更加简单。GoRequest 官方的口号是 “像机枪一样发送请求”。

GoRequest 包含以下功能:

  • 支持 HTTP 请求方式:Get/Post/Put/Head/Delete/Patch/Options
  • 支持设置 header 请求头
  • 支持使用 JSON 字符串作为请求参数
  • 支持将多路请求的方式发送数据和文件
  • 支持通过代理发送请求
  • 支持为请求设置超时
  • 支持 TLS 客户端设置
  • 支持设置重定向策略
  • 支持为请求设置 cookie
  • CookieJar - automatic in-memory cookiejar
  • 支持请求头设置基本身份认证

安装方式:

  1. go get github.com/parnurzeal/gorequest 

2HTTP 请求方式

Golang 发送一个简单的 Get 请求,使用 net/http 标准库和使用 GoRequst 库,两种发送 Get 请求的方式都比较简单。

示例代码如下:

标准库方式:

  1. resp, err := http.Get("http://example.com/"

GoRequest 库方式:

  1. request := gorequest.New() 
  2. resp, body, errs := request.Get("http://example.com/").End() 

或(该 GoRequest 方式无法复用对象)

  1. resp, body, errs := gorequest.New().Get("http://example.com/").End() 

阅读上面这两段代码,我们可以发现,使用标准库的方式发送 Get 请求,甚至比使用 GoRequest 库的方式发送 Get 请求更加简单。

但是,当我们需求稍作修改,比如我们需要为 Get 请求,设置 header 头和设置重定向策略。我们再来看一下分别使用标准库和 GoRequest 库两种实现方式。

标准库方式:

  1. client := &http.Client{ 
  2.   CheckRedirect: redirectPolicyFunc, 
  3.  
  4. req, err := http.NewRequest("GET""http://example.com", nil) 
  5.  
  6. req.Header.Add("If-None-Match", `W/"wyzzy"`) 
  7. resp, err := client.Do(req) 

GoRequest 库方式(其它 HTTP 请求方式与 Get 使用方式相同):

  1. request := gorequest.New() 
  2. resp, body, errs := request.Get("http://example.com"). 
  3.   RedirectPolicy(redirectPolicyFunc). 
  4.   Set("If-None-Match", `W/"wyzzy"`). 
  5.   End() 

阅读上面两段代码,很容易发现使用 GoRequest 方式使实现更加简单。使用标准库方式,首先需要创建一个 Client,然后使用不同的命令设置 header 头等操作,这仅仅是为了实现一个 HTTP 请求。而使用 GoRequest 方式,仅需链式调用两个方法即可轻松实现。

3JSON 格式请求参数

在 Golang 语言中,如果使用标准库 net/http 发送请求参数为 JSON 格式的 POST 请求,首先需要先将 map 或 struct 类型的数据,使用标准库 encoding/json 的 Marshal 方法,将数据转换为 JSON 格式的数据,并且设置 header 头参数 Content-Type 的值为 application/json,然后创建一个 Client,最终你的代码变得越来越长,越来越难维护。

标准库方式:

  1. m := map[string]interface{}{ 
  2.   "name""backy"
  3.   "species""dog"
  4. mJson, _ := json.Marshal(m) 
  5. contentReader := bytes.NewReader(mJson) 
  6. req, _ := http.NewRequest("POST""http://example.com", contentReader) 
  7. req.Header.Set("Content-Type""application/json"
  8. req.Header.Set("Notes","GoRequest is coming!"
  9. client := &http.Client{} 
  10. resp, _ := client.Do(req) 

如果使用 GoRequest 库发送请求参数为 JSON 格式的 POST 请求,因为它默认支持 JSON 格式的请求参数,所以它只需要一行代码就可以实现。

GoRequest 库方式:

  1. request := gorequest.New() 
  2. resp, body, errs := request.Post("http://example.com"). 
  3.   Set("Notes","gorequst is coming!"). 
  4.   Send(`{"name":"backy""species":"dog"}`). 
  5.   End() 

4支持回调函数 Callback

GoRequest 库还支持回调函数,你可以根据自己的项目需求灵活使用它,回调函数示例代码如下:

  1. func printStatus(resp gorequest.Response, body string, errs []error){ 
  2.   fmt.Println(resp.Status) 
  3. gorequest.New().Get("http://example.com").End(printStatus) 

5请求控制

在 Golang 项目开发中,有时我们可能需要对请求做一些额外控制,比如超时处理,重试请求 N 次,重定向处理等。GoRequest 库都可以为我们提供简单的实现方式。

超时处理:

  1. request := gorequest.New().Timeout(2*time.Millisecond) 
  2. resp, body, errs:= request.Get("http://example.com").End() 

需要注意的是,Timeout 是将 Dial 连接和 IO 读写的耗时总和,与时间参数作比较。

重试请求:

  1. request := gorequest.New() 
  2. resp, body, errs := request.Get("http://example.com/"). 
  3.                     Retry(3, 5 * time.Second, http.StatusBadRequest, http.StatusInternalServerError). 
  4.                     End() 

阅读上面这段代码,它的含义是当服务器返回结果是 http.StatusBadRequest 或 http.StatusInternalServerError 时,会每隔 5 秒重试请求一次,共重试 3 次。

重定向处理:

  1. request := gorequest.New() 
  2. resp, body, errs := request.Get("http://example.com/"). 
  3.                     RedirectPolicy(func(req Request, via []*Request) error { 
  4.                       if req.URL.Scheme != "https" { 
  5.                         return http.ErrUseLastResponse 
  6.                       } 
  7.                     }). 
  8.                     End() 

阅读上面这段代码,它的含义是将 http 请求重定向为 https 请求。

6返回结果处理方式

读者朋友们可能已经发现,以上示例代码都是以 End 结束,End 的含义是返回结果是字符串类型,如果我们希望返回结果是其他类型,比如字节类型和结构体类型,可以将 End 分别替换为 EndBytes 和 EndStruct。

EndBytes 格式:

  1. resp, bodyBytes, errs := gorequest.New().Get("http://example.com/").EndBytes() 

EndStruct 格式:

  1. heyYou struct { 
  2.   Hey string `json:"hey"
  3.  
  4. var heyYou heyYou 
  5.  
  6. resp, _, errs := gorequest.New().Get("http://example.com/").EndStruct(&heyYou) 

7总结

本文我们介绍 Golang 语言的极简 HTTP 客户端 GoRequest 以及它的使用方法。它比标准库 net/http 使用方式简单,当我们项目开发中需要使用 HTTP 方式调用接口时,强烈推荐使用 GoRequest 库。

GoRequest 底层在大多数用例中是基于 http.Client 实现的,所以通过一次调用 gorequest.New() 得到的对象,应尽可能多次使用。

GoRequest 除了上面介绍的 JSON 参数,它还支持 Struct 和 File,感兴趣的读者可以查阅官方文档了解相关内容。

本文转载自微信公众号「Golang语言开发栈」,可以通过以下二维码关注。转载本文请联系Golang语言开发栈公众号。

 

责任编辑:武晓燕 来源: Golang语言开发栈
相关推荐

2021-05-07 15:28:03

Kafka客户端Sarama

2022-02-20 23:15:46

gRPCGolang语言

2015-01-13 10:32:23

RestfulWeb框架

2021-11-14 23:05:28

GoCast语言

2024-02-05 08:50:57

Golang标准库客户端

2021-05-21 10:48:09

http语言开发

2020-03-24 15:15:29

HttpClientOkHttpJava

2021-08-01 23:18:21

Redis Golang命令

2021-10-26 09:26:21

编程技能开发

2011-08-17 10:10:59

2021-09-22 15:46:29

虚拟桌面瘦客户端胖客户端

2024-10-16 08:51:57

2010-05-31 10:11:32

瘦客户端

2011-10-26 13:17:05

2011-03-02 14:36:24

Filezilla客户端

2010-12-21 11:03:15

获取客户端证书

2011-03-24 13:00:31

配置nagios客户端

2009-11-07 14:57:00

2009-07-10 18:15:24

HTTP头

2009-03-04 10:27:50

客户端组件桌面虚拟化Xendesktop
点赞
收藏

51CTO技术栈公众号