Node.js的Formidable模块的使用

1)     建立Formidable.IncomingForm对象

　　　var form = new formidable.IncomingForm()

2)     form.encoding = 'utf-8' 设置表单域的编码

3)     form.uploadDir = "/my/dir"; 设置上传文件存放的文件夹，默认为系统的临时文件夹，能够使用fs.rename()来改变上传文件的存放位置和文件名

4)     form.keepExtensions = false; 设置该属性为true能够使得上传的文件保持原来的文件的扩展名。

5)     form.type 只读，根据请求的类型，取值'multipart' or 'urlencoded'

6)     form.maxFieldsSize = 2 * 1024 * 1024; 限制全部存储表单字段域的大小（除去file字段），若是超出，则会触发error事件，默认为2M

7)     form.maxFields = 1000 设置能够转换多少查询字符串，默认为1000

8)     form.hash = false; 设置上传文件的检验码，能够有两个取值'sha1' or 'md5'.

9)     form.multiples = false; 开启该功能，当调用form.parse()方法时，回调函数的files参数将会是一个file数组，数组每个成员是一个File对象，此功能须要 html5中multiple特性支持。

10)   form.bytesReceived 返回服务器已经接收到当前表单数据多少字节

11)   form.bytesExpected 返回将要接收到当前表单全部数据的大小

12)   form.parse(request, [callback]) 该方法会转换请求中所包含的表单数据，callback会包含全部字段域和文件信息，如：

　　  form.parse(req, function(err, fields, files) {

 　　　　 // ...   

　　  });

13)    form.onPart(part); 你能够重载处理multipart流的方法，这样作的话会禁止field和file事件的发生，你将不得不本身处理这些事情，如：

　　   form.onPart = function(part) {

  　　 　　part.addListener('data', function() {

    　　           // ...

  　　　　 });

　　　}

　　  若是你只想让formdable处理一部分事情，你能够这样作:

　　  form.onPart = function(part) {

  　　　　if (!part.filename) {

    　　　　   // 让formidable处理全部非文件部分

   　　    　　form.handlePart(part);

　　 　　 }

　　 }

14)   formidable.File对象

　　A.      file.size = 0 上传文件的大小，若是文件正在上传，表示已上传部分的大小

　　B.      file.path = null 上传文件的路径。若是不想让formidable产生一个临时文件夹，能够在fileBegain事件中修改路径

　　C.      file.name = null 上传文件的名字

　　D.     file.type = null 上传文件的mime类型

　　E.      file.lastModifiedDate = null 时间对象，上传文件最近一次被修改的时间

　　F.      file.hash = null 返回文件的hash值

　　G.     能够使用JSON.stringify(file.toJSON())来格式化输出文件的信息

15)   form.on('progress', function(bytesReceived, bytesExpected) {}); 　　　　当有数据块被处理以后会触发该事件，对于建立进度条很是有用。

16)   form.on('field', function(name, value) {}); 　　　　每当一个字段/值对已经收到时会触发该事件

17)   form.on('fileBegin', function(name, file) {});  　　　　在post流中检测到任意一个新的文件便会触发该事件

18)   form.on('file', function(name, file) {}); 　　　　每当有一对字段/文件已经接收到，便会触发该事件

19)   form.on('error', function(err) {}); 当上传流中出现错误便会触发该事件，当出现错误时，若想要继续触发request的data事件，则必须手动调用request.resume()方法

20)   form.on('aborted', function() {}); 当用户停止请求时会触发该事件，socket中的timeout和close事件也会触发该事件，当该事件触发以后，error事件也会触发

21） form.on('end', function() {}); 当全部的请求已经接收到，而且全部的文件都已上传到服务器中，该事件会触发。此时能够发送请求到客户端。

注：本文译自https://www.npmjs.com/package/formidable