Bamboo对Upload的支持

Bamboo Web框架对上传提供了方便的接口。目前支持的特性如下：

[list]
[*]它同时支持html4和html5上传，且用统一接口处理；
[*]同时支持单文件和多文件上传；
[*]目前仅支持小于指定值（在mongrel2的配置文件中设定）的文件的上传，且是放在内存中一次性处理（后面视需求考虑支持大文件上传，大文件上传在mongrel2中已有很好的支持）；
[*]上传的文件会直接存储在磁盘上，同时会在数据库中有一份对应的记录；
[/list]
Bamboo定义了一个基本的Upload模型，这个模型有如下字段：

[list]
[*]name 文件名字
[*]path 文件在服务器资源目录下的完整路径
[*]size 文件的大小，按字节计算
[*]timestamp 文件上传（创建）的时间
[*]desc 文件的描述
[/list]

使用方式如下：

如：
local Upload = require 'bamboo.models.upload'
local newfile, result_type = Upload:process(web, req, 'logo/')

执行了这个之后，如果是单文件上传，则newfile就是创建的上传对象，里面的name, path, size, timestamp已经填充好了，desc还是''，result_type为'single'；

如果是多文件上传（仅限html4，html5执行的总是单文件上传），则new_file是一个upload list，result_type是'multiple'。

获得了文件对象后，如果需要对其添加更多的信息，只需如下操作：

如：
newfile.desc = 'this is a picture.'
newfile:save()
即可。

Upload模型还可以被继承，比如，Bamboo定义了一个Image模型，就是继承自Upload，在其之上添加了width, height两个字段。要上传一个Image，并保存，只需：

如：
local Image = require 'bamboo.models.image'
local newimg, result_type = Image:process(web, req, 'logo/')
newimg.width = xxx;
newimg.height = yyy;
newimg.desc = 'zzzzzz';
newimg:save()  -- 别忘了执行最后的save方法

可以看到，process函数，只负责保存文件和在数据库中生成基本记录的作用，更多的信息（不管是desc字段，还是由于继承添加的更多字段），都是在返回的file object基础上操作的。

下面给出process接口的完整参数：

newfile, result_type = Upload:process(web, req, dest_dir, prefix, postfix)

web: web对象，必须；
req：req对象，必须；
dest_dir：保存的路径，可选；
prefix：文件的前缀，可选；
postfix：文件的后缀，可选。

Upload对html5上传的数据有一定要求，要求req.headers中有如下字段：

[list=1]
[*]x-requested-with 标明这是一个ajax请求
[*]x-file-name 上传的文件名放在这里面（这个需要与客户端js代码配合实现。是不是从query参数中获得此值更好，值得商榷）
[/list]

enjoy.