Go语言中最便捷的http请求包resty的使用详解

2025-03-18 01:50

本文主要是介绍Go语言中最便捷的http请求包resty的使用详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《Go语言中最便捷的http请求包resty的使用详解》go语言虽然自身就有net/http包,但是说实话用起来没那么好用,resty包是go语言中一个非常受欢迎的http请求处理包,下面我们一起来学...

go语言虽然自身就有net/http包,但是说实话用起来没那么好用。resjsty包是go语言中一个非常受欢迎的http请求处理包,它的api非常简洁、属于一看就懂的那种、对新手非常有友好。它支持链式调用、支持超时、重试机制,还支持中间件,可以在请求发送前,发送后做些操作,使用起来非常舒服。 今天我们一起来看下吧。

安装

先来安装下go get github.com/go-resty/resty/v2

一、一个简单的get

发一个get请求试试呢?

package main

import (
	"fmt"

	"github.com/go-resty/resty/v2"
)

func main() {
	client := resty.New()

	resp, err := client.R().
		Get("https://www.baidu.com")

	if err != nil {
		fmt.Println("请求出错:", err)
		return
	}

	fmt.Println("状态码:", resp.StatusCode())
	fmt.Println("响应体:", resp.String())
	fmt.Println("响应头:", resp.Header())                       // 获取全部header
	fmt.Println("特定响应头:", resp.Header().Get("Content-Type")) // 获取特定的header
	// 状态码: 200
	// 响应体: xxx太多了省略掉...
	// 响应头: map[Accept-Ranges:[bytes] Cache-Control:[no-cache] Connection:[keep-alive] Content-Length:[227] Content-Security-Policy:[frame-ancestors 'self' https://chat.baidu.com http://mirror-chat.baidu.com hwww.chinasem.cnttps://fj-chat.baidu.com https://hba-chat.baidu.com https://hbe-chat.baidu.com https://njjs-chat.baidu.com https://nj-chat.baidu.com https://hna-chat.baidu.com https://hnb-chat.baidu.com http://debug.baidu-int.com;] Content-Type:[text/html] Date:[Sun, 16 Mar 2025 09:43:18 GMT] P3p:[CP=" OTI DSP COR IVA OUR IND COM " CP=" OTI DSP COR IVA OUR IND COM "] Pragma:[no-cache] Server:[BWS/1.1] Set-Cookie:[BD_NOT_HTTPS=1; path=/; Max-Age=300 BIDUPSID=10846246655E82CCF356A792677D7EA8; expires=Thu, 31-Dec-37 23:55:55 GMT; max-age=2147483647; path=/; domain=.baidu.com PSTM=1742118198; expires=Thu, 31-Dec-37 23:55:55 GMT; max-age=2147483647; path=/; domain=.baidu.com BAIDUID=10846246655E82CC89D4B0052594BBBE:FG=1; max-age=31536000; expires=Mon, 16-Mar-26 09:43:18 GMT; domain=.baidu.com; path=/; version=1; comment=bd] Traceid:[1742118198045022490612843349543995319034] X-Ua-Compatible:[IE=Edge,chrome=1] X-Xss-Protection:[1;mode=block]]
	// 特定响应头: text/html
}

使用起来非常简单,它支持链式调用,唯一需要注意的是**请求方式 + 路径要放在最后——它返回响应**。

二、带查询参数

resp, err := client.R().
	SetQueryParam("postId", "1"). // 设置单个查询参数 也是可以的
	Get("https://jsonplaceholder.typicode.com/posts")

// resp, err := client.R().
// 	SetQueryParams(map[string]string{ // 设置多个查询参数
// 		"postId": "1",
// 	}).
// 	Get("https://jsonplaceholder.typicode.com/posts")

它支持一次设置多个查询参数SetQueryParams、和单个查询参数SetQueryParam两种方式方式。

三、设置请求头、body

