Java Web_实现文件上传

小白学爪哇

已于 2024-04-04 09:19:04 修改

阅读量1k

点赞数

文章标签： java html javaweb idea jsp

于 2022-01-17 20:01:23 首次发布

本文链接：https://blog.csdn.net/qq_52895663/article/details/122547091

版权

Java Web_实现文件上传

项目结构：

在这里插入图片描述

注意：在WEB-INF 目录下创建ib目录，并导入 commons-fileupload-1.4.jar 和 commons-io-2.6.jar ，将lib目录添加到类库

实现代码：

Servlet：

package com.dl;

import com.sun.org.apache.bcel.internal.generic.NEW;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.ProgressListener;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.UUID;

@WebServlet("/fileupload.do")
public class FileServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        //判断上传的文件是普通表单还是上传文件的表单
        if (!ServletFileUpload.isMultipartContent(req)){
            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/temp");
        File tempFile = new File(uploadPath);
        if (!tempFile.exists()){
            uploadFile.mkdir();//创建保存临时文件的临时目录
        }

        //处理上传的文件一般都用流来获取，我问可以使用req.getInputStream()原生态的文件上传流获取，十分麻烦
        //所起我们建议使用Apache的文件上传组件来实现，commons-fileupload，它需要依赖于commons-io
        /*
        ServletFileUpload负责处理上传的文件数据,并将表单中每个输入项封装成一个FileItem对象（表单输入项），
        在使用ServletFileUpload对象解析请求时需要DiskFileItemFactory对象。所以，我们需要在进行解析工作前构造好DiskFileItemFactory对象，
        通过ServletFileUpload对象的构造方法或setFileItemFactory()方法设置ServletFileUpload对象的fileItemFactory属性。
         */
        //1，创建DiskFileItemFactory对象，处理文件上传路径或者限制大小
        DiskFileItemFactory factory = new DiskFileItemFactory();
        // 通过这个工厂设置一个缓存区，当上传的文件超过这个缓存区的大小时。将它放到临时文件中
        /* 有默认值可以不写
        factory.setSizeThreshold(1024*1024); //缓存区大小为 1M。有默认值可以不写
        factory.setRepository(tempFile); //临时文件的保存目录，需要一个File。有默认值可以不写
         */

        //2，获取ServletFileUpload
        ServletFileUpload upload = new ServletFileUpload(factory);//传入创建好的DiskFileItemFactory对象
        /*
        //监听文件上传的进度。有默认值可以不写
        upload.setProgressListener(new ProgressListener() {
            @Override
            public void update(long l, long l1, int i) {
                System.out.println("总大小："+l1+"，已上传的大小："+l);
            }
        });
        //处理乱码问题。有默认值可以不写
        upload.setHeaderEncoding("utf-8");
        //设置单个文件的最大值。有默认值可以不写
        upload.setFileSizeMax(1024*1024*10);//10mb
        //设置总共能上传文件的大小。有默认值可以不写
        upload.setSizeMax(1024*1024*10);
         */

        //3，处理上传的文件
        //3.1 把前端请求封装成一个FileItem对象，利用ServletFileUpload对象
        try {
            List<FileItem> fileItems = upload.parseRequest(req);
            for (FileItem fileItem : fileItems) {
                //判断输入项是普通的，还是上传文件的
                if (fileItem.isFormField()){ //普通
                    String name = fileItem.getFieldName(); //getFieldName()指前端的埪件name
                    String value = fileItem.getString("utf-8"); // 处理乱码
                    System.out.println(name+":"+value);
                }else{ //文件
                    //===========处理文件===========
                    String uploadFileName = fileItem.getName();
                    System.out.println("uploadFileName:"+uploadFileName);
                    //可能存在文件名不合法的情况
                    if (uploadFileName.trim().equals("") || uploadFileName==null){
                        continue;
                    }
                    //获得上传文件的名字   /images/girl/paojie.png
                    String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/") + 1);
                    //获取文件的后缀名
                    String fileExName = uploadFileName.substring(uploadFileName.lastIndexOf(".") + 1);
                    //如果文件后缀不是我们规定的直接return，不处理，告诉用户文件类型不对
                    //可以使用UUID，保证文件名唯一，UUID.randomUUID()随机生成一个唯一的通用码
                    String uuidPath = UUID.randomUUID().toString();
                    //===========存放地址===========
                    //文件真实存在的路径 realPath
                    String realPath = uploadPath+"/"+uuidPath;
                    File realPathFile = new File(realPath);
                    if (!realPathFile.exists()){
                        realPathFile.mkdir();
                    }
                    //===========文件传输===========
                    //获得文件上传的输入流
                    InputStream inputStream = fileItem.getInputStream();
                    //创建一个问件输出流
                    FileOutputStream fos = new FileOutputStream(realPath + "/" + fileName);
                    //创建缓冲区
                    byte[] buffer = new byte[1024*1024];
                    int len = 0;
                    while ((len = inputStream.read(buffer))>0){
                        fos.write(buffer,0,len);
                    }
                    //关闭流
                    fos.close();
                    inputStream.close();
                    //上传成功，清除临时文件
                    fileItem.delete();
                }
            }
        } catch (FileUploadException e) {
            e.printStackTrace();
        }
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        doGet(req, resp);
    }
}

