如何使用 multiparty 工具库在 Node.js 应用里解析 multipart form-data 格式的请求

我们使用 form 和 input 控件上传文件到服务器，服务器采取 Node.js 应用接收客户端上传的文件。可以使用 ​​multiparty​​ 这个库文件，解析从客户端提交的本地文件。完整的源代码如下图所示：

var multiparty = require('multiparty');
var http = require('http');
var util = require('util');
const PORT = 3003;

http.createServer(function(req, res) {
  if (req.url === '/upload' && req.method === 'POST') {
    // parse a file upload
    var form = new multiparty.Form();

    form.parse(req, function(err, fields, files) {
      res.writeHead(200, { 'content-type': 'text/plain' });
      res.write('received upload:\n\n');
      res.end(util.inspect({ fields: fields, files: files }));
    });

    return;
  }

  // show a file upload form
  res.writeHead(200, { 'content-type': 'text/html' });
  res.end(
    '<form action="/upload" enctype="multipart/form-data" method="post">'+
    '<input type="text" name="title"><br>'+
    '<input type="file" name="upload" multiple="multiple"><br>'+
    '<input type="submit" value="upload your file">'+
    '</form>'
  );
}).listen(PORT);

console.log('listen on port:' + PORT);

文件上传的具体实现：

使用 HTML 标准的 form 标签，action 值为 ​​/upload​​, 这个值在 Node.js 应用里会再次用到。

enctype 为 ​​multipart/form-data​​：

使用 ​​input​​​ 控件，属性指定为 ​​file​​​，multiple 属性为 ​​multiple​​，以支持多文件上传。

一旦我在浏览器里输入 ​​http://localhost:3003/​​ 之后，下列断点就触发：提示有新的客户端连接到达：

此时 ​​createServer​​​ 里的回调函数，req 的类型为 IncomingMessage，url 字段的值为 ​​/​​：

此时返回一个文件上传的网页给客户端：

如下图所示：

选中两个文件后，点击 ​​Upload your files​​：

此时 url 变成了 form 里指定的 ​​/upload​​，method 变成了 POST：

执行 ​​form.parse​​ 注册回调函数。注意，此时这个回调函数并不会立即执行。

稍后，当两个本地文件的数据流都完整上传到服务器之后，注册的回调函数以异步的方式被触发：

在此回调函数里，req 对象不再可用，只能访问 res(ServerResponse), error, fields, files 这种字段：

我们在 title 字段输入 ​​Jerry 123​​ 之后，点击 upload 按钮：

可以从 fields 字段获得 title 内容，从 files 字段获取上传的文件的文件名和尺寸，以及本地的绝对路径：