codecamp

GoFrame HTTPClient-基本介绍

HTTP客户端

GoFrame​框架提供了强大便捷易用的​HTTP​客户端,由​gclient​组件实现,对象创建可以通过​gclient.New()​包方法,也可以通过​g.Client()​方法调用。推荐使用​g.Client()​来便捷地创建​HTTP​客户端对象。

方法列表: https://pkg.go.dev/github.com/gogf/gf/v2/net/gclient

简要说明:

  1. 我们可以使用​New​创建一个自定义的​HTTP​客户端对象​Client​,随后可以使用该对象执行请求,该对象底层使用了连接池设计,因此没有​Close​关闭方法。​HTTP​客户端对象也可以通过​g.Client()​快捷方法创建。
  2. 客户端提供了一系列以​HTTP Method​命名的方法,调用这些方法将会发起对应的​HTTP Method​请求。常用的方法是​Get​和​Post​方法,同时​DoRequest​是核心的请求方法,用户可以调用该方法实现自定义的​HTTP Method​发送请求。
  3. 请求返回结果为​*ClientResponse​对象,可以通过该结果对象获取对应的返回结果,通过​ReadAll​/​ReadAllString​方法可以获得返回的内容,该对象在使用完毕后需要通过​Close​方法关闭,防止内存溢出。
  4. *Bytes​方法用于获得服务端返回的二进制数据,如果请求失败返回​nil​;​*Content​方法用于请求获得字符串结果数据,如果请求失败返回空字符串;​Set*​方法用于​Client​的参数设置。
  5. *Var​方法直接请求并获取​HTTP​接口结果为泛型类型便于转换。如果请求失败或者请求结果为空,会返回一个空的​g.Var​泛型对象,不影响转换方法调用。
  6. 可以看到,客户端的请求参数的数据参数​data​数据类型为​interface{}​类型,也就是说可以传递任意的数据类型,常见的参数数据类型为​string​/​map​,如果参数为​map​类型,参数值将会被自动​urlencode​编码。

请使用给定的方法创建​Client​对象,而不要使用​new(ghttp.Client)​或者​&ghttp.Client{}​创建客户端对象。

HTTP返回对象

gclient.Response​为​HTTP​对应请求的返回结果对象,该对象继承于​http.Response​,可以使用​http.Response​的所有方法。在此基础之上增加了以下几个方法:

func (r *Response) GetCookie(key string) string
func (r *Response) GetCookieMap() map[string]string
func (r *Response) Raw() string
func (r *Response) RawDump()
func (r *Response) RawRequest() string
func (r *Response) RawResponse() string
func (r *Response) ReadAll() []byte
func (r *Response) ReadAllString() string
func (r *Response) Close() error

这里也要提醒的是,​Response​需要手动调用​Close​方法关闭,也就是说,不管你使用不使用返回的​Response​对象,你都需要将该返回对象赋值给一个变量,并且手动调用其​Close​方法进行关闭(往往使用​defer r.Close()​),否则会造成文件句柄溢出、内存溢出。

一些重要说明

  • ghttp​客户端默认关闭了​KeepAlive​功能以及对服务端​TLS​证书的校验功能,如果需要启用可自定义客户端的​Transport​属性。
  • 连接池参数设定、连接代理设置这些高级功能也可以通过自定义客户端的​Transport​属性实现,该数据继承于标准库的​http.Transport​对象。


GoFrame WEB服务开发-异常处理
GoFrame HTTPClient-链式操作
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

GoFrame 核心组件

GoFrame 核心组件-数据库ORM

GoFrame 模块列表

GoFrame 模块列表-单元测试

GoFrame 模块列表-功能调试

GoFrame WEB服务开发

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }