DIV CSS 佈局教程網

WebUploader 自訂上傳參數名稱的兩種解法
編輯:JQuery入門技巧     

WebUploader 預設送出的檔案欄位名稱不一定符合後端介面。本文記錄一次實戰中遇到的參數問題,以及最後找到的解法。

背景與難題

前端使用 HTML5 + Ajax,後端是 Java(Struts 相關框架)。後端同事提供的介面是 ./file/uploader.do?upFile=,也就是說檔案必須放在名為 upFile 的參數裡。但前端用的是 WebUploader,我一開始不知道該怎麼改這個欄位名稱。

翻了不少資料後,整理出兩條路。

方案一:後端用二進位串流接收

如果介面不指定參數名稱,後端可以直接用 request.getInputStream() 以二進位方式讀取上傳內容。但使用這個方式時,前端必須把 sendAsBinary 設為 true:

 var uploader = WebUploader.create({
    swf: './js/webuploader/Uploader.swf',
    server: common.BASE_URL_DEV + '/file/upload.do',
    pick: '#picker',
    duplicate: false,
    resize: false,
    auto: true,
    fileNumLimit: 5,
    sendAsBinary: true,          // 以二進位方式上傳
    fileSingleSizeLimit: 5242880,
    accept: {
        title: 'intoTypes',
        extensions: 'rar,zip,doc,xls,docx,xlsx,pdf',
        mimeTypes: '.rar,.zip,.doc,.xls,.docx,.xlsx,.pdf'
    }
}); 

這個做法的缺點是後端拿不到原始檔名與 Content-Type,通常得由前端另外把這些資訊放在其他參數一起送過去。

方案二:改用標準 multipart 上傳

若後端使用 commons-fileupload 這類元件接收,就維持一般的 multipart 流程,不必更動 sendAsBinary。這是多數 Java 專案的常態做法,後端同事通常已經很熟悉。

關鍵發現:預設參數就叫 file

一開始我送檔案時完全沒有指定參數名,後端同事在 Tomcat 的日誌裡看到三個欄位:file、fileContentType、fileFileName。其中 file 抓到的正是我上傳的檔案內容。於是我們猜測 WebUploader 有一個預設名稱叫「file」,翻查 API 文件後證實猜測正確。

問題至此迎刃而解——只要用 fileVal 這個設定項指定名稱即可:

 var uploader = WebUploader.create({
    swf: './js/webuploader/Uploader.swf',
    server: common.BASE_URL_DEV + '/file/upload.do',
    pick: '#picker',
    duplicate: false,
    resize: false,
    auto: true,
    fileNumLimit: 5,
    fileVal: "upload",           // 指定欄位名稱,後端用同一名稱接收
    fileSingleSizeLimit: 5242880,
    accept: {
        title: 'intoTypes',
        extensions: 'rar,zip,doc,xls,docx,xlsx,pdf',
        mimeTypes: '.rar,.zip,.doc,.xls,.docx,.xlsx,.pdf'
    }
}); 

整理一下

三個設定項各有用途:fileVal 決定檔案欄位的名稱(預設 file),sendAsBinary 決定是否以純二進位送出,而 formData 則用來附加其他自訂參數。釐清這三者的分工,大部分「後端收不到我要的參數」的問題都能迅速定位。

這次的經驗也說明:遇到元件行為不明確時,最快的排查方式就是先讓後端把收到的所有欄位名稱印出來,再回頭對照文件——比憑空猜測有效得多。

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