JSP 文件上傳組件 SmartUpload 完整使用指南

文件上傳與普通表單數據提交本質不同：文件以二進制形式存儲，需專用組件處理。SmartUpload 是一款經典、輕量的 JSP 文件上傳下載組件，雖官網已關閉，但因簡易好用至今仍廣泛應用。

SmartUpload 核心特性

• 實現文件上傳與下載功能
• 支持上傳文件類型、大小限制
• 輕鬆獲取文件名、後綴、大小等屬性
• 以 JAR 包形式提供，部署簡單（放入 classpath 或 Tomcat lib 目錄）

實戰案例：上傳圖片到指定目錄

本例演示將桌面圖片 dahai.jpg 上傳至 upload 目錄。

1. 前端表單構建

關鍵點：採用 POST 方法，設置 enctype="multipart/form-data" 以二進制形式提交。

<form action="smart_01.jsp" method="post" enctype="multipart/form-data">
  請選擇要上傳的文件：<input type="file" name="pic">
  <input type="submit" value="上傳">
</form>

注意：GET 方式受 URL 長度限制，不適合大文件上傳；multipart/form-data 確保二進制數據正確傳輸。

2. 服務端準備

1. 在 Web 應用根目錄下創建 upload 文件夾存放上傳文件。
2. 
3. 導入 SmartUpload.jar 到項目 WEB-INF/lib 目錄。

3. 後端處理邏輯

在 JSP 中使用 SmartUpload API 接收文件流、校驗類型大小、保存至目標目錄，並返回上傳結果提示。

掌握 SmartUpload 為後續學習 Commons FileUpload、Servlet 3.0 原生上傳 API 奠定基礎。