由于支持链式调用,设置请求头也很方便

	resp, err := client.R().
		SetHeader("Content-Type", "application/json"). // 设置单个请求头
		SetBody(`{"title": "foo", "body": "bar", "userId": 1}`). // 字符串形式
		Post("https://jsonplaceholder.typicode.com/posts")

	resp, err := client.R().
		SetBody(map[string]interface{}{ // 支持 map结构
			"title":  "foo",
			"body":   "bar",
			"userId": 1,
		}).
		SetHeaders(map[string]s编程tring{  // 设置多个请求头
			"Content-Type": "application/json",
		}).
		Post("https://jsonplaceholder.typicode.com/posts")

	resp, err := client.R().
		SetBody(Post{Title: "foo", Body: "bar", UserId: 1}). // 支持struct
		SetHeaders(map[string]string{
			"Content-Type": "application/json",
		}).
		Post("https://jsonplaceholder.typicode.com/posts")

	// 从文件创建 io.Reader
	file, err := os.Open("my_file.txt")
	if err != nil {
			// ... 错误处理 ...
	}
	defer file.Close()
	resp, err := client.R().
			// 不设置也可以, resty会根据reader自动推断content-type
			SetHeader("Content-Type", "application/octet-stream"). // 或者根据文件类型设置
			SetBody(file). // 支持 io.Reader方式
			Post("https://example.com/upload")
  • SetBody 支持方式非常丰富json字符串mapstruct[]byteio.Reader
  • 设置请求头和前面的设置查询参数类似,同时支持单个、多个复数s两种方式。

四、设置表单数据

resp, err := client.R().
		SetFormData(map[string]string{"title": "foo", "body": "bar", "userId": "1"}).
		Post("https://jsonplaceholder.typicode.com/posts")

需要注意SetFormData参数只支持map[string]string类型。

五、处理响应

// 请求
	type postReq struct {
		Title  string `json:"title"`
		Body   string `json:"body"`
		UserId int    `json:"userId"`
	}

	// 响应
	type postRes structphp {
		ID     int    `json:"id"`
		Title  string `json:"title"`
		Body   string `json:"body"`
		UserId int    `json:"userId"`
	}

	var pr postRes

	resp, err := client.R().
		SetHeader("Content-Type", "application/json").
		SetBody(postpythonReq{Title: "foo", Body: "bar", UserId: 1}).
		SetResult(&pr). // 设置响应后内容
		Post("https://jsonplaceholder.typicode.com/posts")

	if err != nil {
		fmt.Println("请求出错:", err)
		return
	}

	fmt.Println("请求成功了么?", resp.IsSuccess()) // 是否响应成了
	fmt.Printf("响应结果:%#v\n", pr)
	// 请求成功了么? true
	// 响应结果:main.postRes{ID:101, Title:"foo", Body:"bar", UserId:1}
  • IsSuccess判断 响应是否成
  • SetResult支持把响应结果映射到结构体中

六、超时与重试

	client := resty.New().
		SetTimeout(5 * time.Second).          // 设置超时时间
		SetRetryCount(3).                     // 设置重试次数为 3
		SetRetryWaitTime(1 * time.Second).    // 设置重试间隔为 1 秒
		SetRetryMaxWaitTime(5 * time.Second). //最大重试间隔
		AddRetryCondition(
			func(r *resty.Response, err error) bool {
				return r.StatusCode() == http.StatusTooManyRequests // 429 错误时重试
			},
		)

	resp, err := client.R().
		SetHeader("Content-Type", "application/json").
		SetBody(postReq{Title: "foo", Body: "bar", UserId: 1}).
		SetResult(&pr).
		Post("https://jsonplaceholder.typicode.com/posts")

需要之一的是resty.New() 和 下面的 client.R()是不同的类,前者主要用于设置全局性相关的设置(比如:超时、重试等); 后者主要用于请求的发送相关设置;

七、调试模式

resp, err := client.R().
		SetHeader("Content-Type", "application/json").
		SetBody(postReq{Title: "foo", Body: "bar", UserId: 1}).
		SetResult(&pr).
		SetDebug(true). // 开启调试模式
		Post("https://jsonplaceholder.typicode.com/posts")

调试模式开启,请求的所有参数、和响应内容都可以看到。

八、中间件

client := resty.New()

// 请求中间件
client.OnBeforeRequest(func(c *resty.Client, req *resty.Request) error {
	fmt.Println("发送请求前:", req.URL)
	// 可以修改请求, 比如 req.SetHeader("New-Header", "value")
	return nil
})

// 响应中间件
client.OnAfterResponse(func(c *resty.Client, resp *resty.Response) error {
	fmt.Println("收到响应后:", resp.Status())
	return nil
})

resp, err := client.R().
	SetHeader("Content-Type", "application/json").
	SetBody(postReq{Title: "foo", Body: "bar", UserId: 1}).
	SetResult(&pr).
	Post("https://jsonplaceholder.typicode.com/posts")

它也支持中间件,在发送请求前、请求后做些处理。

到此这篇关于Go语言中最便捷的http请求包resty的使用详解的文章就介绍到这了,更多相关Go resty使用内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于Go语言中最便捷的http请求包resty的使用详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1153797

相关文章

Python中的魔术方法__new__详解

《Python中的魔术方法__new__详解》:本文主要介绍Python中的魔术方法__new__的使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、核心意义与机制1.1 构造过程原理1.2 与 __init__ 对比二、核心功能解析2.1 核心能力2.2

在PyCharm中安装PyTorch、torchvision和OpenCV详解

《在PyCharm中安装PyTorch、torchvision和OpenCV详解》:本文主要介绍在PyCharm中安装PyTorch、torchvision和OpenCV方式,具有很好的参考价值,... 目录PyCharm安装PyTorch、torchvision和OpenCV安装python安装PyTor

Python虚拟环境终极(含PyCharm的使用教程)

《Python虚拟环境终极(含PyCharm的使用教程)》:本文主要介绍Python虚拟环境终极(含PyCharm的使用教程),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录一、为什么需要虚拟环境?二、虚拟环境创建方式对比三、命令行创建虚拟环境(venv)3.1 基础命令3

Python Transformer 库安装配置及使用方法

《PythonTransformer库安装配置及使用方法》HuggingFaceTransformers是自然语言处理(NLP)领域最流行的开源库之一,支持基于Transformer架构的预训练模... 目录python 中的 Transformer 库及使用方法一、库的概述二、安装与配置三、基础使用:Pi

关于pandas的read_csv方法使用解读

《关于pandas的read_csv方法使用解读》:本文主要介绍关于pandas的read_csv方法使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录pandas的read_csv方法解读read_csv中的参数基本参数通用解析参数空值处理相关参数时间处理相关

使用Node.js制作图片上传服务的详细教程

《使用Node.js制作图片上传服务的详细教程》在现代Web应用开发中,图片上传是一项常见且重要的功能,借助Node.js强大的生态系统,我们可以轻松搭建高效的图片上传服务,本文将深入探讨如何使用No... 目录准备工作搭建 Express 服务器配置 multer 进行图片上传处理图片上传请求完整代码示例

SpringBoot条件注解核心作用与使用场景详解

《SpringBoot条件注解核心作用与使用场景详解》SpringBoot的条件注解为开发者提供了强大的动态配置能力,理解其原理和适用场景是构建灵活、可扩展应用的关键,本文将系统梳理所有常用的条件注... 目录引言一、条件注解的核心机制二、SpringBoot内置条件注解详解1、@ConditionalOn

Python中使用正则表达式精准匹配IP地址的案例

《Python中使用正则表达式精准匹配IP地址的案例》Python的正则表达式(re模块)是完成这个任务的利器,但你知道怎么写才能准确匹配各种合法的IP地址吗,今天我们就来详细探讨这个问题,感兴趣的朋... 目录为什么需要IP正则表达式?IP地址的基本结构基础正则表达式写法精确匹配0-255的数字验证IP地

使用Python实现全能手机虚拟键盘的示例代码

《使用Python实现全能手机虚拟键盘的示例代码》在数字化办公时代,你是否遇到过这样的场景:会议室投影电脑突然键盘失灵、躺在沙发上想远程控制书房电脑、或者需要给长辈远程协助操作?今天我要分享的Pyth... 目录一、项目概述:不止于键盘的远程控制方案1.1 创新价值1.2 技术栈全景二、需求实现步骤一、需求

Spring LDAP目录服务的使用示例

《SpringLDAP目录服务的使用示例》本文主要介绍了SpringLDAP目录服务的使用示例... 目录引言一、Spring LDAP基础二、LdapTemplate详解三、LDAP对象映射四、基本LDAP操作4.1 查询操作4.2 添加操作4.3 修改操作4.4 删除操作五、认证与授权六、高级特性与最佳