利用Ajax无刷新上传文件到Node.js服务器

jopen 9年前

最近做一个垂直社区项目,图片上传是现如今社区的标配,何况面向的还是女性用户。后端使用Node.js,图片上传必然是要不刷新不用iframe了。顺便,也测试了一下Coding.net的“演示”功能,的确是方便免费够用,代码传上去基本零配置就可以跑起来了。这篇文章涉及的代码托管在Coding上,最终的例子也是运行在Coding的免费服务器上。

协议与结构

整个上传采用RFC1867协议,即基于HTML表单的文件上传协议。借助这个协议,为表单增加enctype="multipart/form-data",再使用type为file的input控制来选择文件,然后便可用POST方法上传文件。

文件上传时会分段提交,借助Connect的connect-multiparty模块,即可接收各段组合整理为文件,并将文件存到临时目录,我们可再编写其它代码来处理文件。本例中,我们会把文件复制到public目录,以提供web访问。

整个示例程序包括以下几部分:

  • HTML表单,负责文件的选择
  • JavaScript组织表单数据,执行上传
  • Node.js接受上传的文件,并负责文件的移动和组织

示例程序的代码托管在Coding上的Node.js-Ajax-Upload-File,在线演示地址为node-js-ajax-upload-file.codingapp.com

下面开工。

HTML表单组织

表单很简单,就一个文件选择的控件。当type为file的input控件除了常规属性,还包括一个accept属性,用于定义可以选择的文件类型。

HTML中包括一个表单,一个提交按钮,和一个显示成功上传到服务器的图片的控件,主要代码如下:

<form class = "form-horizontal" enctype='multipart/form-data' method='post' action='javascript:;' role = "form" id = "frmUploadFile">  <div class = "form-group">  <label class = "control-label col-sm-2">上传选择</label>  <div class = "col-sm-4">  <input type = "file" name = "files" class = "form-control" />  </div>  </div>  <div class = "form-group">  <div class = "col-sm-offset-2 col-sm-4">  <button class = "btn btn-primary" onClick = "uploadFile()">上传</button>  <span class = "help-inline" id = "spanMessage">选择文件,并上传</span>  </div>  </div>  </form>  <div class = "row" style = "text-align: center">  <img id = "imgShow" />  </div>


完整代码请查看public/index.html

Ajax执行上传

浏览器端的JavaScript会将表单中的数据格式化,再以POST方法上传文件,为了简便,使用了jQuery库来操作,具体代码比较简单,上传文件,然后根据服务器端的返回判定上传是否成功,如果成功,则显示图片。

代码包装为自定义的函数,由“发送”按钮的单击事件调用,代码如下:

function uploadFile(){  var formData = new FormData($("#frmUploadFile")[0]);  $.ajax({  url: '/upload',  type: 'POST',  data: formData,  async: false,  cache: false,  contentType: false,  processData: false,  success: function(data){  if(200 === data.code) {  $("#imgShow").attr('src', data.msg.url);  $("#spanMessage").html("上传成功");  } else {  $("#spanMessage").html("上传失败");  }  console.log('imgUploader upload success, data:', data);  },  error: function(){  $("#spanMessage").html("与服务器通信发生错误");  }  });  }


具体请参见文件pubilc/demo.js

Node.js接收文件

通过POST接收到的文件,由connect-multiparty负责重新组织为文件,并存储到临时文件夹中,Linux默认为/tmp目录,然后再将文件信息放到req.files对象中,对象中按input的name属性来组织文件列表,我们上面的表单中的input控件name为files,所以文件的信息便存储在req.files.files中。通过它可获取文件的存储位置和文件名等信息。

整个服务器端的代码很简单,连同注释不过20多行,其中处理请求部分的代码如下:

var multipart = require('connect-multiparty');  app.post('/upload', multipart(), function(req, res){  //get filename  var filename = req.files.files.originalFilename || path.basename(req.files.files.ws.path);  //copy file to a public directory  var targetPath = path.dirname(__filename) + '/public/' + filename;  //copy file  fs.createReadStream(req.files.files.ws.path).pipe(fs.createWriteStream(targetPath));  //return file url  res.json({code: 200, msg: {url: 'http://' + req.headers.host + '/' + filename}});  });


完整代码请参阅app.js

示例程序的运行

如果系统中已经安装了git,则可以用下面的命令克隆:

     
1
     
$ git clone https://coding.net/Stiekel/Node.js-Ajax-Upload-File.git

也可以下载zip包,程序中的前端包都使用的是百度的公开库,后端代码使用npm管理,进入应用目录,执行如下的命令安装:

     
1
     
$ npm install

然后执行如下的命令可以启动应用:

     
1
     
$ node app.js

再通过浏览器访问http://ip:3000/即可。注意,上传的文件会保存在/tmp和public两个目录中。

来自:http://chensd.com/2015-01/Node-js-Ajax-Upload-File.html