java实现文件上传

第一步 创建maven项目（含web框架），配置并测试tomcat服务器

第2步 引入文件上传所需依赖

        <!--  servlet实现文件上传  -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.2</version>
        </dependency>

        <!-- 文件上传所需依赖       -->
        <!-- https://mvnrepository.com/artifact/commons-io/commons-io -->
        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.4</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload -->
        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.4</version>
        </dependency> 
        

第3步 前端

  <form action="${pageContext.request.contextPath}/upload.do" enctype="multipart/form-data" method="post">
    用户名：<input type="text" name="username"><br>
    <input type="file" name="file1"><br>
    <input type="file" name="file2"><br>
    <input type="submit"> | <input type="reset">
  </form>

第4步 后端

Servlet类编写

public class FileUpload extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        //判断上传的文件是普通表单还是带文件的表单
        if (!ServletFileUpload.isMultipartContent(request)) {
            return;  //终止方法运行，说明这是一个普通的表单，直接返回
        }

        //创建上传文件的保存目录，为了安全建议在WEB-INF目录下，用户无法访问
        String uploadPath = this.getServletContext().getRealPath("WEB-INF/upload");
        File uploadFile = new File(uploadPath);
        if (!uploadFile.exists()) {
            uploadFile.mkdir(); //创建这个目录
        }

        //缓存，临时文件
        //临时路径，如果上传的文件超过预期的大小，我们将它存放到一个临时目录中，过几天自动删除，或者提醒用户转存为永久
        String tmpPath = this.getServletContext().getRealPath("WEB-INF/tmp");
        File file = new File(tmpPath);
        if (!file.exists()) {
            file.mkdir(); //创建这个目录
        }

        //处理上传的文件一般需要通过流来获取，我们可以通过request.getInputstream(),原生态文件上传流获取，十分麻烦
        //但是我们都建议使用Apache的文件上传组件来实现，common-fileupload,它需要依赖于common-io组件；
        /*
              ServletFileUpload负责处理上传的文件数据，并将表单中的每个输入项封装成一个FileItem对象，
              在使用ServletFileUpload对象解析请求时需要DiskFileItemFactory对象。
              所以，我们需要在进行解析工作前构造好DiskFileItemFactory对象，
              通过ServletFileItem对象的构造方法或setFileItemFactory()
              设置ServletFileUpload对象的fileItemFactory属性。
         */
        try {
            //1、创建DiskFileItemFactory对象，处理文件上传路径或限制文件大小
            DiskFileItemFactory factory = getDiskFileItemFactory(file);

            //2、获取ServletFileUpload
            ServletFileUpload upload = getServletFileUpload(factory);

            //3、处理上传文件
            String msg = uploadParseRequest(upload,request,uploadPath);
            request.setAttribute("msg",msg);
            request.getRequestDispatcher("/info.jsp").forward(request,response);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    public static DiskFileItemFactory getDiskFileItemFactory(File file){
        //1，创建DiskFileItemFactory对象，处理文件上传路径或限制文件大小
        DiskFileItemFactory factory = new DiskFileItemFactory();

        //通过工厂设置一个缓冲区，当上传文件大小大于缓冲区大小，存到临时文件中
        factory.setSizeThreshold(1024 * 1024);
        factory.setRepository(file);
        return factory;
    }

    public static ServletFileUpload getServletFileUpload(DiskFileItemFactory factory){
        //2,获取ServletFileUpload
        ServletFileUpload upload = new ServletFileUpload(factory);
        //监听文件上传进度
        upload.setProgressListener(new ProgressListener() {
            @Override
            public void update(long pByteRead, long lpContentLength, int i) {
                //pByteRead: 已读取到的文件大小
                //lpContentLength: 文件大小
                System.out.println("总大小："+lpContentLength+"已上传： "+pByteRead);
            }
        });

        //处理乱码问题
        upload.setHeaderEncoding("utf-8");
        //设置单个文件的最大值
        upload.setFileSizeMax(1024 * 1024 * 10);
        //设置总共能够上传文件的大小
        //1024 = 1kb * 1024 = 1M * 10 = 10M
        upload.setSizeMax(1024 * 1024 * 10);
        return upload;
    }

    public static String uploadParseRequest(ServletFileUpload upload,HttpServletRequest request,String uploadPath) throws FileUploadException, IOException {
        String msg = "";
        //3,处理文件上传
        //把前端的请求解析，封装成一个FileItem对象
        List<FileItem> fileItems = upload.parseRequest(request);
        for (FileItem fileItem : fileItems) {
            if(fileItem.isFormField()){   //判断是普通表单还是带文件的表单
                //getFieldName指的是前端表单控件的name
                String name = fileItem.getFieldName();
                String value = fileItem.getString("utf-8"); //处理乱码
                System.out.println(name+":"+value);
            }else{  //判断它是带文件的表单
                //========处理文件=======
                //拿到文件的名字
                String uploadFileName = fileItem.getName();
                System.out.println("上传的文件名："+uploadFileName);

                //上传文件的文件名不规范
                if(uploadFileName.trim().equals("")) continue;

                //获得上传的文件名，  例如 /img/girl/mn.jpg，只需要mn，其后面的都不需要
                String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/")+1);

                //获得文件的后缀名
                String suffix = uploadFileName.substring(uploadFileName.lastIndexOf(".")+1);

                //后缀名不是我们需要的类型，直接return，不处理，告诉用户上传类型不对
                System.out.println("文件名："+fileName+"文件类型："+suffix);

                //可以使用UUID（唯一通用识别码）来保证文件名的统一
                String uuid = UUID.randomUUID().toString();

                //=======传输文件==============
                //获得文件上传的流
                InputStream inputStream = fileItem.getInputStream();

                //创建一个文件输出流
                FileOutputStream fos = new FileOutputStream(uploadPath+"/"+uuid+"."+suffix);

                //创建一个缓冲区
                byte[] buffer = new byte[1024*1024];

                //判断是否读取完毕
                int len;

                //如果大于0，说明还存在数据
                while((len = inputStream.read(buffer))>0){
                    fos.write(buffer,0,len);
                }

                //关闭流
                fos.close();
                inputStream.close();

                msg = "文件上传成功!";
                fileItem.delete();  //上传成功，清除临时文件
            }
        }
        return msg;
    }
}

web.xml文件配置

   <servlet>
       <servlet-name>FileUpload</servlet-name>
       <servlet-class>com.kuang.FileUpload</servlet-class>
   </servlet>
    <servlet-mapping>
        <servlet-name>FileUpload</servlet-name>
        <url-pattern>/upload.do</url-pattern>
    </servlet-mapping>

上传文件目录

总结

引入commons-io,commons-fileupload依赖
**理解**在使用ServletFileUpload对象解析请求时需要DiskFileItemFactory对象。
所以，我们需要在进行解析工作前构造好DiskFileItemFactory对象，
通过ServletFileItem对象的构造方法或setFileItemFactory()
设置ServletFileUpload对象的fileItemFactory属性。