Golang人性化HTTP请求处理库 - Request

Request是一个简单易用的Go语言HTTP客户端库，它提供了更加人性化的API来发送HTTP请求。下面我将详细介绍它的使用方法和示例代码。

安装

go get github.com/parnurzeal/gorequest

基本用法

1. 简单GET请求

package main

import (
	"fmt"
	"github.com/parnurzeal/gorequest"
)

func main() {
	_, body, errs := gorequest.New().Get("https://httpbin.org/get").End()
	if errs != nil {
		fmt.Println("请求出错:", errs)
		return
	}
	fmt.Println("响应内容:", body)
}

2. 带参数的GET请求

func main() {
	request := gorequest.New()
	_, body, errs := request.Get("https://httpbin.org/get").
		Query("name=John").
		Query("age=30").
		End()
	
	// 或者使用map添加参数
	params := map[string]string{
		"city": "New York",
		"job":  "developer",
	}
	_, body, errs = request.Get("https://httpbin.org/get").
		Query(params).
		End()
}

3. POST请求发送JSON数据

func main() {
	type User struct {
		Name string `json:"name"`
		Age  int    `json:"age"`
	}
	
	user := User{
		Name: "Alice",
		Age:  25,
	}
	
	_, body, errs := gorequest.New().
		Post("https://httpbin.org/post").
		Send(user).
		End()
	
	if errs != nil {
		fmt.Println("请求出错:", errs)
		return
	}
	fmt.Println("响应内容:", body)
}

4. 设置请求头

func main() {
	_, body, errs := gorequest.New().
		Get("https://httpbin.org/headers").
		Set("Authorization", "Bearer token123").
		Set("X-Custom-Header", "value").
		End()
}

5. 处理响应

func main() {
	type Response struct {
		Args    map[string]string `json:"args"`
		Headers map[string]string `json:"headers"`
		Origin  string            `json:"origin"`
		URL     string            `json:"url"`
	}
	
	var resp Response
	res, body, errs := gorequest.New().
		Get("https://httpbin.org/get").
		Query("param1=value1").
		EndStruct(&resp)  // 直接将响应解析到结构体
	
	if errs != nil {
		fmt.Println("请求出错:", errs)
		return
	}
	
	fmt.Println("状态码:", res.StatusCode)
	fmt.Println("解析后的响应:", resp)
	fmt.Println("原始响应体:", body)
}

6. 超时设置

func main() {
	_, _, errs := gorequest.New().
		Get("https://httpbin.org/delay/5"). // 这个端点会延迟5秒响应
		Timeout(2 * time.Second).          // 设置2秒超时
		End()
	
	if errs != nil {
		fmt.Println("请求超时:", errs) // 会返回超时错误
	}
}

7. 文件上传

func main() {
	_, body, errs := gorequest.New().
		Post("https://httpbin.org/post").
		Type("multipart").
		SendFile("./test.txt").
		End()
}

8. 重试机制

func main() {
	_, body, errs := gorequest.New().
		Get("https://unstable-api.example.com").
		Retry(3, 5 * time.Second, http.StatusBadRequest, http.StatusInternalServerError).
		End()
}

高级特性

1. 中间件支持

func main() {
	request := gorequest.New()
	
	// 添加前置中间件
	request = request.AppendMiddleware(func(r *gorequest.SuperAgent, next gorequest.Handler) gorequest.Handler {
		return func(r2 *gorequest.SuperAgent, h gorequest.Handler) (gorequest.Response, string, []error) {
			fmt.Println("请求前:", r2.Url)
			return next(r2, h)
		}
	})
	
	// 添加后置中间件
	request = request.AppendMiddleware(func(r *gorequest.SuperAgent, next gorequest.Handler) gorequest.Handler {
		return func(r2 *gorequest.SuperAgent, h gorequest.Handler) (gorequest.Response, string, []error) {
			res, body, errs := next(r2, h)
			fmt.Println("请求后, 状态码:", res.StatusCode)
			return res, body, errs
		}
	})
	
	request.Get("https://httpbin.org/get").End()
}

2. 代理设置

func main() {
	_, body, _ := gorequest.New().
		Proxy("http://proxy.example.com:8080").
		Get("https://httpbin.org/get").
		End()
}

3. 自定义HTTP客户端

func main() {
	client := &http.Client{
		Transport: &http.Transport{
			TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
		},
		Timeout: 10 * time.Second,
	}
	
	_, body, _ := gorequest.New().
		CustomClient(client).
		Get("https://httpbin.org/get").
		End()
}

错误处理

Request库返回的错误是一个[]error切片，因为可能有多个错误发生：

func main() {
	_, _, errs := gorequest.New().
		Get("https://nonexistent.example.com").
		End()
	
	if errs != nil {
		for _, err := range errs {
			fmt.Println("错误:", err)
		}
	}
}

总结

Request库相比标准库net/http提供了更加简洁易用的API，主要优点包括：

1. 链式调用，代码更简洁
2. 内置JSON处理
3. 支持文件上传
4. 提供重试机制
5. 支持中间件
6. 更友好的错误处理

对于简单的HTTP请求场景，Request库可以大大减少样板代码，提高开发效率。但对于需要高度定制化的HTTP客户端场景，可能还是需要使用标准库。

希望这些示例能帮助你快速上手Request库的使用！