form

Documentation

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

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

1. 如果是 map 类型，要求键名类型必须为 string；
2. 如果是 array 或是 slice，则要求元素类型必须是 go 的基本数据类型，不能是 struct 类型；

接口

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

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

Index

• Constants
• func Marshal(v any) ([]byte, error)
• func Unmarshal(data []byte, v any) error
• type Marshaler
• type Unmarshaler

Constants

const Mimetype = "application/x-www-form-urlencoded"

const Tag = "form"

Tag 在 struct tag 中的标签名称

Functions

func Marshal

func Marshal(v any) ([]byte, error)

Marshal 针对 www-form-urlencoded 内容的解码实现

按以下顺序解析内容：

• 如果实现 Marshaler 接口，则调用该接口；
• 如果实现 encoding.TextMarshaler 接口，则调用该接口；
• 如果是 url.Values 对象，则调用其方法 Encode 解析；
• 否则将对象的字段与 form-data 中的数据进行对比，可以使用 form 指定字段名。

func Unmarshal

func Unmarshal(data []byte, v any) error

Unmarshal 针对 www-form-urlencoded 内容的编码实现

按以下顺序解析内容：

• 如果实现 Unmarshaler 接口，则调用该接口；
• 如果是 url.Values 对象，则依次赋值每个对象；
• 否则将对象的字段与 form-data 中的数据进行对比，可以使用 form 指定字段名。

Types

type Marshaler

type Marshaler interface {
	MarshalForm() ([]byte, error)
}

Marshaler 将一个普通对象转换成 form 类型

type Unmarshaler

type Unmarshaler interface {
	UnmarshalForm([]byte) error
}

Unmarshaler 将 form 类型转换成一个对象