beego框架 处理请求参数

beego.Controller基础控制器，为我们提供了多种读取请求参数的函数，下面分别介绍各种获取参数的场景。

 

1. 默认获取参数方式

beego.Controller基础控制器为我们提供了GetXXX序列获取参数的函数, XXX指的就是返回不同的数据类型。
例子：

// 处理get请求
func (this *UserController) Get() {
	// 获取参数, 返回int类型
	id ,_:= this.GetInt("id")
	
	// 获取参数，返回string类型, 如果参数不存在返回none作为默认值
	username := this.GetString("username", "none")
	
	// 获取参数，返回float类型, 参数不存在则返回 0
	price, _ := this.GetFloat("price", 0)
}

下面是常用的获取参数的函数定义：

  • GetString(key string, def ...string) string
  • GetInt(key string, def ...int) (int, error)
  • GetInt64(key string, def ...int64) (int64, error)
  • GetFloat(key string, def ...float64) (float64, error)
  • GetBool(key string, def ...bool) (bool, error)

默认情况用户请求的参数都是 字符串 类型，如果要转换成其他类型，就可能会出现类型转换失败的可能性，因此除了GetString函数，其他GetXXX函数，都返回两个值，第一个值是需要获取的参数值，第二个就是error，表示是数据类型转换是否失败。

 

2. 绑定struct方式

除了上面一个一个的获取请求参数，针对POST请求的表单数据，beego支持直接将表单数据绑定到一个struct变量。

例子:

// 定义一个struct用来保存表单数据
// 通过给字段设置tag， 指定表单字段名， - 表示忽略这个字段不进行赋值
// 默认情况下表单字段名跟struct字段名同名（小写）
type UserForm struct {
    // 忽略掉Id字段
    Id    int         `form:"-"`
    // 表单字段名为username
    Name  string      `form:"username"`
    Phone string      
}

说明： 如果表单字段跟struct字段（小写）同名，不需要设置form标签。 表单html代码:

<form action="/user" method="POST">
    手机号：<input name="phone" type="text" /><br/>
    用户名：<input name="username" type="text" />
    <input type="submit" value="提交" />
</form>

控制器函数:

func (this *UserController) Post() {
    // 定义保存表单数据的struct对象
    u := UserForm{}
    // 通过ParseForm函数，将请求参数绑定到struct变量。
    if err := this.ParseForm(&u); err != nil {
        // 绑定参数失败
    }
}

提示：使用struct绑定请求参数的方式，仅适用于POST请求。

 

3. 处理json请求参数

一般在接口开发的时候，有时候会将json请求参数保存在http请求的body里面。我们就不能使用前的方式获取json数据，需要直接读取请求body的内容，然后格式化数据。

处理json参数的步骤：

  • 在app.conf配置文件中，添加CopyRequestBody=true
  • 通过this.Ctx.Input.RequestBody获取请求body的内容
  • 通过json.Unmarshal反序列化json字符串，将json参数绑定到struct变量。

例子:

定义struct用于保存json数据

// 如果json字段跟struct字段名不一样，可以通过json标签设置json字段名
type UserForm struct {
    // 忽略掉Id字段
    Id    int         `json:"-"`
    // json字段名为username
    Name  string      `json:"username"`
    Phone string      
}

控制器代码:

func (this *UserController) Post() {
    // 定义保存json数据的struct对象
    u := UserForm{}
    
    // 获取body内容
    body := this.Ctx.Input.RequestBody
    
    // 反序列json数据，结果保存至u
    if err := json.Unmarshal(body, &u); err == nil {
        // 解析参数失败
    }
}
提示: 如果将请求参数是xml格式，xml参数也是保存在body中，处理方式类似，就是最后一步使用xml反序列化函数进行处理。

beego框架 处理响应数据：我们处理完用户的请求之后，通常我们都会返回 html 代码，然后浏览器就可以显示 html 内容；除了返回 html，在 api 接口开发中，我们还可以返回 json、xml、jsonp 格式的数据。