通过传统的form表单提交的方式上传文件：



[html] ​​​

  2. <form id= "uploadForm" action= "http://localhost:8080/cfJAX_RS/rest/file/upload" method= "post" enctype ="multipart/form-data">    
  3.      <h1 >测试通过Rest接口上传文件 </h1>    
  4.      <p >指定文件名： <input type ="text" name="filename" /></p>    
  5.      <p >上传文件： <input type ="file" name="file" /></p>    
  6.      <p >关键字1： <input type ="text" name="keyword" /></p>    
  7.      <p >关键字2： <input type ="text" name="keyword" /></p>    
  8.      <p >关键字3： <input type ="text" name="keyword" /></p>    
  9.      <input type ="submit" value="上传"/>    
  10. </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的方式进行请求：



[javascript] ​

  2. $.ajax({    
  3.      url : "http://localhost:8080/STS/rest/user",    
  4.      type : "POST",    
  5.      data : $( '#postForm').serialize(),    
  6.      success : function(data) {    
  7.           $( '#serverResponse').html(data);    
  8.      },    
  9.      error : function(data) {    
  10.           $( '#serverResponse').html(data.status + " : " + data.statusText + " : " + data.responseText);    
  11.      }    
  12. });   
$.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是什么呢？我们来看看Mozilla上的介绍。



XMLHttpRequest Level 2添加了一个新的接口​​FormData​​.利用​​FormData对象​​,我们可以通过JavaScript用一些键值对来模拟一系列表单控件,我们还可以使用XMLHttpRequest的​​send()​​方法来异步的提交这个"表单".比起普通的ajax,使用​​FormData​​的最大优点就是我们可以异步上传一个二进制文件. 


 



所有主流浏览器的较新版本都已经支持这个对象了，比如Chrome 7+、Firefox 4+、IE 10+、Opera 12+、Safari 5+。

​

 

Constructor

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);


浏览器兼容情况

Desktop

Feature

Chrome

Firfox(Gecko)

Intenet Explorer

Opera

Safari

Basic support

7+

4.0(2.0)

10+

12+

5+

append with filename

(Yes)

22.0(22.0)

?

?

?

delete, get, getAll, has, set

Behind Flag

Not supported

Not supported

(Yes)

Not supported

Mobile

Feature

Android

Chrome Android

Firfox Mobile (Gecko)

Firfox OS (Gecko)

IE Mobile

Opera Mobile

Safari Mobile

Basic support

3.0

?

4.0(2.0)

1.0.1

?

12+

?

append with filename

?

?

22.0(22.0)

1.2

?

?

?

delete, get, getAll, has, set

(Yes)

(Yes)

Not supported

Not supported

Not supported

(Yes)

Not supported





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()​​ 两个接口获取上传的文件。



​