输入处理

总体来说，处理输入主要依赖于 Controller 提供的方法。而具体输入可以来源于：

• 路径参数：这一部分主要是指参数路由
• 查询参数
• 请求体：要想从请求体里面读取数据，大多数时候将BConfig.CopyRequestBody 设置为true就足够了。而如果你是创建了多个 web.Server，那么必须每一个Server实例里面的配置都将CopyRequestBody设置为true了

而获取参数的方法可以分成两大类：

• 第一类是以 Get 为前缀的方法：这一大类的方法，主要获得某个特定参数的值
• 第二类是以 Bind 为前缀的方法：这一大类的方法，试图将输入转化为结构体

Get 类方法

针对这一类方法，Beego 主要从两个地方读取：查询参数和表单，如果两个地方都有相同名字的参数，那么 Beego 会返回表单里面的数据。例如最简单的例子：

type MainController struct {
	web.Controller
}

func (ctrl *MainController) Post() {
	name := ctrl.GetString("name")
	if name == "" {
		ctrl.Ctx.WriteString("Hello World")
		return
	}
	ctrl.Ctx.WriteString("Hello " + name)
}

当我们访问：

• 路径 localhost:8080?name=a: 这是使用查询参数的形式，那么会输出 Hello, a
• 路径 localhost:8080，而后表单里面提交了name=b，那么会输出b
• 路径 localhost:8080?name=a，并且表单提交了name=b，那么会输出b

这一类的方法也允许传入默认值，例如：

func (ctrl *MainController) Get() {
	name := ctrl.GetString("name", "Tom")
	ctrl.Ctx.WriteString("Hello " + name)
}

如果我们没有传入name参数，那么就会使用Tom作为name的值，例如我们访问GET localhost:8080的时候，就会输出 Hello Tom。

需要注意的是，GetString的方法签名是：

func (c *Controller) GetString(key string, def ...string) string {
    // ...
}

要注意的是，虽然def被声明为不定参数，但是实际上，Beego 只会使用第一个默认值，后面的都会被忽略。

这一类方法签名和行为都是类似的，它们有：

• GetString(key string, def ...string) string
• GetStrings(key string, def ...[]string) []string
• GetInt(key string, def ...int) (int, error)
• GetInt8(key string, def ...int8) (int8, error)
• GetUint8(key string, def ...uint8) (uint8, error)
• GetInt16(key string, def ...int16) (int16, error)
• GetUint16(key string, def ...uint16) (uint16, error)
• GetInt32(key string, def ...int32) (int32, error)
• GetUint32(key string, def ...uint32) (uint32, error)
• GetInt64(key string, def ...int64) (int64, error)
• GetUint64(key string, def ...uint64) (uint64, error)
• GetBool(key string, def ...bool) (bool, error)
• GetFloat(key string, def ...float64) (float64, error)

这里要注意到，GetString 和 GetStrings 本身在设计的时候并没有设计返回 error，所以无法拿到错误。

Bind 类方法

大多数时候，我们还需要把输入转换为结构体，Beego 提供了一系列的方法来完成输入到结构体的绑定。

这部分方法是直接定义在 Context 结构体上的，所以用户可以直接操作 Context 实例。为了简化操作，我们在Controller上也定义了类似的方法。

例如：

// 要设置 web.BConfig.CopyRequestBody = true

type MainController struct {
	web.Controller
}

func (ctrl *MainController) Post() {
	user := User{}
	err := ctrl.BindJSON(&user)
	if err != nil {
		ctrl.Ctx.WriteString(err.Error())
		return
	}
	ctrl.Ctx.WriteString(fmt.Sprintf("%v", user))
}

type User struct {
	Age  int    `json:"age"`
	Name string `json:"name"`
}

Bind这一大类有多个方法：

• Bind(obj interface{}) error: 默认是依据输入的 Content-Type字段，来判断该如何反序列化；
• BindYAML(obj interface{}) error: 处理YAML输入
• BindForm(obj interface{}) error: 处理表单输入
• BindJSON(obj interface{}) error: 处理JSON输入
• BindProtobuf(obj proto.Message) error: 处理proto输入
• BindXML(obj interface{}) error: 处理XML输入

在使用特定格式的输入的时候，别忘记设置标签（Tag），例如我们例子里面的json:"age"，不同格式的输入，其标签是不是一样的。

需要注意的是，虽然我们提供了一个根据Content-Type来判断如何绑定的，但是我们更加推荐用户使用指定格式的绑定方法。

一个接口，应该只接收特定某种格式的输入，例如只接收 JSON，而不应该可以处理多种输入

在早期，Beego 还有一个类似于BindForm的方法：ParseForm(obj interface{}) error，这两个方法效果是一致的。

路径参数

我们在路由定义——参数路由里面介绍过了如何获取路径参数。

早期 Bind 方法

在 Beego 的Input中定义了一系列的方法，用于读取参数。这一类方法很类似于 Get 一族的方法。所以用户可以酌情使用。

例如请求地址如下

?id=123&isok=true&ft=1.2&ol[0]=1&ol[1]=2&ul[]=str&ul[]=array&user.Name=astaxie

var id int
this.Ctx.Input.Bind(&id, "id")  //id ==123

var isok bool
this.Ctx.Input.Bind(&isok, "isok")  //isok ==true

var ft float64
this.Ctx.Input.Bind(&ft, "ft")  //ft ==1.2

ol := make([]int, 0, 2)
this.Ctx.Input.Bind(&ol, "ol")  //ol ==[1 2]

ul := make([]string, 0, 2)
this.Ctx.Input.Bind(&ul, "ul")  //ul ==[str array]

user struct{Name}
this.Ctx.Input.Bind(&user, "user")  //user =={Name:"astaxie"}

相关内容

• 路由定义——参数路由
• 文件上传