Go语言中高效处理HTTP JSON响应：NewDecoder与超时客户端实践

// 常见的但非最优的模式
res, err := http.Get(url)
if err != nil {
    // 错误处理
}
defer res.Body.Close() // 确保关闭响应体

body, err := ioutil.ReadAll(res.Body) // 将整个响应体读入内存
if err != nil {
    // 错误处理
}

var data MyStruct
err = json.Unmarshal(body, &data) // 解析内存中的字节切片
if err != nil {
    // 错误处理
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "time"
)

// myClient 是一个配置了超时的HTTP客户端实例。
// 建议在生产环境中使用自定义的http.Client，而不是默认的http.DefaultClient，
// 因为默认客户端没有设置超时，可能导致请求无限期阻塞。
var myClient = &http.Client{Timeout: 10 * time.Second}

// getJson 函数从指定的URL获取JSON数据，并将其解码到目标结构体中。
// target 必须是一个指向结构体的指针。
func getJson(url string, target interface{}) error {
    r, err := myClient.Get(url)
    if err != nil {
        return fmt.Errorf("HTTP GET请求失败: %w", err)
    }
    defer r.Body.Close() // 确保在函数返回前关闭响应体，释放资源

    // 使用json.NewDecoder直接从响应体读取并解码JSON
    if r.StatusCode != http.StatusOK {
        return fmt.Errorf("HTTP请求失败，状态码: %d %s", r.StatusCode, r.Status)
    }
    return json.NewDecoder(r.Body).Decode(target)
}

// Tracks 结构体映射整个JSON响应的根对象
type Tracks struct {
    Toptracks struct { // "toptracks" 是一个对象
        Tracks []TrackInfo   `json:"track"` // "track" 是一个包含多个TrackInfo的数组
        Attr   ToptracksAttr `json:"@attr"` // "@attr" 是一个ToptracksAttr对象
    } `json:"toptracks"`
}

// TrackInfo 结构体映射单个歌曲的信息
type TrackInfo struct {
    Name       string         `json:"name"`
    Duration   string         `json:"duration"`
    Listeners  string         `json:"listeners"`
    Mbid       string         `json:"mbid"`
    Url        string         `json:"url"`
    Streamable StreamableInfo `json:"streamable"` // "streamable" 是一个StreamableInfo对象
    Artist     ArtistInfo     `json:"artist"`     // "artist" 是一个ArtistInfo对象
    Attr       TrackAttrInfo  `json:"@attr"`      // "@attr" 是一个TrackAttrInfo对象
}

// ToptracksAttr 结构体映射toptracks层级的@attr信息
type ToptracksAttr struct {
    Country    string `json:"country"`
    Page       string `json:"page"`
    PerPage    string `json:"perPage"`
    TotalPages string `json:"totalPages"`
    Total      string `json:"total"`
}

// StreamableInfo 结构体映射streamable信息
type StreamableInfo struct {
    Text      string `json:"#text"`      // 注意：JSON键 "#text" 需要特殊处理
    Fulltrack string `json:"fulltrack"`
}

// ArtistInfo 结构体映射艺术家信息
type ArtistInfo struct {
    Name string `json:"name"`
    Mbid string `json:"mbid"`
    Url  string `json:"url"`
}

// TrackAttrInfo 结构体映射歌曲层级的@attr信息
type TrackAttrInfo struct {
    Rank string `json:"rank"`
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
    "time"
)

// ... (myClient, getJson 函数以及所有Tracks, TrackInfo, ToptracksAttr, StreamableInfo, ArtistInfo, TrackAttrInfo 结构体定义) ...
// 上述代码块中的 myClient, getJson 函数和所有结构体定义应放置在此处。

func main() {
    // 替换为你的Last.fm API Key
    apiKey := "c1572082105bd40d247836b5c1819623" // 示例API Key，请替换为你的实际Key
    url := fmt.Sprintf("http://ws.audioscrobbler.com/2.0/?method=geo.gettoptracks&api_key=%s&format=json&country=Netherlands", apiKey)

    var data Tracks // 声明一个Tracks类型的变量来存储解析后的数据
    err := getJson(url, &data)
    if err != nil {
        fmt.Printf("获取或解析JSON失败: %v\n", err)
        os.Exit(1) // 错误时退出程序
    }

    fmt.Printf("成功获取并解析数据。荷兰热门歌曲数量: %d\n", len(data.Toptracks.Tracks))
    if len(data.Toptracks.Tracks) > 0 {
        fmt.Printf("第一首热门歌曲: %s - %s\n", data.Toptracks.Tracks[0].Artist.Name, data.Toptracks.Tracks[0].Name)
        fmt.Printf("国家: %s, 总页数: %s, 总条目数: %s\n", data.Toptracks.Attr.Country, data.Toptracks.Attr.TotalPages, data.Toptracks.Attr.Total)
    } else {
        fmt.Println("未找到热门歌曲。")
    }

    // 打印所有歌曲的名称和艺术家（可选）
    // for i, track := range data.Toptracks.Tracks {
    //  fmt.Printf("%d. %s - %s\n", i+1, track.Artist.Name, track.Name)
    // }
}