HTTP客户端
GF
框架提供了强大便捷易用的HTTP客户端,由 ghttp.Client
对象封装实现,对象创建可以通过 ghttp.NewClient()
包方法,也可以通过 g.Client()
方法调用。推荐使用 g.Client()
来便捷地创建HTTP客户端对象。
方法列表: https://pkg.go.dev/github.com/gogf/gf/net/ghttp/internal/client
常用方法:
type Client
// 创建客户端
func NewClient() *Client
// 原始请求方法
func (c *Client) Get(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Put(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Post(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Delete(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Connect(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Head(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Options(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Patch(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) Trace(url string, data ...interface{}) (*ClientResponse, error)
func (c *Client) DoRequest(method, url string, data ...interface{}) (*ClientResponse, error)
// 发起HTTP请求并返回二进制内容
func (c *Client) GetBytes(url string, data ...interface{}) []byte
func (c *Client) PutBytes(url string, data ...interface{}) []byte
func (c *Client) PostBytes(url string, data ...interface{}) []byte
func (c *Client) DeleteBytes(url string, data ...interface{}) []byte
func (c *Client) ConnectBytes(url string, data ...interface{}) []byte
func (c *Client) HeadBytes(url string, data ...interface{}) []byte
func (c *Client) OptionsBytes(url string, data ...interface{}) []byte
func (c *Client) PatchBytes(url string, data ...interface{}) []byte
func (c *Client) TraceBytes(url string, data ...interface{}) []byte
func (c *Client) RequestBytes(method string, url string, data ...interface{}) []byte
// 发起HTTP请求并返回字符串内容
func (c *Client) GetContent(url string, data ...interface{}) string
func (c *Client) PutContent(url string, data ...interface{}) string
func (c *Client) PostContent(url string, data ...interface{}) string
func (c *Client) DeleteContent(url string, data ...interface{}) string
func (c *Client) ConnectContent(url string, data ...interface{}) string
func (c *Client) HeadContent(url string, data ...interface{}) string
func (c *Client) OptionsContent(url string, data ...interface{}) string
func (c *Client) PatchContent(url string, data ...interface{}) string
func (c *Client) TraceContent(url string, data ...interface{}) string
func (c *Client) RequestContent(method string, url string, data ...interface{}) string
// 发起HTTP请求并返回泛型对象方便后续类型转换
func (c *Client) GetVar(url string, data ...interface{}) *gvar.Var
func (c *Client) PutVar(url string, data ...interface{}) *gvar.Var
func (c *Client) PostVar(url string, data ...interface{}) *gvar.Var
func (c *Client) DeleteVar(url string, data ...interface{}) *gvar.Var
func (c *Client) HeadVar(url string, data ...interface{}) *gvar.Var
func (c *Client) PatchVar(url string, data ...interface{}) *gvar.Var
func (c *Client) ConnectVar(url string, data ...interface{}) *gvar.Var
func (c *Client) OptionsVar(url string, data ...interface{}) *gvar.Var
func (c *Client) TraceVar(url string, data ...interface{}) *gvar.Var
func (c *Client) RequestVar(method string, url string, data ...interface{}) *gvar.Var
// 链式操作
func (c *Client) Ctx(ctx context.Context) *Client
func (c *Client) Timeout(t time.Duration) *Client
func (c *Client) Cookie(m map[string]string) *Client
func (c *Client) Header(m map[string]string) *Client
func (c *Client) HeaderRaw(headers string) *Client
func (c *Client) ContentType(contentType string) *Client
func (c *Client) ContentJson() *Client
func (c *Client) ContentXml() *Client
func (c *Client) BasicAuth(user, pass string) *Client
func (c *Client) Retry(retryCount int, retryInterval time.Duration) *Client
func (c *Client) Proxy(proxyURL string) *Client
func (c *Client) RedirectLimit(redirectLimit int) *Client
// 设置管理
func (c *Client) SetBasicAuth(user, pass string) *Client
func (c *Client) SetBrowserMode(enabled bool) *Client
func (c *Client) SetContentType(contentType string) *Client
func (c *Client) SetCookie(key, value string) *Client
func (c *Client) SetCookieMap(m map[string]string) *Client
func (c *Client) SetCtx(ctx context.Context) *Client
func (c *Client) SetHeader(key, value string) *Client
func (c *Client) SetHeaderMap(m map[string]string) *Client
func (c *Client) SetHeaderRaw(headers string) *Client
func (c *Client) SetPrefix(prefix string) *Client
func (c *Client) SetRetry(retryCount int, retryInterval int) *Client
func (c *Client) SetTimeout(t time.Duration) *Client
func (c *Client) SetProxy(proxyURL string)
简要说明:
- 我们可以使用
NewClient
创建一个自定义的HTTP客户端对象Client
,随后可以使用该对象执行请求,该对象底层使用了连接池设计,因此没有Close
关闭方法。HTTP
客户端对象也可以通过g.Client()
快捷方法创建。 - 客户端提供了一系列以
HTTP Method
命名的方法,调用这些方法将会发起对应的HTTP Method
请求。常用的方法是Get
和Post
方法,同时DoRequest
是核心的请求方法,用户可以调用该方法实现自定义的HTTP Method
发送请求。 - 请求返回结果为
*ClientResponse
对象,可以通过该结果对象获取对应的返回结果,通过ReadAll
/ReadAllString
方法可以获得返回的内容,该对象在使用完毕后需要通过Close
方法关闭,防止内存溢出。 *Bytes
方法用于获得服务端返回的二进制数据,如果请求失败返回nil
;*Content
方法用于请求获得字符串结果数据,如果请求失败返回空字符串;Set*
方法用于Client
的参数设置。*Var
方法直接请求并获取HTTP接口结果为泛型类型便于转换。如果请求失败或者请求结果为空,会返回一个空的g.Var
泛型对象,不影响转换方法调用。- 可以看到,客户端的请求参数的数据参数
data
数据类型为interface{}
类型,也就是说可以传递任意的数据类型,常见的参数数据类型为string
/map
,如果参数为map
类型,参数值将会被自动urlencode
编码。
请使用给定的方法创建 Client
对象,而不要使用 new(ghttp.Client)
或者 &ghttp.Client{}
创建客户端对象,否则,哼哼。
HTTP返回对象
ghttp.ClientResponse
为HTTP对应请求的返回结果对象,该对象继承于 http.Response
,可以使用 http.Response
的所有方法。在此基础之上增加了以下几个方法:
func (r *ClientResponse) GetCookie(key string) string
func (r *ClientResponse) GetCookieMap() map[string]string
func (r *ClientResponse) Raw() string
func (r *ClientResponse) RawDump()
func (r *ClientResponse) RawRequest() string
func (r *ClientResponse) RawResponse() string
func (r *ClientResponse) ReadAll() []byte
func (r *ClientResponse) ReadAllString() string
func (r *ClientResponse) Close() error
这里也要提醒的是, ClientResponse
需要手动调用 Close
方法关闭,也就是说,不管你使用不使用返回的 ClientResponse
对象,你都需要将该返回对象赋值给一个变量,并且手动调用其 Close
方法进行关闭(往往使用 defer r.Close()
),否则会造成文件句柄溢出、内存溢出。
一些重要说明
ghttp
客户端默认关闭了KeepAlive
功能以及对服务端TLS
证书的校验功能,如果需要启用可自定义客户端的Transport
属性。- 连接池参数设定、连接代理设置这些高级功能也可以通过自定义客户端的
Transport
属性实现,该数据继承于标准库的http.Transport
对象。