update

Author: richelieu042

go.mod

@@ -241,6 +241,7 @@ require (
 	github.com/go-ole/go-ole v1.2.6 // indirect
 	github.com/go-playground/locales v0.14.1 // indirect
 	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-resty/resty/v2 v2.17.2 // indirect
 	github.com/go-sql-driver/mysql v1.8.1 // indirect
 	github.com/go-stack/stack v1.8.1 // indirect
 	github.com/go-text/render v0.2.0 // indirect

go.sum

@@ -601,6 +601,8 @@ github.com/go-redis/redis/v8 v8.11.5 h1:AcZZR7igkdvfVmQTPnu9WE37LRrO/YrBH5zWyjDC
 github.com/go-redis/redis/v8 v8.11.5/go.mod h1:gREzHqY1hg6oD9ngVRbLStwAWKhA0FEgq8Jd4h5lpwo=
 github.com/go-redsync/redsync/v4 v4.16.0 h1:bNcOzeHH9d3s6pghU9NJFMPrQa41f5Nx3L4YKr3BdEU=
 github.com/go-redsync/redsync/v4 v4.16.0/go.mod h1:V4gagqgyASWBZuwx4xGzu72aZNb/6Mo05byUa3mVmKQ=
+github.com/go-resty/resty/v2 v2.17.2 h1:FQW5oHYcIlkCNrMD2lloGScxcHJ0gkjshV3qcQAyHQk=
+github.com/go-resty/resty/v2 v2.17.2/go.mod h1:kCKZ3wWmwJaNc7S29BRtUhJwy7iqmn+2mLtQrOyQlVA=
 github.com/go-sql-driver/mysql v1.8.1 h1:LedoTUt/eveggdHS9qUFC1EFSa8bU2+1pZjSRpvNJ1Y=
 github.com/go-sql-driver/mysql v1.8.1/go.mod h1:wEBSXgmK//2ZFJyE+qWnIsVGmvmEKlqwuVSjsCm7DZg=
 github.com/go-stack/stack v1.8.0/go.mod h1:v0f6uXyyMGvRgIKkXu+yp6POWl0qKG85gN/melR3HDY=

src/component/web/http_client/restyKit/_info.md

@@ -0,0 +1,3 @@
+## 注意点
+
+- 与标准库net/http（必须手动关闭）不同，Resty 内部已经帮你处理了连接复用和响应体的读取/关闭，不需要手动 resp.Body.Close()。

src/component/web/http_client/restyKit/client.go

@@ -0,0 +1,50 @@
+package restyKit
+
+import (
+	"sync"
+	"time"
+
+	"github.com/go-resty/resty/v2"
+)
+
+var (
+	defClient     *resty.Client
+	defClientOnce sync.Once
+)
+
+func getDefClient() *resty.Client {
+	defClientOnce.Do(func() {
+		/*
+			SetTimeout(10 * time.Second) — 整个请求的超时时间（含连接+读写），超过 10 秒直接报错
+			SetRetryCount(3) — 失败时最多重试 3 次（即总共最多发 4 次请求）
+			SetRetryWaitTime(500 * time.Millisecond) — 每次重试前的初始等待时间 500ms
+			SetRetryMaxWaitTime(time.Second) — 重试等待时间的上限是 1 秒，防止退避时间过长
+
+			resty 的重试等待时间用的是指数退避策略：
+				SetRetryWaitTime(500ms) — 第一次重试前等待的初始值
+				SetRetryMaxWaitTime(1s) — 等待时间的上限，再怎么退避也不会超过这个值
+
+			每次重试等待时间会翻倍增长，但不超过上限：
+				第1次重试：等 500ms
+				第2次重试：等 1000ms → 超过上限，截断为 1s
+				第3次重试：等 1s
+		*/
+		defClient = resty.New().SetTimeout(15 * time.Second).
+			SetRetryCount(3).
+			SetRetryWaitTime(300 * time.Millisecond).
+			SetRetryMaxWaitTime(time.Second)
+	})
+	return defClient
+}
+
+func Get(utl string, queryParams map[string]string) (int, string, error) {
+	client := getDefClient()
+
+	resp, err := client.R().
+		SetQueryParams(queryParams).
+		Get(utl)
+	if err != nil {
+		return 0, "", err
+	}
+	return resp.StatusCode(), string(resp.Body()), nil
+}