项目简介
- requests包是使用Go语言开发，模仿python的request包写的用于发起http请求，并返回响应结果的第三方包。
- 项目地址：tiancheng92/requests
使用方法
go get -u github.com/tiancheng92/requests
requests库方法详解
requests（请求方法）
用户需要创建一个requests对象，然后调用相应的方法来设置请求体（链式调用），最后调用Get、Post、Put、Patch、Delete或Head方法发送请求。
| 函数签名 | 描述 |
|---|---|
| func New() *request | 新建request对象 |
| func (r *request) SetUrl(url string) *request | 设置请求的URL |
| func (r *request) SetRawBody(data string) *request | 设置请求体 |
| func (r *request) SetJsonBody(data any) *request | 设置JSON请求体并添加JSON请求头 |
| func (r *request) SetXMLBody(data any) *request | 设置XML请求体并添加XML请求头 |
| func (r *request) SetRawQuery(data string) *request | 设置Query（纯字符串，如：a=1&b=2） |
| func (r *request) AddQuery(key, value string) *request | 以key/value对的形式逐一新增Query |
| func (r *request) AddCookie(cookie http.Cookie) *request | 新增Cookie |
| func (r *request) AddHeader(key, value string) *request | 新增Header头 |
| func (r *request) AddFileField(key, value string) *request | 新增上传文件时附带的key/value对 |
| func (r *request) AddFormHeader() *request | 添加表单请求头 |
| func (r *request) AddJsonHeader() *request | 添加JSON请求头 |
| func (r *request) AddXMLHeader() *request | 添加XML请求头 |
| func (r *request) SetTimeOut(duration time.Duration) *request | 设置请求超时时间 |
| func (r *request) SetUploadFileByFilePath(fieldName, filename string) *request | 设置要上传的文件路径 |
| func (r *request) SetUploadFile(fieldName, filename string, fileData io.Reader) *request | 设置要上传的文件 |
| func (r *request) SetTLS(TlSConfig *tls.Config) *request | 设置TLS |
| func (r *request) SetBasicAuth(username, password string) *request | 设置Basic Auth |
| func (r request) Get() (Response, error) | 发起Get请求 |
| func (r request) Post() (Response, error) | 发起Post请求 |
| func (r request) Put() (Response, error) | 发起Put请求 |
| func (r request) Patch() (Response, error) | 发起Patch请求 |
| func (r request) Delete() (Response, error) | 发起Delete请求 |
| func (r request) Head() (Response, error) | 发起Head请求 |
response（返回内容）
成功请求远端数据后，会返回一个response对象，该对象包含了请求的状态码（Response.StatusCode）、请求头(StatusCode.Header)、响应体(Response.Body)、原生响应体（Response.RawResponse）。
ResponseBody（响应体）
| 函数签名 | 描述 |
|---|---|
| func (rb ResponseBody) JsonBind(obj any) error | 把返回的JSON格式的Response.Body映射到指定对象中 |
| func (rb ResponseBody) XMLBind(obj any) error | 把返回的XML格式的Response.Body映射到指定对象中 |
| func (rb ResponseBody) String() string | 返回原生响应字符串 |
构建相关
requests库内建了自己的json包，支持使用go_json或json-iterator进行json解析。
| json解析方式 | 构建约束 |
|---|---|
| encoding/json | go build … |
| github.com/goccy/go-json | go build -tags=go_json … |
| github.com/json-iterator/go | go build -tags=jsoniter … |