Go Web开发之Revel - 参数绑定

Revel尝试尽可能简单的转换参数到Go的类型.这个转换从string到另一种类型被称为数据绑定.

参数

全部的请求参数被收集到一个Params对象中.它包括如下:

• URL 路径参数
• URL 查询参数
• 表单值 (Multipart or not)
• 上传文件

定义如下(godoc)

type Params struct {
    url.Values
    Files map[string][]*multipart.FileHeader
}

这个嵌入的 url.Values (godoc)提供了访问简单值的方式,但是开发人员将使用更容易的Revel数据绑定机制来查找非字符串值.

Action参数

参数可以直接作为方法的参数被接收,如下:

func (c AppController) Action(name string, ids []int, user User, img []byte) rev.Result {
    ...
}

在调用action前,Revel要求它的绑定器来对这些名字的参数进行类型转换,如果由于任何原因造成绑定失败,参数将有一个默认值.

绑定器

绑定参数到数据类型,使用Revel的绑定器(godoc),它整合参数对象如下:

func (c SomeController) Action() rev.Result {
    var ids []int = c.Params.Bind("ids[]", reflect.TypeOf([]int{}))
    ...
}

下面的数据类型是被支持的:

• Ints of all widths
• Bools
• Pointers to any supported type
• Slices of any supported type
• Structs
• time.Time for dates and times
• *os.File, []byte, io.Reader, io.ReadSeeker for file uploads

下面的部分将描述这些类型的语法,你也可以参考源代码

Booleans

字符串的值"true","on"和"1"都被视为true, 其他的绑定值为false.

Slices

绑定Slices有两个被支持的语法:排序和未排序.

排序:

?ids[0]=1
&ids[1]=2
&ids[3]=4

slice中的结果为: []int{1, 2, 0, 4}

未排序:

?ids[]=1
&ids[]=2
&ids[]=3

slice中的结果为: []int{1, 2, 3}

注意:绑定一个slice结构时,只有排序的slice应该被使用.

?user[0].Id=1
&user[0].Name=rob
&user[1].Id=2
&user[1].Name=jenny

Structs

结构使用简单的点符号绑定:

?user.Id=1
&user.Name=rob
&user.Friends[]=2
&user.Friends[]=3
&user.Father.Id=5
&user.Father.Name=Hermes

将绑定下面的结构定义:

type User struct {
    Id int
    Name string
    Friends []int
    Father User
}

注意:为了绑定,属性必须被导出.

Date / Time

内建的SQL标准时间格式是 “2006-01-02”, “2006-01-02 15:04”

应用程序可以添加更多的,使用官方的模式.简单的添加模式来识别TimeFormats变量,如下:

func init() {
    rev.TimeFormats = append(rev.TimeFormats, "01/02/2006")
}

文件上传

文件上传可以被绑定到下面的类型:

• os.File
• []byte
• io.Reader
• io.ReadSeeker

这是一个有Go multipart包提供的包装器,bytes存放在内存中除非他们超过了一个阀值(默认10MB), 在这种情况下它们被写入临时文件.

注意:绑定一个文件上传到 os.File 需要Revel把它写入到一个临时文件, 它的效率要低于其他的类型.

自定义绑定器

应用程序可以定义它自己的绑定器来利用这个框架.

它只需要实现绑定器接口和注册这个类型它将在哪里被调用:

func myBinder(params Params, name string, typ reflect.Type) reflect.Value {
    ...
}

func init() {
    rev.TypeBinders[reflect.TypeOf(MyType{})] = myBinder
}

至此结束.