jsp+servlet简单实现上传文件功能（保存目录改进）

文件上传可以说是Web开发中很常见的功能了，尤其在涉及到图书管理这类场景时，上传封面图片几乎是标配。不过，要让文件上传功能平稳运行，前端和后端都得安排妥当——从表单的提交方式，到后台的解析逻辑，每个环节都有讲究。

1、前端表单

先从前端说起。文件上传对表单有几个硬性要求，缺一不可：

第一，请求提交方式必须是POST，这个没什么好说的，GET方式根本承载不了文件数据。第二，表单需要明确告诉浏览器，这次提交的是一个multipart请求——具体做法是在

<%-- Created by IntelliJ IDEA. User: Lenovo Date: 2020/6/19 Time: 22:53 Learn from https://www.bilibili.com/video/BV18z411i7gh?t=23&p=192 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="ja va" %>        编号
    名字
    照片
      

注意这里的enctype属性，如果没有它，文件数据是传不过去的。

2、Servlet后台处理

前端提交数据之后，后端就要接招了。处理文件上传的后台逻辑，核心步骤可以分为几个关键环节。

首先要判断请求是不是multipart类型。如果请求本身就不是multipart，那直接抛出异常，没什么好犹豫的。

接下来需要创建DiskFileItemFactory，这是文件写入硬盘的关键组件。同时还得设置一个临时文件夹，当上传文件超过一定大小时，先存到临时目录里，避免内存溢出。这个边界值可以自行设定，比如1MB——小于1MB的进内存，大于1MB的先落盘。

然后就是创建ServletFileUpload核心组件，设置编码解决中文文件名乱码问题，再设定文件大小的上限。完成这些准备工作后，调用parseRequest方法解析请求，拿到一个包含所有上传内容的List。

遍历这个List时，需要区分普通表单项和文件项。普通表单项，比如编号和书名，直接读取字段名和对应的值就行。文件项就比较麻烦了——要获取文件名，提取后缀，然后生成一个新的文件名（通常用编号+书名来命名，避免重复）。接着是获取输入流、创建目标文件、写入数据，最后记得关闭流并删除临时文件。

另外，文件存储路径的组织方式也值得注意。按年/月/日建立子目录是个好习惯，可以有效避免单个文件夹内文件过多的问题。如果目录不存在，直接创建即可。

package Servlet.bookServlet;import org.apache.commons.fileupload.FileItem;import org.apache.commons.fileupload.FileUploadException;import org.apache.commons.fileupload.disk.DiskFileItemFactory;import org.apache.commons.fileupload.servlet.ServletFileUpload;import ja vax.servlet.ServletException;import ja vax.servlet.annotation.WebServlet;import ja vax.servlet.http.HttpServlet;import ja vax.servlet.http.HttpServletRequest;import ja vax.servlet.http.HttpServletResponse;import ja va.io.*;import ja va.text.SimpleDateFormat;import ja va.util.Calendar;import ja va.util.Date;import ja va.util.List;@WebServlet(name = "UploadImageServlet")public class UploadImageServlet extends HttpServlet {  @Override  protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {    this.doPost(request,response);  }  @Override  protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {    if(!ServletFileUpload.isMultipartContent(request)){      throw new RuntimeException("当前请求不支持文件上传");    }    System.out.println("开始上传文件");    try {      DiskFileItemFactory factory = new DiskFileItemFactory();      String tempPath ="D:\\tomcat\\apache-tomcat-9.0.35-windows-x64\\apache-tomcat-9.0.35\\webapps\\librarySystem\\web\\net\\temp";      File tempFile = new File(tempPath);      factory.setRepository(tempFile);      factory.setSizeThreshold(1024*1024*1);      ServletFileUpload upload = new ServletFileUpload(factory);      upload.setHeaderEncoding("utf-8");      upload.setFileSizeMax(1024*1024*2);      String bNo="defaultBNo",bName="defaultBName";      List items =upload.parseRequest(request);      for(FileItem item:items){        if(item.isFormField()){          String fileName = item.getFieldName();          String fileValue = item.getString("utf-8");          System.out.println(fileName + " -- " + fileValue);          if(fileName.equalsIgnoreCase("BNO")){            bNo = fileValue;          }          if(fileName.equalsIgnoreCase("BNAME")){            bName = fileValue;          }         }        else{          String fileName = item.getName();          System.out.println("上传文件名字:"+fileName);          String suffix = fileName.substring(fileName.lastIndexOf('.'));          String newFileName = bNo+"_"+bName+suffix;          System.out.println(newFileName);          InputStream is = item.getInputStream();          String path ="D:\\tomcat\\apache-tomcat-9.0.35-windows-x64\\apache-tomcat-9.0.35\\webapps\\librarySystem\\web\\net\\bookImage";          Calendar now = Calendar.getInstance();          int year = now.get(Calendar.YEAR);          int month = now.get(Calendar.MONTH)+1;          int day = now.get(Calendar.DAY_OF_MONTH);          path = path+"/"+year+"/"+month+"/"+day;          File dirFile = new File(path);          if(!dirFile.exists()){            dirFile.mkdirs();          }          File desFile = new File(path,newFileName);          OutputStream os = new FileOutputStream(desFile);          int len=-1;          byte[]buf = new byte[1024];          while((len=is.read(buf))!=-1){            os.write(buf,0,len);          }          os.close();          is.close();          item.delete();        }      }    } catch (FileUploadException e) {      e.printStackTrace();    }  }}

总结

文件上传看似简单，但细节不少。从前端表单的属性设置，到后端对请求的解析、临时文件的处理、文件名的重命名、存储路径的规划，每一步都需要考虑周全。掌握了这些核心逻辑，再遇到类似的上传需求，就能做到心中有数了。