经过Ajax方式上传文件，使用FormData进行Ajax请求

一、经过传统的form表单提交的方式上传文件：

<form id= "uploadForm" action= "http://localhost:8080/cfJAX_RS/rest/file/upload" 
method= "post" enctype ="multipart/form-data">  
     <h1 >测试经过Rest接口上传文件 </h1>  
     <p>指定文件名： <input type ="text" name="filename" /></p>  
     <p>上传文件： <input type ="file" name="file" /></p>  
     <p>关键字1： <input type ="text" name="keyword" /></p>  
     <p>关键字2： <input type ="text" name="keyword" /></p>  
     <p>关键字3： <input type ="text" name="keyword" /></p>  
     <input type ="submit" value="上传"/>  
</form>

不过传统的form表单提交会致使页面刷新，可是在有些状况下，咱们不但愿页面被刷新，这种时候咱们都是使用Ajax的方式进行请求的。

 

二、Ajax的方式进行请求：

$.ajax({  
     url : "http://localhost:8080/STS/rest/user",  
     type : "POST",  
     data : $( '#postForm').serialize(),  
     success : function(data) {  
          $( '#serverResponse').html(data);  
     },  
     error : function(data) {  
          $( '#serverResponse').html(data.status + " : " + data.statusText + " : " + data.responseText);  
     }  
});

一般咱们提交（使用submit button）时，会把form中的全部表格元素的name与value组成一个queryString，提交到后台。这用jQuery的方法来讲，就是serialize。

经过$('#postForm').serialize()能够对form表单进行序列化，从而将form表单中的全部参数传递到服务端。

可是上述方式，只能传递通常的参数，上传文件的文件流是没法被序列化并传递的。

不过现在主流浏览器都开始支持一个叫作FormData的对象，有了这个FormData，咱们就能够轻松地使用Ajax方式进行文件上传了。

 

三、关于FormData及其用法

想获得一个FormData对象：

var formdata = new FormData();

W3c草案提供了三种方案来获取或修改FormData。

方案1：建立一个空的FormData对象，而后再用append方法逐个添加键值对：

var formdata = new FormData();
formdata.append("name", "呵呵");
formdata.append("url", "http://www.baidu.com/");

 

方案2：取得form元素对象，将它做为参数传入FormData对象中！

var formobj =  document.getElementById("form");
var formdata = new FormData(formobj);

 

方案3：利用form元素对象的getFormData方法生成它！

var formobj =  document.getElementById("form");
var formdata = formobj.getFormData()

 

Method

FormData.append

本方法用于向已存在的键添加新的值，如该键不存在，新建之。

语法

formData.append(name, value);
formData.append(name, value, filename);

 

注: 经过 FormData.append()方法赋给字段的值如果数字会被自动转换为字符(字段的值能够是一个Blob对象,一个File对象,或者一个字符串,剩下其余类型的值都会被自动转换成字符串).

参数解释

• name
  键 (key)， 对应表单域
• value
  表单域的值
• filename (optional)
  The filename reported to the server (a USVString), when a Blob or File is passed as the second parameter. The default filename for Blob objects is "blob".

FormData.delete

将一对键和值从 FormData 对象中删除。

formData.delete(username);

FormData.get

返回给定键的第一个值

formData.append('username', 'Justin');
formData.append('username', 'Chris');
formData.get(username);    // "Justin"

FormData.getAll

返回给定键的全部值

formData.append('username', 'Justin');
formData.append('username', 'Chris');
formData.getAll(username);    // ["Justin", "Chris"]

FormData.has

检查是否包含给定键，返回 true 或 false

formData.has(username);

FormData.set

设置给定键的值

formData.set(name, value);
formData.set(name, value, filename);

 

 

四、Ajax经过FormData上传文件

1.使用<form>表单初始化FormData对象方式上传文件

HTML代码

<form id="uploadForm" enctype="multipart/form-data">
    <input id="file" type="file" name="file"/>
    <button id="upload" type="button">upload</button>
</form>

javascript代码

$.ajax({
    url: '/upload',
    type: 'POST',
    cache: false,
    data: new FormData($('#uploadForm')[0]),
    processData: false,
    contentType: false
}).done(function(res) {
}).fail(function(res) {});

 

这里要注意几点：

• processData设置为false。由于data值是FormData对象，不须要对数据作处理。
• <form>标签添加enctype="multipart/form-data"属性。
• cache设置为false，上传文件不须要缓存。
• contentType设置为false，不设置contentType值，由于是由<form>表单构造的FormData对象，且已经声明了属性enctype="multipart/form-data"，因此这里设置为false。

上传后，服务器端代码须要使用从查询参数名为file获取文件输入流对象，由于<input>中声明的是name="file"。

若是不是用<form>表单构造FormData对象又该怎么作呢？

 

2.使用FormData对象添加字段方式上传文件

HTML代码

<div id="uploadForm">
    <input id="file" type="file"/>
    <button id="upload" type="button">upload</button>
</div>

这里没有<form>标签，也没有enctype="multipart/form-data"属性。

javascript代码

var formData = new FormData();
formData.append('file', $('#file')[0].files[0]);
$.ajax({
    url: '/upload',
    type: 'POST',
    cache: false,
    data: formData,
    processData: false,
    contentType: false
}).done(function(res) {
}).fail(function(res) {});

这里有几处不同：

• append()的第二个参数应是文件对象，即$('#file')[0].files[0]。
• contentType也要设置为‘false’。

从代码$('#file')[0].files[0]中能够看到一个<input type="file">标签可以上传多个文件，
只须要在<input type="file">里添加multiple或multiple="multiple"属性。

 

3.服务器端读文件

 

从Servlet 3.0 开始，能够经过 request.getPart() 或 request.getPars() 两个接口获取上传的文件。