beego客戶端請求httplib

客戶端請求

httplib 庫主要用來模擬客戶端發送 HTTP 請求，類似於 Curl 工具，支持 JQuery 類似的鏈式操作。使用起來相當的方便；通過如下方式進行安裝：

go get github.com/astaxie/beego/httplib

如何使用

首先導入包

import ( "github.com/astaxie/beego/httplib" )

然后初始化請求方法，返回對象

req := httplib.Get("http://beego.me/")

然后我們就可以獲取數據了

str, err := req.String() if err != nil { t.Fatal(err) } fmt.Println(str)

支持的方法對象

httplib 包里面支持如下的方法返回 request 對象，即支持restful的api：

• Get(url string)
• Post(url string)
• Put(url string)
• Delete(url string)
• Head(url string)

支持 debug 輸出

可以根據上面五個方法返回的對象進行調試信息的輸出：

req.Debug(true)

這樣就可以看到請求數據的詳細輸出

httplib.Get("http://beego.me/").Debug(true).Response() //輸出數據如下 GET / HTTP/0.0 Host: beego.me User-Agent: beegoServer

支持 HTTPS 請求

如果請求的網站是 HTTPS 的，那么我們就需要設置 client 的 TLS 信息，如下所示：

req.SetTLSClientConfig(&tls.Config{InsecureSkipVerify: true})

關於如何設置這些信息請訪問： http://gowalker.org/crypto/tls#Config

支持超時設置

通過如下接口可以設置請求的超時時間和數據讀取時間：

req.SetTimeout(connectTimeout, readWriteTimeout)

以上方法都是針對 request 對象的，所以你第一步必須是返回 request 對象，然后鏈式操作，類似這樣的代碼：

httplib.Get("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second).Response()

設置請求參數

對於 Put 或者 Post 請求，需要發送參數，那么可以通過 Param 發送 k/v 數據，如下所示：

req := httplib.Post("http://beego.me/") req.Param("username","astaxie") req.Param("password","123456")

發送大片的數據

有時候需要上傳文件之類的模擬，那么如何發送這個文件數據呢？可以通過 Body 函數來操作，舉例如下：

req := httplib.Post("http://beego.me/") bt,err:=ioutil.ReadFile("hello.txt") if err!=nil{ log.Fatal("read file err:",err) } req.Body(bt)

設置 header 信息

除了請求參數之外，我們有些時候需要模擬一些頭信息，例如

Accept-Encoding:gzip,deflate,sdch Host:beego.me User-Agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.57 Safari/537.36

可以通過 Header 函數來設置，如下所示：

req := httplib.Post("http://beego.me/") req.Header("Accept-Encoding","gzip,deflate,sdch") req.Header("Host","beego.me") req.Header("User-Agent","Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.57 Safari/537.36")

設置 transport

http請求的傳輸由http.RoundTrip承載，因此我們可以實現接口以實現鏈接的控制。通過設置，我們可以實現長連接，如下所示:

var tp http.RoundTripper = &http.Transport{ DialContext: (&net.Dialer{ Timeout: 30 * time.Second, KeepAlive: 30 * time.Second, DualStack: true, }).DialContext, MaxIdleConns: 100, IdleConnTimeout: 90 * time.Second, ExpectContinueTimeout: 1 * time.Second, } req := httplib.Post("http://beego.me/") req.SetTransport(tp)

httplib支持文件直接上傳接口

PostFile 第一個參數是 form 表單的字段名,第二個是需要發送的文件名或者文件路徑

b:=httplib.Post("http://beego.me/") b.Param("username","astaxie") b.Param("password","123456") b.PostFile("uploadfile1", "httplib.pdf") b.PostFile("uploadfile2", "httplib.txt") str, err := b.String() if err != nil { t.Fatal(err) }

獲取返回結果

上面這些都是在發送請求之前的設置，接下來我們開始發送請求，然后如何來獲取數據呢？主要有如下幾種方式：

• 返回 Response 對象，req.Response() 方法

  這個是 http.Response 對象，用戶可以自己讀取 body 的數據等。

• 返回 bytes,req.Bytes() 方法

  直接返回請求 URL 返回的內容

• 返回 string，req.String() 方法

  直接返回請求 URL 返回的內容

• 保存為文件，req.ToFile(filename) 方法

  返回結果保存到文件名為 filename 的文件中

• 解析為 JSON 結構，req.ToJSON(&result) 方法

  返回結構直接解析為 JSON 格式，解析到 result 對象中

• 解析為 XML 結構，req.ToXml(&result) 方法

  返回結構直接解析為 XML 格式，解析到 result 對象中