今天介绍一个可以跟fasthttp比肩的http库imroc/req
一、简介
imroc/req 是一个用于 Golang 的 HTTP 请求客户端库，其设计理念类似于 Python 的 Requests 库。该库提供了简单、直观的 API，使得开发者能够快速构造并发送 HTTP 请求，同时方便地处理响应数据。它适用于处理各种常见的 HTTP 请求场景，包括 GET、POST、PUT、DELETE 等，同时支持 JSON、表单数据、文件上传等多种内容类型。
二、特点
- 简单易用的 API
通过链式调用和简化的函数接口，极大地降低了发送 HTTP 请求的门槛，代码更加清晰易读。 - 丰富的数据处理能力
内置对 JSON 数据的自动编码与解码支持，能够快速将响应数据绑定到结构体或 Map 中，方便后续处理。 - 多种请求方式支持
支持 GET、POST、PUT、DELETE、PATCH 等常见的 HTTP 方法，可以轻松应对各类接口请求。 - 灵活的请求配置
可以通过设置 Header、Query 参数、Cookies 等自定义 HTTP 请求，同时支持超时、代理、重试等高级配置。 - 文件上传和多部分表单
内置对多部分表单数据（multipart/form-data）的支持，方便实现文件上传等需求。 - 错误处理与调试
对网络错误、超时等情况进行了良好的封装，同时支持调试模式，帮助开发者快速定位问题。
三、安装
使用 go get 命令即可安装该库：
go get -u github.com/imroc/req
四、基本用法
1. GET 请求
下面示例展示了如何使用 req 发送一个 GET 请求，并将返回的 JSON 数据解析到一个 Map 中：
package main
import (
"fmt"
"log"
"github.com/imroc/req"
)
func main() {
// 发送 GET 请求，并带上自定义 Header
resp, err := req.Get("https://httpbin.org/get", req.Header{
"User-Agent": "imroc-req",
})
if err != nil {
log.Fatalf("请求失败: %v", err)
}
// 将响应的 JSON 数据解析到 map 中
var result map[string]interface{}
err = resp.ToJSON(&result)
if err != nil {
log.Fatalf("解析 JSON 失败: %v", err)
}
fmt.Println("GET 请求返回数据:", result)
}
2. POST 请求
使用 POST 请求时，可以通过内置方法自动将数据编码为 JSON 或表单数据：
package main
import (
"fmt"
"log"
"github.com/imroc/req"
)
func main() {
// 构造 JSON 请求体
payload := req.BodyJSON(map[string]string{
"name": "imroc",
"lang": "go",
})
// 发送 POST 请求
resp, err := req.Post("https://httpbin.org/post", payload)
if err != nil {
log.Fatalf("请求失败: %v", err)
}
// 输出响应内容
fmt.Println("POST 请求返回:", resp)
}
3. 文件上传
通过 multipart 表单上传文件同样十分简单：
package main
import (
"fmt"
"log"
"os"
"github.com/imroc/req"
)
func main() {
// 打开需要上传的文件
file, err := os.Open("example.txt")
if err != nil {
log.Fatalf("打开文件失败: %v", err)
}
defer file.Close()
// 构造 multipart/form-data 的请求体，其中 req.File 用于指定文件内容及文件名
payload := req.BodyFormMultipart(req.Param{
"file": req.File{
File: file,
FileName: "example.txt",
},
"description": "这是一个文件上传示例",
})
// 发送 POST 请求
resp, err := req.Post("https://httpbin.org/post", payload)
if err != nil {
log.Fatalf("请求失败: %v", err)
}
fmt.Println("文件上传返回:", resp)
}
五、进阶
1. 超时和代理
可以通过 req.SetTimeout、req.SetProxy 等方法设置全局超时或者代理。例如：
package main
import (
"fmt"
"log"
"time"
"github.com/imroc/req"
)
func main() {
// 设置请求超时时间为 10 秒
req.SetTimeout(10 * time.Second)
// 设置 HTTP 代理
req.SetProxy("http://127.0.0.1:8080")
resp, err := req.Get("https://httpbin.org/get")
if err != nil {
log.Fatalf("请求失败: %v", err)
}
fmt.Println("返回结果:", resp)
}
2. 全局 Header 与 Cookie
如果有需要为每个请求添加一些公共 Header 或 Cookie，也可以通过设置全局配置来实现：
package main
import (
"fmt"
"log"
"github.com/imroc/req"
)
func main() {
// 设置全局 Header
req.SetCommonHeader(req.Header{
"Authorization": "Bearer your-token",
"Accept": "application/json",
})
// 设置全局 Cookie
req.SetCommonCookie("sessionid=your-session-id")
resp, err := req.Get("https://httpbin.org/get")
if err != nil {
log.Fatalf("请求失败: %v", err)
}
fmt.Println("全局 Header 和 Cookie 返回:", resp)
}
3. 请求调试模式
在开发过程中，如果需要查看请求和响应的详细信息，可以开启调试模式：
package main
import (
"github.com/imroc/req"
)
func main() {
// 开启调试模式，会打印详细的请求和响应日志
req.Debug = true
_, _ = req.Get("https://httpbin.org/get")
}
六、简单总结一下
- 易用性：
imroc/req以简洁直观的 API 帮助开发者快速发送 HTTP 请求，类似于 Python 的 Requests 库，降低了使用门槛。 - 丰富功能：支持 JSON 编码解码、表单提交、文件上传、全局设置等常见需求，同时可灵活定制请求参数、超时、代理等高级配置。
- 适用场景：适用于各种需要 HTTP 通信的应用场景，如 API 调用、数据抓取、自动化测试以及微服务之间的通信等。
总体而言，imroc/req 是一个轻量级且功能强大的 HTTP 客户端库，非常适合在 Golang 项目中使用。