Go 语言中的方法集与深度 JSON 路径访问实践

package main

import "fmt"

// MyString 是基于 string 的自定义类型
type MyString string

// ToUpperMethod 是 MyString 类型的一个方法，将其转换为大写
func (s MyString) ToUpperMethod() MyString {
    return MyString(fmt.Sprintf("%S", s)) // 简单示例，实际应使用 strings.ToUpper
}

func main() {
    var greeting MyString = "hello go"
    // 调用自定义类型的方法
    upperGreeting := greeting.ToUpperMethod()
    fmt.Printf("原始字符串: %s, 大写: %s\n", greeting, upperGreeting)

    // 注意：不能直接对内置的 string 类型调用此方法
    // var plainString string = "hello go"
    // plainString.ToUpperMethod() // 这将导致编译错误
}

package main

import (
    "encoding/json"
    "fmt"
    "strings"
)

// JSONAccessor 是一个自定义类型，用于封装 map[string]interface{}
type JSONAccessor map[string]interface{}

// GetByPath 方法允许通过点分隔的路径访问嵌套字段
// path 示例: "data.issued", "address.line1", "tickets.0.seq" (如果处理数组)
func (ja JSONAccessor) GetByPath(path string) (interface{}, bool) {
    parts := strings.Split(path, ".")
    var current interface{} = ja // 当前遍历到的数据

    for _, part := range parts {
        if m, ok := current.(map[string]interface{}); ok {
            // 如果当前是 map，尝试通过 key 访问
            if val, found := m[part]; found {
                current = val
            } else {
                // 路径中的某个部分未找到
                return nil, false
            }
        } else if arr, ok := current.([]interface{}); ok {
            // 如果当前是数组，尝试解析索引
            index, err := parseArrayIndex(part)
            if err != nil || index < 0 || index >= len(arr) {
                return nil, false // 无法解析索引或索引越界
            }
            current = arr[index]
        } else {
            // 当前数据既不是 map 也不是数组，无法继续遍历
            return nil, false
        }
    }
    return current, true
}

// parseArrayIndex 辅助函数，用于解析数组索引
func parseArrayIndex(part string) (int, error) {
    // 简单实现，只支持纯数字索引
    // 更健壮的实现需要处理 "tickets[0]" 这样的格式
    var index int
    _, err := fmt.Sscanf(part, "%d", &index)
    return index, err
}

func main() {
    jsonStr := `{
        "_id" : 2001,
        "address" : {
            "line1" : "123 Main St",
            "line2" : "Apt 4B",
            "line3" : ""
        },
        "tickets" : [ 
            {
                "seq" : 2,
                "add" : [
                    { "seq" : "A", "amnt" : 50 },
                    { "seq" : "B", "amnt" : 60 }
                ]
            },
            {
                "seq" : 3,
                "add" : [
                    { "seq" : "C", "amnt" : 70 }
                ]
            }
        ],
        "data": {
            "issued": "2023-10-26"
        }
    }`

    var rawMap map[string]interface{}
    err := json.Unmarshal([]byte(jsonStr), &rawMap)
    if err != nil {
        fmt.Println("JSON 解析错误:", err)
        return
    }

    // 将解析后的 map 转换为我们的自定义类型
    accessor := JSONAccessor(rawMap)

    // 访问深度嵌套字段
    if issuedDate, ok := accessor.GetByPath("data.issued"); ok {
        fmt.Printf("Data Issued: %v (类型: %T)\n", issuedDate, issuedDate)
    } else {
        fmt.Println("无法获取 data.issued")
    }

    if line1, ok := accessor.GetByPath("address.line1"); ok {
        fmt.Printf("Address Line1: %v (类型: %T)\n", line1, line1)
    } else {
        fmt.Println("无法获取 address.line1")
    }

    // 访问数组中的元素 (假设路径直接给出索引)
    if ticketSeq, ok := accessor.GetByPath("tickets.0.seq"); ok {
        fmt.Printf("First Ticket Sequence: %v (类型: %T)\n", ticketSeq, ticketSeq)
    } else {
        fmt.Println("无法获取 tickets.0.seq")
    }

    // 尝试访问不存在的路径
    if nonExistent, ok := accessor.GetByPath("non.existent.path"); !ok {
        fmt.Println("尝试获取 non.existent.path: 路径不存在 (符合预期)")
    }

    // 尝试访问类型不匹配的路径
    if invalidAccess, ok := accessor.GetByPath("address.line1.subfield"); !ok {
        fmt.Println("尝试获取 address.line1.subfield: 路径类型不匹配 (符合预期)")
    }
}