为网站优势,做落地页的网站,软件开发合同模板免费,建设厅网站账户名忘了怎么查文章目录 Go 语言封装 HTTP 请求的 Curl 工具包#x1f3d7;️ 工具包结构简介核心结构体定义初始化函数 #x1f31f; 功能实现1. 设置请求头2. 构建请求3. 发送请求4. 发送 GET 请求5. 发送 POST 请求6. 发送 PUT 请求7. 发送 DELETE 请求8. 读取响应体 #x1f4a1; 实现… 文章目录 Go 语言封装 HTTP 请求的 Curl 工具包️ 工具包结构简介核心结构体定义初始化函数 功能实现1. 设置请求头2. 构建请求3. 发送请求4. 发送 GET 请求5. 发送 POST 请求6. 发送 PUT 请求7. 发送 DELETE 请求8. 读取响应体 实现思路 示例 总结 Go 语言封装 HTTP 请求的 Curl 工具包
在 Go 语言开发中与 HTTP 服务进行交互是非常常见的需求。本文将分享一个用 Go 语言封装的 Curl 工具包它提供了简洁易用的接口来进行 HTTP 请求包括 GET、POST、PUT 和 DELETE 等常见操作。通过这个工具包可以轻松管理 HTTP 请求头、查询参数和请求体并处理响应。 ️ 工具包结构简介
在这个 curl 工具包中主要定义了一个 Curl 结构体封装了 HTTP 客户端的常见操作。
核心结构体定义
type Curl struct {client *http.Client // http clientbaseURL string // base urlheaders map[string]string // headers
}client使用 http.Client 发送 HTTP 请求。baseURL基础 URL便于在请求时自动拼接路径。headers一个存储 HTTP 请求头的 map支持动态设置。
初始化函数
func NewCurl(baseURL string, timeout time.Duration) *Curl {return Curl{client: http.Client{Timeout: timeout,},baseURL: strings.TrimSuffix(baseURL, /),headers: make(map[string]string),}
}baseURL传入基础 URL。timeout设置超时时间。 功能实现
1. 设置请求头
SetHeader 用于设置 HTTP 请求头
func (c *Curl) SetHeader(key, value string) {c.headers[key] value
}可以通过如下方式动态设置请求头
curl.SetHeader(Content-Type, application/json)2. 构建请求
func (c *Curl) buildRequest(ctx context.Context, method, urlPath string, queryParams map[string]string, body io.Reader) (*http.Request, error) {// 处理完整的 URLfullURL : c.baseURL urlPathif queryParams ! nil {query : url.Values{}for key, value : range queryParams {query.Add(key, value)}fullURL ? query.Encode()}// 创建请求req, err : http.NewRequestWithContext(ctx, method, fullURL, body)if err ! nil {return nil, err}// 设置请求头for key, value : range c.headers {req.Header.Set(key, value)}return req, nil
}3. 发送请求
func (c *Curl) doRequest(req *http.Request) (*http.Response, error) {resp, err : c.client.Do(req)if err ! nil {return nil, err}return resp, nil
}4. 发送 GET 请求
Get 方法通过 HTTP GET 请求获取资源
func (c *Curl) Get(ctx context.Context, urlPath string, queryParams map[string]string) (*http.Response, error) {req, err : c.buildRequest(ctx, http.MethodGet, urlPath, queryParams, nil)if err ! nil {return nil, err}return c.doRequest(req)
}示例
response, err : curl.Get(context.TODO(), /user, map[string]string{id: 123})5. 发送 POST 请求
Post 方法通过 HTTP POST 请求提交数据
func (c *Curl) Post(ctx context.Context, urlPath string, body []byte) (*http.Response, error) {req, err : c.buildRequest(ctx, http.MethodPost, urlPath, nil, bytes.NewBuffer(body))if err ! nil {return nil, err}return c.doRequest(req)
}示例
data : []byte({name:Alice})
response, err : curl.Post(context.TODO(), /user, data)6. 发送 PUT 请求
Put 方法通过 HTTP PUT 请求更新资源
func (c *Curl) Put(ctx context.Context, urlPath string, body []byte) (*http.Response, error) {req, err : c.buildRequest(ctx, http.MethodPut, urlPath, nil, bytes.NewBuffer(body))if err ! nil {return nil, err}return c.doRequest(req)
}示例
data : []byte({age:30})
response, err : curl.Put(context.TODO(), /user, data)7. 发送 DELETE 请求
Delete 方法通过 HTTP DELETE 请求删除资源
func (c *Curl) Delete(ctx context.Context, urlPath string) (*http.Response, error) {req, err : c.buildRequest(ctx, http.MethodDelete, urlPath, nil, nil)if err ! nil {return nil, err}return c.doRequest(req)
}示例
response, err : curl.Delete(context.TODO(), /user)8. 读取响应体
ReadResponseBody 读取 HTTP 响应体并返回字节数组
func ReadResponseBody(resp *http.Response) ([]byte, error) {defer func(Body io.ReadCloser) {err : Body.Close()if err ! nil {fmt.Printf(close response body failed: %v\n, err)}}(resp.Body)return io.ReadAll(resp.Body)
}示例
body, err : ReadResponseBody(response)
if err ! nil {fmt.Println(Read response body error:, err)
} else {fmt.Println(Response body:, string(body))
}实现思路
使用 http.NewRequestWithContext 构建 HTTP 请求对象。通过 client.Do(req) 发送请求。动态设置请求头支持不同的 Content-Type。处理查询参数方便 GET 请求传参。读取响应体处理服务器返回的数据。 示例
完整示例
curl : NewCurl(https://example.com, 10*time.Second)
curl.SetHeader(Authorization, Bearer token)
resp, err : curl.Get(context.TODO(), /api/resource, map[string]string{key: value})
if err ! nil {log.Fatalf(Failed to send GET request: %v, err)
}body, err : ReadResponseBody(resp)
if err ! nil {log.Fatalf(Failed to read response: %v, err)
}fmt.Println(Response:, string(body))总结
通过封装 Curl 结构体简化了 Go 语言中与 HTTP 服务的交互过程提供了灵活的配置和扩展能力。通过这种封装可以快速集成 HTTP 请求减少模板代码的编写提升开发效率。
