用 SmartUpload 處理檔案上傳時,最常踩到的坑就是:表單明明填了資料,用 request.getParameter() 卻永遠拿到 null。原因藏在 form 標籤的 enctype 屬性裡。
要實現檔案上傳,form 標籤必須同時滿足兩個條件:
<form method="post" enctype="multipart/form-data">
enctype="multipart/form-data" 的作用是設定表單的 MIME 編碼。預設情況下這個值是 application/x-www-form-urlencoded,它無法承載檔案資料;只有改成 multipart/form-data,才能完整傳遞二進位檔案內容。
關鍵在於:使用 multipart/form-data 之後,表單裡所有 input 的值都會以二進位方式送出,接著 Servlet 容器的 request 物件就無法再用標準方式解析出這些欄位。也就是說,一旦加上這段設定,直接用 request.getParameter() 就會拿不到值。
正確的做法是繞過 request,改用 SmartUpload 物件本身取值:
SmartUpload su = new SmartUpload(); su.getRequest().getParameterValues(String name); // 取陣列值 su.getRequest().getParameter(String name); // 取單一值
使用 SmartUpload 前記得引入對應的 jar 套件。取得單一欄位值的寫法如下:
String softname = su.getRequest().getParameter("softname");
最關鍵的一點:這行程式碼一定要放在 su.upload() 之後執行,否則依然取不到值。upload() 完成解析之後,表單資料才真正被填入 request 物件中。
以下是一個可直接參考的 doPost 實作,示範了初始化、限制條件設定、檔案保存與欄位取值:
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
SmartUpload mySmartUpload = new SmartUpload();
try {
// 初始化
mySmartUpload.initialize(config, request, response);
// 限制單一檔案大小(此處為 10MB)
mySmartUpload.setMaxFileSize(10 * 1024 * 1024);
// 設定禁止上傳的副檔名
mySmartUpload.setDeniedFilesList("exe,doc");
// 也可改為白名單:只允許指定類型
// mySmartUpload.setAllowedFilesList("txt,html,jpg,js");
mySmartUpload.upload();
// 注意:必須在 upload() 之後才能取得表單欄位
String hString = mySmartUpload.getRequest().getParameter("name1");
// 迴圈處理多檔案上傳
for (int i = 0; i < mySmartUpload.getFiles().getCount(); i++) {
File file = mySmartUpload.getFiles().getFile(i);
if (file.getSize() != 0) {
// 以時間戳產生新檔名,避免覆寫
String fileNameString = System.currentTimeMillis() + "." + file.getFileExt();
// 以 Servlet 實際路徑組出存檔位置(依實際環境調整)
String path = "/upload123123" + java.io.File.separator + fileNameString;
file.saveAs(path);
}
Thread.sleep(100);
}
// 若需要提供下載:
// mySmartUpload.downloadFile("/路徑" + "檔名");
} catch (Exception e) {
e.printStackTrace();
}
}