萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP/Servlet 文件上傳實戰:使用 SmartUpload 組件完整範例

技術選型說明

Servlet 3.0+ 內建 @MultipartConfig + request.getPart() 已足夠處理上傳。本文介紹的 SmartUpload 為早期常用第三方組件,僅供維護舊專案參考。

完整實作三步驟

1. HTML 上傳表單 (upload.html)

<form name="uploadform" method="post" action="uploadImage.jsp" 
      enctype="multipart/form-data">
  <table border="1" width="65%">
    <tr><td colspan="2" align="center">廣告圖片上傳</td></tr>
    <tr>
      <td width="15%">廣告圖片:</td>
      <td><input type="file" name="adsImage" size="20"></td>
    </tr>
    <tr><td align="center" colspan="2">
      <input type="button" value="上傳" onclick="return checkForm();">
      <input type="button" value="取消" onclick="return cancelUpload();">
    </td></tr>
  </table>
</form>
<script>
function checkForm() {
    if (document.uploadform.adsImage.value == "") {
        alert("請選擇要上傳的圖片!"); return false;
    }
    document.uploadform.submit();
}
function cancelUpload() { window.close(); window.opener.focus(); }
</script>

2. JSP 處理頁 (uploadImage.jsp)

<%@ page import="com.jspsmart.upload.*, java.sql.*, java.util.*" %>
<jsp:useBean id="mySmartUpload" scope="page" class="com.jspsmart.upload.SmartUpload" />
<%
  // 初始化
  mySmartUpload.init(config);
  mySmartUpload.service(request, response);

  // 限制條件
  mySmartUpload.setAllowedFilesList("gif,bmp,jpeg,jpg");
  mySmartUpload.setTotalMaxFileSize(51200); // 50KB

  try {
      mySmartUpload.upload(); // 執行上傳
  } catch (Exception e) {
      out.println("<font color=red>上傳失敗!</font> <a href='javascript:history.back()'>返回</a><br>");
      out.println("<ul><li>檔案類型必須為 gif/jpeg/jpg/bmp</li>");
      out.println("<li>檔案大小不得超過 50KB</li></ul>");
      return;
  }

  // 儲存至伺服器絕對路徑(實務建議用 UUID 重命名、存資料庫路徑)
  mySmartUpload.getFiles().getFile(0).saveAs("/uploaded/" + 
      System.currentTimeMillis() + "_" + mySmartUpload.getFiles().getFile(0).getFileName());
  out.println("上傳成功!");
%>

3. Servlet 版本對照(現代寫法)

@WebServlet("/upload")
@MultipartConfig(maxFileSize = 1024*1024*10, maxRequestSize = 1024*1024*50) // 10MB/50MB
public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        Part filePart = req.getPart("adsImage");
        String fileName = Paths.get(filePart.getSubmittedFileName()).getFileName().toString();
        String savePath = getServletContext().getRealPath("/uploaded") + File.separator + 
                          UUID.randomUUID() + "_" + fileName;
        filePart.write(savePath);
        resp.getWriter().write("上傳成功:" + savePath);
    }
}

關鍵注意事項

  • enctype="multipart/form-data" 表單必須設置
  • 上傳目錄需給 Tomcat 寫入權限,且不可直接作為靜態資源公開(防止腳本執行)
  • 生產環境必須:檔案類型驗證(Magic Number)、大小限制、隨機重命名、病毒掃描、存儲路徑與 Webroot 隔離
  • 大文件上傳建議採用 分片上傳 + 斷點續傳(Plupload / WebUploader / FineUploader)
copyright © 萬盛學電腦網 all rights reserved