在 Go 中维护未解析的 JSON 字段的最佳实践

{
  "name": "Joe Smith",
  "age": 42,
  "phone": "614-555-1212",
  "debug": true,
  "codeword": "wolf"
}

package main

import (
    "encoding/json"
    "fmt"
)

type Person struct {
    Name    string          `json:"name"`
    Age     uint            `json:"age"`
    Address json.RawMessage `json:"address"` // 包含 "phone", "debug", "codeword" 等字段
}

func main() {
    jsonData := []byte(`{ "name": "Joe Smith", "age": 42, "address": { "phone": "614-555-1212", "debug": true, "codeword": "wolf" } }`)

    var p Person
    err := json.Unmarshal(jsonData, &p)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }

    fmt.Printf("Name: %s\n", p.Name)
    fmt.Printf("Age: %d\n", p.Age)
    fmt.Printf("Address (Raw): %s\n", string(p.Address)) // 输出原始 JSON 片段

    // 修改 Age
    p.Age++

    // 重新编码为 JSON
    newData, err := json.Marshal(p)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }

    fmt.Printf("New JSON: %s\n", string(newData))
}

package main

import (
    "encoding/json"
    "fmt"
)

type Person struct {
    Name    string                 `json:"name"`
    Age     uint                   `json:"age"`
    Extra   map[string]interface{} `json:"-"` // 忽略，用于存储未解析的字段
}

// UnmarshalJSON 自定义解码逻辑
func (p *Person) UnmarshalJSON(data []byte) error {
    // 定义一个中间类型，避免无限递归
    type Alias Person
    aux := &struct {
        *Alias
    }{
        Alias: (*Alias)(p),
    }

    // 先将 JSON 数据解码到 map[string]interface{} 中
    var tmp map[string]interface{}
    if err := json.Unmarshal(data, &tmp); err != nil {
        return err
    }

    // 将需要处理的字段提取到结构体中
    if name, ok := tmp["name"].(string); ok {
        p.Name = name
        delete(tmp, "name")
    }
    if age, ok := tmp["age"].(float64); ok { // 注意：JSON 中数字默认是 float64
        p.Age = uint(age)
        delete(tmp, "age")
    }

    // 将剩余的字段存储到 Extra 中
    p.Extra = tmp
    return nil
}

// MarshalJSON 自定义编码逻辑
func (p *Person) MarshalJSON() ([]byte, error) {
    // 创建一个新的 map，包含结构体中的字段和 Extra 中的字段
    tmp := make(map[string]interface{})
    tmp["name"] = p.Name
    tmp["age"] = p.Age
    for k, v := range p.Extra {
        tmp[k] = v
    }

    // 将 map 编码为 JSON 数据
    return json.Marshal(tmp)
}

func main() {
    jsonData := []byte(`{ "name": "Joe Smith", "age": 42, "phone": "614-555-1212", "debug": true, "codeword": "wolf" }`)

    var p Person
    err := json.Unmarshal(jsonData, &p)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }

    fmt.Printf("Name: %s\n", p.Name)
    fmt.Printf("Age: %d\n", p.Age)
    fmt.Printf("Extra: %+v\n", p.Extra)

    // 修改 Age
    p.Age++

    // 添加新的字段
    p.Extra["new_field"] = "new_value"

    // 重新编码为 JSON
    newData, err := json.Marshal(p)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }

    fmt.Printf("New JSON: %s\n", string(newData))
}