Resty 是 Go 语言中一个轻量级、简洁易用的 HTTP 客户端库。它的目标是提供一个简洁且易于使用的 API，以便进行常见的 HTTP 请求（如 GET、POST、PUT、DELETE 等）。如果你在 Go 项目中需要进行 HTTP 请求，可以考虑使用 Resty，因为它封装了很多常见操作，减少了开发者的重复工作。
安装 Resty
首先，你需要安装 Resty 包。可以使用以下命令：
go get github.com/go-resty/resty/v2
使用示例
以下是一个简单的 Resty 使用示例，展示了如何进行常见的 HTTP 请求操作。
- 创建一个基本的 Resty 客户端
package mainimport ("fmt""log""github.com/go-resty/resty/v2"
)func main() {// 创建 Resty 客户端client := resty.New()// 发送 GET 请求resp, err := client.R().Get("https://jsonplaceholder.typicode.com/todos/1")if err != nil {log.Fatalf("Error: %v", err)}// 打印响应状态和响应体fmt.Println("Response Status Code:", resp.StatusCode())fmt.Println("Response Body:", resp.String())
}
- 发送 POST 请求
你可以发送 JSON 或表单数据。以下是一个 POST 请求的例子。
package mainimport ("fmt""log""github.com/go-resty/resty/v2"
)func main() {client := resty.New()// 构造 POST 请求并发送 JSON 数据resp, err := client.R().SetHeader("Content-Type", "application/json").SetBody(`{"title": "foo", "body": "bar", "userId": 1}`).Post("https://jsonplaceholder.typicode.com/posts")if err != nil {log.Fatalf("Error: %v", err)}fmt.Println("Response Status Code:", resp.StatusCode())fmt.Println("Response Body:", resp.String())
}
- 处理 JSON 响应
Resty 会自动解析 JSON 响应并将其映射到你提供的结构体中。
package mainimport ("fmt""log""github.com/go-resty/resty/v2"
)// 定义响应数据结构
type Todo struct {UserID int `json:"userId"`ID int `json:"id"`Title string `json:"title"`Completed bool `json:"completed"`
}func main() {client := resty.New()var todo Todo// 发送 GET 请求并将 JSON 响应解析到结构体resp, err := client.R().SetResult(&todo).Get("https://jsonplaceholder.typicode.com/todos/1")if err != nil {log.Fatalf("Error: %v", err)}fmt.Println("Response Status Code:", resp.StatusCode())fmt.Printf("Response Body: %+v\n", todo)
}
- 发送带有 URL 参数的请求
package mainimport ("fmt""log""github.com/go-resty/resty/v2"
)func main() {client := resty.New()// 发送带有 URL 参数的 GET 请求resp, err := client.R().SetQueryParam("postId", "1").Get("https://jsonplaceholder.typicode.com/comments")if err != nil {log.Fatalf("Error: %v", err)}fmt.Println("Response Status Code:", resp.StatusCode())fmt.Println("Response Body:", resp.String())
}
- 处理表单提交
package mainimport ("fmt""log""github.com/go-resty/resty/v2"
)func main() {client := resty.New()// 发送表单数据resp, err := client.R().SetFormData(map[string]string{"username": "testuser","password": "password123",}).Post("https://example.com/login")if err != nil {log.Fatalf("Error: %v", err)}fmt.Println("Response Status Code:", resp.StatusCode())fmt.Println("Response Body:", resp.String())
}
Resty 常用功能
1.设置 Header：
可以通过 SetHeader 方法设置请求头。
client.R().SetHeader("Authorization", "Bearer your_token")
2.设置查询参数：
通过 SetQueryParam 设置 URL 查询参数。
client.R().SetQueryParam("id", "123")
3.设置请求体：
使用 SetBody 设置请求的内容。
client.R().SetBody("some data").Post("https://example.com")
4.自动处理 JSON：
Resty 自动解析 JSON 响应并将其映射到结构体。
var result struct {Name string `json:"name"`}client.R().SetResult(&result).Get("https://api.example.com/data")
5.设置认证：
支持基本认证和 Bearer Token。
client.R().SetBasicAuth("username", "password")client.R().SetAuthToken("your_bearer_token")
6.重试机制：
Resty 也支持设置请求重试机制。
client.SetRetryCount(3)client.SetRetryWaitTime(5 * time.Second)
总结
Resty 是一个功能强大且易于使用的 Go HTTP 客户端库，适用于开发中经常需要进行 HTTP 请求的场景。它通过简洁的 API 提供了对 JSON、表单数据、URL 参数等的处理支持，同时也能够进行请求头设置、认证、重试等功能。
