[TOC]
gf提供了强大易用的HTTP客户端，由ghttp提供支持(ghttp包统一封装了HTTP客户端及服务端功能)，我们先来看一下HTTP客户端的方法有哪些：
func NewClient() *Client
func (c *Client) Connect(url, data string) (*ClientResponse, error)
func (c *Client) Delete(url, data string) (*ClientResponse, error)
func (c *Client) DoRequest(method, url string, data []byte) (*ClientResponse, error)
func (c *Client) Get(url string) (*ClientResponse, error)
func (c *Client) Head(url, data string) (*ClientResponse, error)
func (c *Client) Options(url, data string) (*ClientResponse, error)
func (c *Client) Patch(url, data string) (*ClientResponse, error)
func (c *Client) Post(url, data string) (*ClientResponse, error)
func (c *Client) Put(url, data string) (*ClientResponse, error)
func (c *Client) SetBasicAuth(user, pass string)
func (c *Client) SetHeader(key, value string)
func (c *Client) SetTimeOut(t time.Duration)
func (c *Client) Trace(url, data string) (*ClientResponse, error)我们可以使用ghttp.NewClient创建一个HTTP客户端对象，随后可以使用该对象执行请求。ghttp.Client对象中封装了一系列基于HTTP Method来命名的方法，调用这些方法将会发起对应的HTTP Method请求。常用的方法当然是Get和Post方法，此外DoRequest是核心的请求方法，用户可以调用该方法实现自定义的HTTP Method发送请求。
ghttp模块也提供了独立的包函数来实现HTTP请求，函数列表如下：
func Connect(url, data string) (*ClientResponse, error)
func Delete(url, data string) (*ClientResponse, error)
func DoRequest(method, url string, data []byte) (*ClientResponse, error)
func Get(url string) (*ClientResponse, error)
func Head(url, data string) (*ClientResponse, error)
func Options(url, data string) (*ClientResponse, error)
func Patch(url, data string) (*ClientResponse, error)
func Post(url, data string) (*ClientResponse, error)
func Put(url, data string) (*ClientResponse, error)
func Trace(url, data string) (*ClientResponse, error)函数说明与Client对象的方法说明一致，因此比较常见的情况是直接使用ghttp对应的HTTP包方法来实现HTTP客户端请求，而不用创建一个Client对象来处理。不过，当需要自定义请求的一些细节(例如超时时间、Cookie、Header等)时，就得依靠自定义的Client对象来处理了(需要New一个ghttp.Client对象来控制)。
与ghttp.Client对应的是ghttp.ClientResponse，表示HTTP对应请求的返回结果对象，该对象继承于http.Response，可以使用http.Response的所有方法。在此基础之上增加了以下两个方法：
func (r *ClientResponse) Close()
func (r *ClientResponse) ReadAll() []byte这两个方法也是最常用的两个方法，一个是关闭请求返回结果对象，一个是获取所有的返回内容。
这里也要提醒的是，ghttp.ClientResponse是需要手动调用Close方法关闭的，也就是说，不管你使用不使用返回的ghttp.ClientResponse对象，你都需要将该返回对象赋值给一个变量，并且（在不使用的时候）手动调用其Close方法进行关闭。需要手动关闭返回对象这一点，与标准库的HTTP客户端请求对象操作相同。
我们来看几个HTTP客户端请求的例子：
-
发送GET请求，并打印出返回值
if r, e := ghttp.Get("http://johng.cn"); e != nil { fmt.Println(e) } else { fmt.Println(string(r.ReadAll())) r.Close() }
-
发送POST请求，并打印出返回值
if r, e := ghttp.Post("http://127.0.0.1:8199/form", "name=john&age=18"); e != nil { fmt.Println(e) } else { fmt.Println(string(r.ReadAll())) r.Close() }
-
发送POST请求，编码请求参数，并打印出返回值
params := ghttp.BuildParams(map[string]string{ "submit" : "1", "callback" : "http://127.0.0.1/callback?url=http://baidu.com", }) if r, e := ghttp.Post("http://127.0.0.1:8199/form", params); e != nil { fmt.Println(e) } else { fmt.Println(string(r.ReadAll())) r.Close() }
对于复杂参数的请求处理来讲，这是一个非常典型的例子。gf的HTTP客户端设计得非常简洁，请求参数类型被设计为最常用的string类型，因此在传递多参数的时候用户可以使用"&"符号进行连接，但当参数中带有特殊字符时，需要使用
ghttp.BuildParams方法进行编码处理，并生成用于请求的参数字符串。 当然，您也可以使用gurl.Encode方法来自行对参数进行编码处理。 -
发送DELETE请求，并打印出返回值
if r, e := ghttp.Delete("http://127.0.0.1:8199/user", "10000"); e != nil { fmt.Println(e) } else { fmt.Println(string(r.ReadAll())) r.Close() }
gf的HTTP客户端封装并极大简化了文件上传功能，直接上例子：
-
客户端 gitee.com/johng/gf/blob/master/geg/net/ghttp/client/upload/client.go
package main import ( "fmt" "gitee.com/johng/gf/g/os/glog" "gitee.com/johng/gf/g/net/ghttp" ) func main() { path := "/home/john/Workspace/Go/gitee.com/johng/gf/version.go" r, e := ghttp.Post("http://127.0.0.1:8199/upload", "name=john&age=18&upload-file=@file:" + path) if e != nil { glog.Error(e) } else { fmt.Println(string(r.ReadAll())) r.Close() } }
可以看到，文件上传参数格式使用
参数名=@file:文件路径，HTTP客户端将会自动解析文件路径对应的文件内容并读取提交给服务端。原本复杂的文件上传操作被gf进行了封装处理，用户只需要使用@file:+文件路径来构成参数值即可。 -
服务端 gitee.com/johng/gf/blob/master/geg/net/ghttp/client/upload/server.go
package main import ( "gitee.com/johng/gf/g" "gitee.com/johng/gf/g/os/gfile" "gitee.com/johng/gf/g/net/ghttp" ) // 执行文件上传处理，上传到系统临时目录 /tmp func Upload(r *ghttp.Request) { if f, h, e := r.FormFile("upload-file"); e == nil { defer f.Close() name := gfile.Basename(h.Filename) buffer := make([]byte, h.Size) f.Read(buffer) gfile.PutBinContents("/tmp/" + name, buffer) r.Response.Write(name + " uploaded successly") } else { r.Response.Write(e.Error()) } } // 展示文件上传页面 func UploadShow(r *ghttp.Request) { r.Response.Write(` <html> <head> <title>上传文件</title> </head> <body> <form enctype="multipart/form-data" action="/upload" method="post"> <input type="file" name="upload-file" /> <input type="submit" value="upload" /> </form> </body> </html> `) } func main() { s := g.Server() s.BindHandler("/upload", Upload) s.BindHandler("/upload/show", UploadShow) s.SetPort(8199) s.Run() }
访问
http://127.0.0.1:8199/upload/show选择需要上传的文件，提交之后可以看到文件上传成功到服务器上。文件上传比较简单，但是需要注意的是，服务端在上传处理中需要使用f.Close() 关闭掉临时上传文件指针。
http客户端发起请求时可以自定义发送给服务端的Header内容，该特性使用SetHeader(key, value string)方法实现。我们来看一个客户端自定义Cookie的例子。
-
客户端
gitee.com/johng/gf/blob/master/geg/net/ghttp/client/cookie/client.go
package main import ( "fmt" "gitee.com/johng/gf/g/os/glog" "gitee.com/johng/gf/g/net/ghttp" ) func main() { c := ghttp.NewClient() c.SetHeader("Cookie", "name=john; score=100") if r, e := c.Get("http://127.0.0.1:8199/"); e != nil { glog.Error(e) } else { fmt.Println(string(r.ReadAll())) } }
通过
ghttp.NewClient()创建一个自定义的http请求客户端对象，并通过c.SetHeader("Cookie", "name=john; score=100")设置自定义的Cookie，这里我们设置了两个示例用的Cookie参数，一个name，一个score，注意多个Cookie参数使用;符号分隔。 -
服务端
gitee.com/johng/gf/blob/master/geg/net/ghttp/client/cookie/server.go
package main import ( "gitee.com/johng/gf/g" "gitee.com/johng/gf/g/net/ghttp" ) func main() { s := g.Server() s.BindHandler("/", func(r *ghttp.Request){ r.Response.Writeln(r.Cookie.Map()) }) s.SetPort(8199) s.Run() }
服务端的逻辑很简单，直接将接收到的Cookie参数全部打印出来。
-
执行结果
客户端代码执行后，终端将会打印出服务端的返回结果，如下：
map[name:john score:100 gfsessionid:1ADDSEU5QN425798]
可以看到，服务端已经接收到了客户端自定义的Cookie参数。其中
gfsessionid是每个http请求都会有的sessionid，是gf框架自带的Cookie参数。