rockcookies/go-rc-fetch

go-fetch

基于 rockcookies/go-fetch — 零外部依赖的 Go HTTP 客户端库，生产代码仅依赖标准库 net/http。

安装

go get github.com/rockcookies/go-fetch

快速入门

GET 请求

import (
    "context"
    "log"

    fetch "github.com/rockcookies/go-fetch"
)

dispatcher := fetch.NewDispatcher(nil) // nil → 30s 超时默认客户端

ctx := context.Background()
resp := dispatcher.NewRequest().Get(ctx, "https://api.example.com/users/1")
defer resp.Close()

if resp.Error != nil {
    log.Fatal(resp.Error)
}

var user struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}
if err := resp.JSON(&user); err != nil {
    log.Fatal(err)
}

POST JSON 请求

ctx := context.Background()
payload := map[string]string{"name": "John", "email": "[email protected]"}

resp := dispatcher.NewRequest().JSON(payload).Post(ctx, "https://api.example.com/users")
defer resp.Close()

if resp.Error != nil {
    log.Fatal(resp.Error)
}

全局认证中间件

dispatcher := fetch.NewDispatcher(nil)
dispatcher.Use(func(next fetch.Handler) fetch.Handler {
    return fetch.HandlerFunc(func(client *http.Client, req *http.Request) (*http.Response, error) {
        req.Header.Set("Authorization", "Bearer "+token)
        return next.Handle(client, req)
    })
})

ctx := context.Background()
resp := dispatcher.NewRequest().Get(ctx, "https://api.example.com/profile")
defer resp.Close()

核心概念速览

| 概念 | 说明 | |------|------| | Dispatcher | 持有 *http.Client 与全局中间件，线程安全 | | Request | 累积 RequestFunc（PreFuncs/UseFuncs）与 Middleware（Pre/Use），在 Do 时先跑 formatter 再跑中间件 | | HTTP 方法 | Get/Post/… 第一个参数均为 context.Context | | Response | 永不为 nil；resp.Error 为传输/构造错误；4xx/5xx 需查状态码；始终 defer resp.Close()（详见 request.md） |

References

按需加载 references：仅当用户问题涉及该子主题时读取对应文件。

| 文件 | 内容 | |------|------| | request.md | Dispatcher、Request（RequestFunc/HTTP 方法/Clone/Do）、Response | | middleware.md | 中间件挂载与 compose、URL/Header/Cookie、自定义模式 | | body.md | 请求体编码（JSON/XML/Form/Multipart/BodyGet） | | dump.md | HTTP 交换日志（dump.New）、过滤器、分侧脱敏、SlogWriter |