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

青旅半醒 2021-09-14 13:28 565阅读 0赞

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

Html代码   ![收藏代码][icon_star.png]

1.  **<****form** id= "uploadForm" action= "http://localhost:8080/cfJAX\_RS/rest/file/upload" method= "post" enctype ="multipart/form-data"**>**  
2.       **<****h1** **>**测试通过Rest接口上传文件 **</****h1****>**  
3.       **<****p** **>**指定文件名： **<****input** type ="text" name="filename" **/>****</****p****>**  
4.       **<****p** **>**上传文件： **<****input** type ="file" name="file" **/>****</****p****>**  
5.       **<****p** **>**关键字1： **<****input** type ="text" name="keyword" **/>****</****p****>**  
6.       **<****p** **>**关键字2： **<****input** type ="text" name="keyword" **/>****</****p****>**  
7.       **<****p** **>**关键字3： **<****input** type ="text" name="keyword" **/>****</****p****>**  
8.       **<****input** type ="submit" value="上传"**/>**  
9.  **</****form****>**

不过传统的form表单提交会导致页面刷新， 但是在有些情况下，我们不希望页面被刷新，这种时候我们都是使用Ajax的方式进行请求的：

Js代码   ![收藏代码][icon_star.png]

1.  $.ajax(\{  
2.       url : "http://localhost:8080/STS/rest/user",  
3.       type : "POST",  
4.       data : $( '\#postForm').serialize(),  
5.       success : **function**(data) \{  
6.            $( '\#serverResponse').html(data);  
7.       \},  
8.       error : **function**(data) \{  
9.            $( '\#serverResponse').html(data.status + " : " + data.statusText + " : " + data.responseText);  
10.      \}  
11. \});

如上，通过 $( '\#postForm' ).serialize() 可以对form表单进行序列化，从而将form表单中的所有参数传递到服务端。

但是上述方式，只能传递一般的参数， 上传文件的文件流是无法被序列化并传递的。

不过如今主流浏览器都开始支持一个叫做FormData的对象，有了这个FormData，我们就可以轻松地使用Ajax方式进行文件 上传 了。

**关于FormData及其用法**

--------------------

FormData是什么呢？我们来看看Mozilla上的介绍。

<table style="border-color:rgb(204,204,204); color:rgb(0,0,0); font-family:Helvetica,Tahoma,Arial,sans-serif; font-size:14px; line-height:25.2px; table-layout:fixed; min-width:400px; max-width:650px"> 
 <tbody> 
  <tr> 
   <td style="font-size:1em; border-color:rgb(204,204,204); padding:3px"> 
    <div>
      XMLHttpRequest Level 2添加了一个新的接口 
     <code style="font-family:&quot;Courier New&quot;,Courier,monospace; font-size:1em; white-space:pre">FormData</code>.利用 
     <code style="font-family:&quot;Courier New&quot;,Courier,monospace; font-size:1em; white-space:pre">FormData对象</code>,我们可以通过JavaScript用一些键值对来模拟一系列表单控件,我们还可以使用XMLHttpRequest的 
     <a title="zh-CN/XMLHttpRequest#send()" href="https://developer.mozilla.org/zh-CN/docs/DOM/XMLHttpRequest#send%28%29" style="color:rgb(16,138,198)" rel="nofollow"><code style="font-family:&quot;Courier New&quot;,Courier,monospace; font-size:1em; white-space:pre">send()</code></a>方法来异步的提交这个"表单".比起普通的ajax,使用 
     <code style="font-family:&quot;Courier New&quot;,Courier,monospace; font-size:1em; white-space:pre">FormData</code>的最大优点就是我们可以异步上传一个二进制文件.&nbsp; 
    </div> 
    <div>
      &nbsp; 
    </div> 
    <div> 
     <div> 
      <span style="font-family:&quot;Microsoft YaHei&quot;">所有主流浏览器的较新版本都已经支持这个对象了，比如Chrome 7+、Firefox 4+、IE 10+、Opera 12+、Safari 5+。</span> 
     </div> 
     <div>
       &nbsp; 
     </div> 
     <span style="font-family:&quot;Microsoft YaHei&quot;">参见：</span> 
     <a href="https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest/FormData" style="color:rgb(16,138,198)" rel="nofollow">https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest/FormData</a> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

这里只展示一个通过from表单来初始化FormData的方式

< form   enctype = *"multipart/form-data"*   method = *"post"*   name = *"fileinfo"* >

Js代码   ![收藏代码][icon_star.png]

1.  **var** oData = **new** FormData(document.forms.namedItem("fileinfo" ));  
2.  oData.append( "CustomField", "This is some extra data" );  
3.  **var** oReq = **new** XMLHttpRequest();  
4.  oReq.open( "POST", "stash.php" , **true** );  
5.  oReq.onload = **function**(oEvent) \{  
6.        **if** (oReq.status == 200) \{  
7.            oOutput.innerHTML = "Uploaded!" ;  
8.       \} **else** \{  
9.            oOutput.innerHTML = "Error " + oReq.status + " occurred uploading your file.<br \\/>";  
10.      \}  
11. \};  
12. oReq.send(oData);

参见： [https://developer.mozilla.org/zh-CN/docs/Web/Guide/Using\_FormData\_Objects][https_developer.mozilla.org_zh-CN_docs_Web_Guide_Using_FormData_Objects]

**使用FormData，进行Ajax请求并上传文件**

--------------------

这里使用JQuery，但是老版本的JQuery比如1.2是不支持的，最好使用2.0或更新版本：

Html代码   ![收藏代码][icon_star.png]

1.  **<****form** id= "uploadForm"**>**  
2.        **<****p** **>**指定文件名： **<****input** type="text" name="filename" value= ""**/>****</****p** **>**  
3.        **<****p** **>**上传文件： **<****input** type="file" name="file"**/>****</** **p****>**  
4.        **<****input** type="button" value="上传" onclick="doUpload()" **/>**  
5.  **</****form****>**

Js代码   ![收藏代码][icon_star.png]

1.  **function** doUpload() \{  
2.       **var** formData = **new** FormData($( "\#uploadForm" )\[0\]);  
3.       $.ajax(\{  
4.            url: 'http://localhost:8080/cfJAX\_RS/rest/file/upload' ,  
5.            type: 'POST',  
6.            data: formData,  
7.            async: **false**,  
8.            cache: **false**,  
9.            contentType: **false**,  
10.           processData: **false**,  
11.           success: **function** (returndata) \{  
12.               alert(returndata);  
13.           \},  
14.           error: **function** (returndata) \{  
15.               alert(returndata);  
16.           \}  
17.      \});  
18. \}

[icon_star.png]: /images/20210813/bea93ec7af5144d0b5dfeff0875d4797.png
[https_developer.mozilla.org_zh-CN_docs_Web_Guide_Using_FormData_Objects]: https://developer.mozilla.org/zh-CN/docs/Web/Guide/Using_FormData_Objects