DIV CSS 佈局教程網

ajaxFileUpload 帶參數上傳檔案:源碼改造與後端接收完整教學
編輯:JQuery入門技巧     

ajaxFileUpload 這個小外掛網路上有數不清的版本,因為實作它並不難——隱藏 iframe 加動態 form,本質上就這麼回事。本文使用的版本來自 https://github.com/carlcarl/AjaxFileUpload。當初挑上它,純粹是因為它的參數配置方式很像 jQuery 的 $.ajax(),寫起來順手。

不過它有一個明顯的缺口:原版本並不支援 data 參數。文件上寫得好像可以用,實際上後端什麼都收不到。本文就把這個問題從原因到解法完整走一遍。

先看基本用法

語法:$.ajaxFileUpload([options])

參數一覽:

  • url — 上傳處理程式的位址。
  • fileElementId — 檔案欄位的 id,即 <input type="file"> 的 id。
  • secureuri — 是否啟用安全提交,預設 false。
  • dataType — 回傳型別,可為 xml、script、json、html,留空則由 jQuery 自動判斷。
  • success — 成功後執行的函式,data 為伺服器回傳內容。
  • error — 失敗後執行的函式。
  • data — 自訂參數(原版本需改造才生效)。
  • type — 要送出自訂參數時設為 post。

常見錯誤訊息的真正含義

  • 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;
}

核心問題:為什麼 data 沒作用?

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

程式碼短一半,坑也少一半。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved