maxrequest

介绍

轻量实用的golang请求库，不附带任何第三方库，完全使用标准库实现，让retry变得简单，让并发变得简单。

安装教程

go.mod文件加入以下代码，然后执行go mod tidy

github.com/huxinggg/maxrequest latest

发起GET请求

package main

import (
	"fmt"
	"gitee.com/justin0218/maxrequest"
)

type Result struct {
	Code int         `json:"code"`
	Data interface{} `json:"data"`
}

func main() {
	var ret Result
	url := "http://xxx.xx"
	resp, body, err := maxrequest.New().Get(url).Result(&ret)
	fmt.Println(resp.StatusCode)
	fmt.Println(string(body))
	fmt.Println(err)
	fmt.Printf("%+v\n", ret)
}

发起POST请求

package main

import (
	"fmt"
	"gitee.com/justin0218/maxrequest"
)

type Result struct {
	Code int         `json:"code"`
	Data interface{} `json:"data"`
}

type PostData struct {
	UserName string `json:"user_name"`
	Password string `json:"password"`
}

func main() {
	var req PostData
	req.UserName = "测试"
	req.Password = "xxsssss"
	var ret Result
	url := "http://xxx.xx"
	resp, body, err := maxrequest.New().Post(url, req).Result(&ret)
	fmt.Println(resp.StatusCode)
	fmt.Println(string(body))
	fmt.Println(err)
	fmt.Printf("%+v\n", ret)
}

form-data请求

只需要把"Post()"改成"PostForm()"

func main() {
	var req PostData
	req.UserName = "测试"
	req.Password = "xxsssss"
	var ret Result
	url := "http://xxx.xx"
	resp, body, err := maxrequest.New().SetTimeout(10).SetRetry(3,3, nil).PostForm(url, req).Result(&ret)
	fmt.Println(resp.StatusCode)
	fmt.Println(string(body))
	fmt.Println(err)
	fmt.Printf("%+v\n", ret)
}

设置超时

设置了10秒超时

resp, body, err := maxrequest.New().SetTimeout(10).Post(url, req).Result(&ret)

设置重试

SetRetry第一个参数为重试次数,第二个参数为重试周期，单位：秒

package main

    import (
	"fmt"
	"gitee.com/justin0218/maxrequest"
)

type Result struct {
	Code int         `json:"code" maxrequestRetry:"404"` //代表返回code=404时，将会进行重试，多个字段设置maxrequestRetry,其中一个满足就会进行重试
	Data interface{} `json:"data"`
}

type PostData struct {
	UserName string `json:"user_name"`
	Password string `json:"password"`
}

func main() {
	var req PostData
	req.UserName = "测试"
	req.Password = "xxsssss"
	var ret Result
	url := "http://xxx.xx"
	resp, body, err := maxrequest.New().SetTimeout(10).SetRetry(3, 3, func(retryNotice maxrequest.RetryNotice) bool {
		fmt.Printf("重试次数：%d", retryNotice.Num)
		return false //return true 可以随时终止重试
	}).Post(url, req).Result(&ret)
	fmt.Println(resp.StatusCode)
	fmt.Println(string(body))
	fmt.Println(err)
	fmt.Printf("%+v\n", ret)
}

并发请求

同时发起多个请求，一次性拿到所有结果

func main() {
	var req PostData
	req.UserName = "测试"
	req.Password = "xxsssss"
	url := "http://xxx.xx"
	r1 := maxrequest.New().SetTimeout(10).SetRetry(3, 3, nil).Post(url, req)
	r2 := maxrequest.New().SetTimeout(10).SetRetry(3, 3, nil).Post(url, req)
	r3 := maxrequest.New().SetTimeout(10).SetRetry(3, 3, nil).Post(url, req)
	r4 := maxrequest.New().SetTimeout(10).SetRetry(3, 3, nil).Post(url, req)
	r5 := maxrequest.New().SetTimeout(10).SetRetry(3, 3, nil).Post(url, req)
	results := maxrequest.Go(r1, r2, r3, r4, r5)
	fmt.Println("所有请求结果：%v", results)
}

注意

1. 只有在Result()方法内传入带有maxrequestRetry的tag才会触发重试机制；
2. Result()传入的结构体，只会解析json tag，如需解析其他数据类型，例如：xml，Result内请传入nil，然后自己根据返回的body自行解析；
3. 如需发送非json请求，例如xml，可把Post方法的第二个参数直接传入bytes；
4. 并发的结果和发送的请求顺序相同，雷同于JavaScript的Promise.all。