前端页面：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
  <head>
    <title>文件上传</title>
  </head>
  <body>
  <%--
    post:上传文件大小没有限制
    get:上传文件大小有限制
    上传文件的表单必须添加 enctypy属性（enctype="multipart/form-data"）
  --%>
  <form action="${pageContext.request.contextPath}/fileupload.do" method="post" enctype="multipart/form-data">
    <p>上传用户：<input type="text" name="username"></p>
    <p><input type="file" name="file1"></p>
    <p><input type="file" name="file2"></p>
    <p><input type="submit">   |     <input type="reset"></p>
  </form>
  </body>
</html>

注意：文件上传位置：文件上传位置是在项目的输出目录（out目录）下面对应的项目路径下

使用的类：

ServletFileUpload

负责处理上传的文件数据,并将表单中每个输入项封装成一个FileItem对象（表单输入项），在使用ServletFileUpload对象解析请求时需要DiskFileItemFactory对象。所以，我们需要在进行解析工作前构造好DiskFileItemFactory对象，通过ServletFileUpload对象的构造方法或setFileItemFactory()方法设置ServletFileUpload对象的fileItemFactory属性。
FileItem

表单输入项
DiskFileItemFactory

将请求消息实体中的每一个项目封装成单独的DiskFileItem (FileItem接口的实现) 对象的任务
由 org.apache.commons.fileupload.FileItemFactory 接口的默认实现
org.apache.commons.fileupload.disk.DiskFileItemFactory 来完成。当上传的文件项目比较小时，直接保存在内存中（速度比较快），比较大时，以临时文件的形式，保存在磁盘临时文件夹（虽然速度慢些，但是内存资源是有限的）。

实现流程：

判断用户上传的文件是普通表单还是带文件的表单，如果是普通文件直接返回（return）
创建文件上传保存的路路径，在WEB-INF路径下是安全的，用户无法直接访问上传文件
创建临时路径,如果文件好过了预期大小，就把他放到一个临时文件中
创建DiskFileItemFactory对象，设置文件临时路径（setRepository）或大小的限制（设置一个缓冲区，setSizeThreshold）
获取ServletFileUpload对象，处理乱码问题（setHeaderEncoding），设置单个文件的最大值（setFileSizeMax），设置总共能够上传文件的大小（setSizeMax），还可选择监听文件上传进度（setProgressListener）
通过ServletFileUpload对象的parseRequest方法把前端请求解析，封装成一个FileItem对象，判断上传的文件是普通的表单还是带文件的表单（isFormField），getFieldName获取前端表单控件的name
通过FileItem的getName方法获取文件名字并判断是否为空，可以使用UUID保证文件名唯一
拼接文件真实存在路径，并给每个文件创建一个对应的文件夹
通过FileItem的getInputStream方法获取文件上传的流，并创建一个文件输出流将文件写入真实保存路径，最后关闭流
上传成功可将页面转发到新的提示页面