以往上傳文件多用 form 表單實現,偶然機會下嘗試用 js 異步上傳,過程中遇到了一些問題,於是記錄下來備忘。本文以 ajaxfileupload.js 為例,說明前端與後端的完整實現。
首先引入 jQuery 與 ajaxfileupload 的 js 文件,然後在文件選擇框的 change 事件中調用 $.ajaxFileUpload 發起異步上傳:
<div class="btn-file-box pos-rel">
<input type="file" id="upload" name="upload"
style="font-size: 0;opacity: 0;width: 100%;height: 100%;position: absolute;left: 0;top: 0;" />
<span class="btn">選擇文件</span>
</div>
$("#upload").on("change", function () {
$.ajaxFileUpload({
url: '/test/user/imgUpload', // 後台請求地址
type: 'post', // 提交自定義參數時需設為 post
secureuri: false, // 是否啟用安全提交,默認 false
fileElementId: 'upload', // 文件域 input 的 ID
dataType: 'json', // 服務器返回的數據類型
success: function (json, status) {
alert(json.retMsg);
},
error: function (json, status, e) {
// 提交失敗處理
}
});
});
需要注意的是,若後端返回的 JSON 帶有 pre 標簽,可能導致解析失敗,此時把 dataType 設為 json 即可解決。
後端使用 Jersey(JAX-RS)接收上傳請求,並借助 commons-fileupload 組件解析多部分表單數據。關鍵步驟包括:設置文件存儲工廠與緩衝大小、設置 header 編碼以處理中文文件名、遍歷 FileItem 區分普通表單字段與文件項、並對文件大小做限制。
@Controller
@Path("/user")
public class UploadImg {
@Path("/imgUpload")
@POST
@Produces("application/json; charset=utf-8")
@Consumes(MediaType.MULTIPART_FORM_DATA)
public JSONObject upload(@Context HttpServletRequest request) {
JSONObject jsonobj = new JSONObject();
String file_path = request.getSession().getServletContext().getRealPath("/")
+ File.separator + "corpfile" + File.separator;
File file = new File(file_path);
if (!file.exists() && !file.isDirectory()) {
file.mkdir(); // 文件夾不存在則創建
}
DiskFileItemFactory factory = new DiskFileItemFactory();
factory.setRepository(new File(file_path));
factory.setSizeThreshold(2048 * 1024); // 小於此值放入內存,否則放入磁盤
ServletFileUpload upload = new ServletFileUpload(factory);
upload.setHeaderEncoding("utf-8"); // 處理中文文件名
try {
List<FileItem> list = upload.parseRequest(request);
for (FileItem item : list) {
if (!item.isFormField()) {
String fileName = item.getName() + ".jpg";
if (item.getSize() > 10485760) { // 限制 10M
jsonobj.put("retCode", "100");
jsonobj.put("retMsg", "您好,上傳文件要小於10M!");
} else {
item.write(new File(file_path, fileName)); // 寫入磁盤
jsonobj.put("retCode", "0");
jsonobj.put("retMsg", "您好,上傳成功!");
}
}
}
} catch (Exception e) {
jsonobj.put("retCode", "9999");
jsonobj.put("retMsg", "您好,文件上傳失敗");
}
return jsonobj;
}
}
以上就是使用 ajaxfileupload.js 實現異步文件上傳的完整前後端代碼。前端通過 $.ajaxFileUpload 提交,後端用 commons-fileupload 解析並保存文件,最後以 JSON 形式返回处理结果。