曾經想過用 jQuery 插件(比如 uploadify)做異步上傳,但往往需要額外支持;也有人用 iframe 模擬異步上傳,總覺得別扭。由於本項目不考慮低版本浏覽器,最終決定用 HTML5 來實現。本文就是一個簡單的 demo,具體樣式你可以自行發揮。
後台基於 Struts2 進行文件處理,具體因項目而異,但要特別注意設置文件大小限制:
<constant name="struts.multipart.maxSize" value="52428800"/>
這個配置根據具體情況設定,超過此值會報 404。
首先是上傳頁面 upload.jsp,比較簡單,附帶了「文件上傳者」這個參數:
<%@page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> <% String path = request.getContextPath(); %> <!DOCTYPE html> <html> <head> <title>使用XMLHttpRequest上傳文件</title> <script type="text/javascript"> var xhr = new XMLHttpRequest(); //監聽選擇文件信息 function fileSelected() { //HTML5文件API操作 var file = document.getElementById('fileName').files[0]; if (file) { var fileSize = 0; if (file.size > 1024 * 1024) fileSize = (Math.round(file.size * 100 / (1024 * 1024)) / 100).toString() + 'MB'; else fileSize = (Math.round(file.size * 100 / 1024) / 100).toString() + 'KB'; document.getElementById('fileName').innerHTML = 'Name: ' + file.name; document.getElementById('fileSize').innerHTML = 'Size: ' + fileSize; document.getElementById('fileType').innerHTML = 'Type: ' + file.type; } } //上傳文件 function uploadFile() { var fd = new FormData(); //關聯表單數據,可以是自定義參數 fd.append("name", document.getElementById('name').value); fd.append("fileName", document.getElementById('fileName').files[0]); //監聽事件 xhr.upload.addEventListener("progress", uploadProgress, false); xhr.addEventListener("load", uploadComplete, false); xhr.addEventListener("error", uploadFailed, false); xhr.addEventListener("abort", uploadCanceled, false); //發送文件和表單自定義參數 xhr.open("POST", "<%=path%>/user/uploadifyTest_doUpload"); xhr.send(fd); } //取消上傳 function cancleUploadFile(){ xhr.abort(); } //上傳進度 function uploadProgress(evt) { if (evt.lengthComputable) { var percentComplete = Math.round(evt.loaded * 100 / evt.total); document.getElementById('progressNumber').innerHTML = percentComplete.toString() + '%'; } else { document.getElementById('progressNumber').innerHTML = 'unable to compute'; } } //上傳成功響應 function uploadComplete(evt) { //服務斷接收完文件返回的結果 alert(evt.target.responseText); } //上傳失敗 function uploadFailed(evt) { alert("上傳失敗"); } //取消上傳 function uploadCanceled(evt) { alert("您取消了本次上傳."); } </script> </head> <body> <form id="form1" enctype="multipart/form-data" method="post" action="upload.php"> <div class="row"> <label for="fileToUpload">選擇文件</label> <input type="file" name="fileName" id="fileName" onchange="fileSelected();"/> </div> <div id="fileName"></div> <div id="fileSize"></div> <div id="fileType"></div> <div class="row"> 上傳者:<input type="text" name="name" id="name"/> <input type="button" onclick="uploadFile()" value="上傳" /> <input type="button" onclick="cancleUploadFile()" value="取消" /> </div> <div id="progressNumber"></div> </form> </body> </html>
其中這兩句是把數據綁定到表單:
fd.append("name", document.getElementById('name').value); fd.append("fileName", document.getElementById('fileName').files[0]);
由於 HTML5 支持多文件上傳,document.getElementById('fileName').files 返回的是數組,這裡只有一個文件所以取下標 0。
接著綁定進度、加載、錯誤、中斷等事件,提供豐富的交互反饋,進度條就是在 progress 回調裡顯示的:
xhr.upload.addEventListener("progress", uploadProgress, false); xhr.addEventListener("load", uploadComplete, false); xhr.addEventListener("error", uploadFailed, false); xhr.addEventListener("abort", uploadCanceled, false);
後台代碼 UploadifyTestAction.java:
package com.bjhit.eranges.actions.test; import java.io.File; import com.opensymphony.xwork2.ActionSupport; public class UploadifyTestAction extends ActionSupport { private static final long serialVersionUID = 837481714629791752L; private File fileName; private String name; private String responseInfo; public String doUpload() throws Exception { System.out.println(name); File myFile = fileName; System.out.println(myFile.getName()); responseInfo = "上傳成功!"; return "doUpload"; } public String getName() { return name; } public void setName(String name) { this.name = name; } public File getFileName() { return fileName; } public void setFileName(File fileName) { this.fileName = fileName; } public String getResponseInfo() { return responseInfo; } public void setResponseInfo(String responseInfo) { this.responseInfo = responseInfo; } }
action 配置:
<!-- 文件上傳例子 --> <action name="uploadifyTest_*" class="com.bjhit.eranges.actions.test.UploadifyTestAction" method="{1}"> <result name="doUpload" type="json"> <param name="includeProperties">responseInfo</param> <param name="excludeNullProperties">true</param> </result> </action>
這樣,一個帶進度條的基本上傳功能就實現了。感謝大家的閱讀,希望本文對你學習 Ajax 方式文件上傳進度條的實現有所幫助。