DIV CSS 佈局教程網

SmartUpload 檔案上傳時如何正確取得表單欄位值
編輯:關於JavaScript     

用 SmartUpload 處理檔案上傳時,最常踩到的坑就是:表單明明填了資料,用 request.getParameter() 卻永遠拿到 null。原因藏在 form 標籤的 enctype 屬性裡。

問題根源: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() 就會拿不到值。

解法:透過 SmartUpload 取表單欄位

正確的做法是繞過 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();
    }
}

幾個實務提醒

  • 順序決定成敗。initialize → 設定限制 → upload → 取值,這個順序不能顛倒。
  • 白名單優於黑名單。setDeniedFilesList 需要你把所有危險副檔名都列舉出來,容易遺漏;setAllowedFilesList 只放行已知安全的類型,安全性更高。
  • 檔名要重新產生。直接沿用使用者上傳的檔名有兩個風險:中文名稱可能出現編碼問題,惡意檔名也可能造成路徑穿越。用時間戳或 UUID 重新命名是較穩妥的做法。
  • 大小限制要顧及記憶體。setMaxFileSize 攔的是單檔大小;若要限制整體請求量,還需要另外設定。

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