Go语言中HTTP表单数据到结构体的通用映射

m := map[string][]string {
    "Age": []string{"20"},
    "Name": []string{"John Smith"},
    "IsActive": []string{"true"},
    "Interests": []string{"coding", "reading"},
}

type Person struct {
    Age       int
    Name      string
    IsActive  bool
    Interests []string
}

go get github.com/gorilla/schema

package main

import (
    "fmt"
    "net/url" // url.Values 是 map[string][]string 的别名
    "time"

    "github.com/gorilla/schema"
)

// Person 定义了一个包含多种数据类型的结构体
type Person struct {
    Name      string    `schema:"name"` // 使用schema标签自定义字段名
    Age       int       `schema:"age"`
    IsActive  bool      `schema:"active"`
    Interests []string  `schema:"interests"`
    CreatedAt time.Time `schema:"created_at"` // 支持time.Time类型
    Address   Address   `schema:"address"`    // 嵌套结构体
}

// Address 定义了一个嵌套结构体
type Address struct {
    Street string `schema:"street"`
    City   string `schema:"city"`
    Zip    string `schema:"zip"`
}

func main() {
    // 模拟HTTP表单数据，通常来自r.ParseForm()后的r.Form
    formData := url.Values{}
    formData.Add("name", "Alice")
    formData.Add("age", "30")
    formData.Add("active", "true")
    formData.Add("interests", "coding")
    formData.Add("interests", "hiking")
    formData.Add("created_at", "2023-10-27T10:00:00Z") // ISO 8601 格式
    formData.Add("address.street", "123 Main St")       // 嵌套结构体字段
    formData.Add("address.city", "Anytown")
    formData.Add("address.zip", "12345")
    formData.Add("unknown_field", "some_value") // 不存在的字段会被忽略

    // 创建一个schema解码器
    // NewDecoder() 返回一个默认配置的解码器
    // 如果需要自定义行为（如忽略未知字段），可以使用NewEncoder().IgnoreUnknownKeys(true)
    decoder := schema.NewDecoder()

    // 允许解码器将空字符串视为零值（例如，空字符串解析为0而不是错误）
    // 这对于某些场景可能有用，但请根据实际需求决定是否启用
    decoder.IgnoreUnknownKeys(true) // 忽略formData中存在但结构体中不存在的字段

    // 目标结构体实例
    var person Person

    // 将表单数据解码到结构体中
    err := decoder.Decode(&person, formData)
    if err != nil {
        fmt.Printf("解码失败: %v\n", err)
        return
    }

    fmt.Println("解码成功！")
    fmt.Printf("姓名: %s\n", person.Name)
    fmt.Printf("年龄: %d\n", person.Age)
    fmt.Printf("活跃状态: %t\n", person.IsActive)
    fmt.Printf("兴趣: %v\n", person.Interests)
    fmt.Printf("创建时间: %s\n", person.CreatedAt.Format(time.RFC3339))
    fmt.Printf("地址: %s, %s, %s\n", person.Address.Street, person.Address.City, person.Address.Zip)

    // 验证未提供的字段（例如，如果表单中没有"age"字段，age会是0）
    // formDataWithoutAge := url.Values{}
    // formDataWithoutAge.Add("name", "Bob")
    // var p2 Person
    // decoder.Decode(&p2, formDataWithoutAge)
    // fmt.Printf("\n无年龄字段的Person: %+v\n", p2)
}