ajaxFileUpload 這個小外掛網路上有數不清的版本,因為實作它並不難——隱藏 iframe 加動態 form,本質上就這麼回事。本文使用的版本來自 https://github.com/carlcarl/AjaxFileUpload。當初挑上它,純粹是因為它的參數配置方式很像 jQuery 的 $.ajax(),寫起來順手。
不過它有一個明顯的缺口:原版本並不支援 data 參數。文件上寫得好像可以用,實際上後端什麼都收不到。本文就把這個問題從原因到解法完整走一遍。
語法:$.ajaxFileUpload([options])
參數一覽:
<input type="file"> 的 id。SyntaxError: missing ; before statement → url 路徑根本打不開。SyntaxError: syntax error → 後端處理程式有語法錯誤。SyntaxError: invalid property id → file 欄位的 id 屬性不存在。SyntaxError: missing } in XML expression → file 的 name 不一致或沒設。這些訊息幾乎都不直指問題,與其逐項猜,不如把回傳內容用 alert() 或 console 直接印出來看。
第一步:引入套件。
<script src="jquery-1.7.1.js" type="text/javascript"></script> <script src="ajaxfileupload.js" type="text/javascript"></script>
第二步:HTML。
<body> <p><input type="file" id="file1" name="file" /></p> <input type="button" value="上傳" /> <p><img id="img1" alt="上傳成功啦" src="" /></p> </body>
第三步:呼叫。
function ajaxFileUpload() {
$.ajaxFileUpload({
url: '/upload.aspx',
secureuri: false,
fileElementId: 'file1',
dataType: 'json',
success: function (data, status) {
$("#img1").attr("src", data.imgurl);
if (typeof (data.error) != 'undefined' && data.error != '') {
alert(data.error);
} else {
alert(data.msg);
}
},
error: function (data, status, e) { alert(e); }
});
return false;
}
ajaxFileUpload 為了做到無刷新提交,做法是動態建立一個 iframe、再建立一個 form,把 file 欄位搬進去送出。問題就在於——原始碼從頭到尾沒有處理 data。它只是把選項存起來,卻從未使用。所以我們得自己補上。
① 讓 createUploadForm 接受第三個參數 data:
createUploadForm: function(id, fileElementId, data) { ... }
② 在建立表單的迴圈裡,把 data 的每個鍵值轉成隱藏欄位:
if (data) {
for (var i in data) {
$('<input type="hidden" name="' + i + '" value="' + data[i] + '" />').appendTo(form);
}
}
③ 呼叫時把 s.data 傳進去:
var form = jQuery.createUploadForm(id, s.fileElementId, s.data);
三處合起來看,就是這樣:
createUploadForm: function(id, fileElementId, data) {
...
if (data) {
for (var i in data) {
$('<input type="hidden" name="' + i + '" value="' + data[i] + '" />').appendTo(form);
}
}
...
};
// 呼叫處
var form = jQuery.createUploadForm(id, s.fileElementId, s.data);
$.ajaxFileUpload({
url: 'https://localhost:8080/HNUST/crawler/ordinary2',
type: 'post',
data: { url: url, keyword: keyword, rule: rule, data: data, sign: sign },
secureuri: false,
fileElementId: 'file', // 要與 input 的 id、name 一致
dataType: 'JSON', // 這裡必須大寫,否則取不到回傳資料
success: function (data, status) { alert(data); },
error: function (data, status, e) { alert(e); }
});
對應的 HTML:
<input type="file" id="file" name="file">
Java 後端照一般方式取值就好:
String url = request.getParameter("url");
String keyword = request.getParameter("keyword");
上傳的如果是文字檔而不是圖片,用 MultipartFile 取得串流再逐行讀:
MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request;
MultipartFile multipartFile = multipartRequest.getFile("file"); // 要與 fileElementId 一致
try {
InputStream inputStream = multipartFile.getInputStream();
BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
String tempString = null;
// 一次讀一行,直到 null 代表檔尾
while ((tempString = reader.readLine()) != null) {
fileList.add(tempString);
}
} catch (IOException e2) {
e2.printStackTrace();
}
其一,dataType 一定要大寫。寫成小寫的 'json' 會導致取不到回傳值,這是本外掛最經典的坑。
其二,data 的值要寫成合法的物件字面值。引號、逗號、冒號錯一個,後端就是收不到參數,而且不會給你任何有幫助的錯誤提示。
最後提醒一句:這個外掛本質上是靠 iframe 提交的舊式做法,維護老專案時堪用,新專案請直接採用 FormData:
var fd = new FormData();
fd.append('file', $('#file')[0].files[0]);
fd.append('keyword', keyword);
$.ajax({ url: '/upload', type: 'POST', data: fd, processData: false, contentType: false,
success: function(res){ console.log(res); } });
程式碼短一半,坑也少一半。