form

Overview ¶

Package form 用于处理 www-form-urlencoded 编码

func read(ctx *web.Context) {
    vals := urls.Values{}
    ctx.Read(vals)
}

func write(ctx *web.Context) {
    vals := urls.Values{}
    vals.Add("name", "caixw")
    return web.Object(http.StatusOK, vals, nil)
}

## form 标签

用户可以通过定义 form 标签自定义输出的名称，比如：

type Username struct {
    Name string `form:"name"`
    Age int
}

转换成 form-data 可能是以下样式：

name=jjj&age=18

该方式对数据类型有一定限制：

• 如果是 map 类型，要求键名类型必须为 string；
• 如果是 array 或是 slice，则要求元素类型必须是 go 的基本数据类型，不能是 struct 类型；
• 其它基本类型或是实现了 encoding.TextUnmarshaler 和 encoding.TextMarshaler 接口的类型；

接口 ¶

对于复杂类型，用户可以自定义实现 Marshaler 和 Unmarshaler 接口进行编解码， 其功能与用户与 encoding/json 中的 Marshaler 和 Unmarshaler 接口相似。

与标准库中 http.Request.ParseForm 的不同点： - 标准库支持从查询参数中获取数据； - 当前包支持非 ascii 编码； - 当前包支持将数据映射到一个对象；