Go 函数与外部 API 交互的最佳实践

在 Go 中，与外部 API 交互是应用程序开发中的一个常见任务。为了编写可靠且高效的代码，遵循一些最佳实践非常重要。

使用 HTTP 客户端

Go 提供了 net/http 包，用于处理 HTTP 请求和响应。要创建 HTTP 客户端，请使用 http.Client 类型：

import "net/http"

// 创建一个 HTTP 客户端
client := &http.Client{
    Timeout: 10 * time.Second,
}

设置超时

为 HTTP 请求设置超时至关重要，以防止程序挂起：

client := &http.Client{
    Timeout: 10 * time.Second,
}

处理错误

当与外部 API 交互时，处理错误至关重要：

立即学习“go语言免费学习笔记（深入）”；

resp, err := client.Get("https://example.com/api")
if err != nil {
    return err
}

使用重试

在某些情况下，API 可能由于临时网络错误而返回错误。重试机制可以提高应用程序的容错性：

// 重试次数
retries := 3

for i := 0; i < retries; i++ {
    resp, err := client.Get("https://example.com/api")
    if err == nil {
        break
    }
}

使用缓存

对于频繁访问的 API，缓存响应可以提高性能。可以使用 http.Client 的 Transport 字段设置缓存：

transport := &http.Transport{
    MaxIdleConnsPerHost: 10,
    ResponseCache:       &http.Cache{},
}

client := &http.Client{
    Transport: transport,
}

使用 JSON 编解码器

encoding/json 包提供了用于编解码 JSON 数据的函数：

type User struct {
    ID   int
    Name string
}

// 将 User 对象编码为 JSON
jsonBytes, err := json.Marshal(user)
if err != nil {
    return err
}

// 将 JSON 数据解码为 User 对象
err = json.Unmarshal(jsonBytes, &user)
if err != nil {
    return err
}

实战案例

考虑一个向 gitHub API 发送请求的示例：

import "net/http"

// 发送请求并获取响应
resp, err := http.Get("https://api.github.com/users/octocat")
if err != nil {
    return err
}

// 读取响应体
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
    return err
}

// 将响应体解析为 JSON
var user struct {
    Login string
    Name  string
}
if err := json.Unmarshal(body, &user); err != nil {
    return err
}

// 打印用户名
fmt.Printf("用户名：%s\n", user.Login)

以上就是Golang 函数与外部 API 交互中的最佳实践的详细内容，更多请关注中国大学网其它相关文章！