Go语言：通过URL获取并解析JSON响应的实践指南

package main

import (
    "encoding/json" // 用于JSON编码和解码
    "fmt"           // 用于格式化输出
    "log"           // 用于错误日志记录
    "net/http"      // 用于HTTP客户端请求
)

func main() {
    // 定义要请求的URL
    url := "http://api.geonames.org/citiesJSON?north=44.1&south=-9.9&east=-22.4&west=55.2&lang=de&username=demo"

    // 发起HTTP GET请求
    resp, err := http.Get(url)
    if err != nil {
        // 如果请求过程中发生错误，例如网络不通，则记录错误并退出
        log.Fatalf("发起HTTP请求失败: %v", err)
    }
    // 确保在函数返回时关闭响应体，释放资源
    defer resp.Body.Close()

    // 检查HTTP响应状态码
    if resp.StatusCode != http.StatusOK {
        log.Fatalf("HTTP请求失败，状态码: %d %s", resp.StatusCode, resp.Status)
    }

    // ... 后续的JSON解码操作
}

// 承接上文的main函数

    // 创建一个map来存储解码后的JSON数据
    // map[string]interface{} 可以处理键为字符串，值为任意类型的基础JSON结构
    var generic map[string]interface{}

    // 使用json.NewDecoder从响应体中读取并解码JSON数据
    // resp.Body 是一个io.Reader，json.NewDecoder可以直接从它读取
    err = json.NewDecoder(resp.Body).Decode(&generic)
    if err != nil {
        // 如果JSON解码过程中发生错误，则记录错误并退出
        log.Fatalf("解码JSON响应失败: %v", err)
    }

    // 打印解码后的数据
    fmt.Println("解码后的JSON数据:")
    fmt.Println(generic)

    // 示例：访问解码后的数据
    // 注意：由于是interface{}类型，访问时需要进行类型断言
    if totalResults, ok := generic["totalResultsCount"].(float64); ok {
        fmt.Printf("总结果数: %.0f\n", totalResults)
    }
    // 进一步访问嵌套数据，例如访问`geonames`数组中的第一个元素
    if geonames, ok := generic["geonames"].([]interface{}); ok && len(geonames) > 0 {
        if firstCity, ok := geonames[0].(map[string]interface{}); ok {
            if name, ok := firstCity["name"].(string); ok {
                fmt.Printf("第一个城市名称: %s\n", name)
            }
        }
    }
}

// 假设API返回的JSON结构大致如下：
// {
//   "totalResultsCount": 123,
//   "geonames": [
//     {
//       "toponymName": "Berlin",
//       "name": "Berlin",
//       "lat": 52.52437,
//       "lng": 13.41053,
//       "geonameId": 2950159,
//       "countryCode": "DE",
//       "countryName": "Germany",
//       "fcl": "P",
//       "fcode": "PPLC"
//     },
//     ...
//   ]
// }

// 定义与JSON结构对应的Go struct
type GeonamesResponse struct {
    TotalResultsCount int `json:"totalResultsCount"`
    Geonames          []City `json:"geonames"`
}

type City struct {
    ToponymName string  `json:"toponymName"`
    Name        string  `json:"name"`
    Lat         float64 `json:"lat"`
    Lng         float64 `json:"lng"`
    GeonameID   int     `json:"geonameId"`
    CountryCode string  `json:"countryCode"`
    CountryName string  `json:"countryName"`
    FCL         string  `json:"fcl"`
    FCode       string  `json:"fcode"`
}

// 在main函数中替换map[string]interface{}的解码部分：
/*
func main() {
    url := "http://api.geonames.org/citiesJSON?north=44.1&south=-9.9&east=-22.4&west=55.2&lang=de&username=demo"
    resp, err := http.Get(url)
    if err != nil {
        log.Fatalf("发起HTTP请求失败: %v", err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        log.Fatalf("HTTP请求失败，状态码: %d %s", resp.StatusCode, resp.Status)
    }

    var data GeonamesResponse // 使用定义的struct
    err = json.NewDecoder(resp.Body).Decode(&data)
    if err != nil {
        log.Fatalf("解码JSON响应失败: %v", err)
    }

    fmt.Println("解码后的JSON数据 (使用struct):")
    fmt.Printf("总结果数: %d\n", data.TotalResultsCount)
    if len(data.Geonames) > 0 {
        fmt.Printf("第一个城市名称: %s (纬度: %.2f, 经度: %.2f)\n",
            data.Geonames[0].Name, data.Geonames[0].Lat, data.Geonames[0].Lng)
    }
}
*/