实现Java Web课程资料上传下载功能，采用Servlet + JSP + 文件系统，通过MVC模式组织代码。2. 功能包括教师上传文件、用户下载，文件存服务器目录，元数据记录至数据库。3. 使用Apache Commons FileUpload处理上传，Servlet解析请求并保存文件与信息。4. 通过ListServlet获取文件列表并由JSP展示下载链接。5. DownloadServlet读取文件流并响应输出，实现下载。6. 安全方面建议限制类型大小、防路径穿越、加权限控制。7. 系统可扩展分页、分类等功能，适用于教学场景。
在Java Web项目中实现一个简易的课程资料上传下载功能，是学习文件操作与前后端交互的典型场景。下面通过一个实战案例，讲解如何使用Servlet + JSP + 文件系统完成课程资料管理的基本功能。
1. 功能需求分析
本模块需要支持以下核心功能：
- 教师可以上传课程资料（如PDF、PPT、DOC等）
- 学生或用户可以浏览并下载已上传的资料
- 文件存储在服务器指定目录，数据库记录文件元信息
2. 项目结构设计
使用MVC模式组织代码：
- com.demo.servlet：处理请求的Servlet类
- com.demo.dao：数据访问层
- com.demo.entity：实体类（FileItem）
- webapp/upload：实际存放上传文件的目录
- WEB-INF/jsp：JSP页面（upload.jsp, list.jsp）
3. 数据库表设计
创建一张简单的文件信息表：CREATE TABLE course_file ( id INT PRIMARY KEY AUTO_INCREMENT, filename VARCHAR(255) NOT NULL, original_name VARCHAR(255) NOT NULL, upload_time DATETIME DEFAULT CURRENT_TIMESTAMP, file_path VARCHAR(500) );
其中 filename 是服务器生成的唯一文件名，original_name 是原始名称，file_path 可选。
立即学习“Java免费学习笔记（深入）”；
4. 文件上传实现（Servlet）
使用Apache Commons FileUpload组件处理文件上传：
- 添加依赖（Maven）：
commons-fileupload commons-fileupload 1.5
- UploadServlet核心代码片段：
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
String uploadPath = getServletContext().getRealPath("/") + "upload";
File uploadDir = new File(uploadPath);
if (!uploadDir.exists()) uploadDir.mkdir();
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
try {
List items = upload.parseRequest(request);
for (FileItem item : items) {
if (!item.isFormField()) {
String originalName = item.getName();
String fileName = System.currentTimeMillis() + "_" + originalName;
String filePath = uploadPath + File.separator + fileName;
File storeFile = new File(filePath);
item.write(storeFile);
// 保存到数据库
CourseFile file = new CourseFile();
file.setFilename(fileName);
file.setOriginalName(originalName);
file.setFilePath("upload/" + fileName);
fileDao.save(file);
}
}
response.sendRedirect("list.jsp");} catch (Exception e) {
e.printStackTrace();
}
}
5. 文件列表展示
在ListServlet中查询所有文件记录，并转发到JSP页面：
List files = fileDao.getAll();
request.setAttribute("files", files);
request.getRequestDispatcher("/WEB-INF/jsp/list.jsp").forward(request, response);
list.jsp 使用JSTL遍历显示可下载链接：
${file.originalName}
(${file.uploadTime})
6. 文件下载实现
DownloadServlet负责读取服务器文件并输出到响应流：
String filename = request.getParameter("filename");
String filePath = getServletContext().getRealPath("/") + "upload" + File.separator + filename;
File file = new File(filePath);
if (file.exists()) {
response.setContentType("application/octet-stream");
response.setHeader("Content-Disposition", "attachment; filename=" +
URLEncoder.encode(file.getName().substring(file.getName().indexOf("_") + 1), "UTF-8"));
FileInputStream fis = new FileInputStream(file);
OutputStream os = response.getOutputStream();
byte[] buffer = new byte[4096];
int bytesRead;
while ((bytesRead = fis.read(buffer)) != -1) {
os.write(buffer, 0, bytesRead);
}
os.flush(); fis.close();
} else {
response.sendError(404, "文件未找到");
}
7. 安全与优化建议
- 限制上传文件类型（检查后缀或MIME）
- 设置最大文件大小（upload.setSizeMax(10 * 1024 * 1024);）
- 防止路径穿越攻击（校验filename是否合法）
- 增加登录权限控制（如只有教师可上传）
- 考虑使用UUID替代时间戳避免重名
基本上就这些。这个简易系统覆盖了文件上传下载的核心流程，适合教学和初级项目参考。后续可扩展为支持分页、分类、删除等功能。
