文件上传笔记

最新推荐文章于 2022-12-18 20:47:47 发布

花花的boby

最新推荐文章于 2022-12-18 20:47:47 发布

阅读量1.6k

点赞数

分类专栏： web 文章标签： java

本文链接：https://blog.csdn.net/qq_50863787/article/details/123428556

版权

web 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

文件上传

在这里插入图片描述

介绍

文件上传的注意事项：

这里的文件是上传到服务器中

为保证服务器安全，上传文件应该放在外界无法直接访问的目录下，比如放于WEB-INF目录下
为防止文件覆盖的现象发生，要为上传文件产生一个唯一的文件名
要限制上传文件的最大值
可以限制上传文件的类型，在收到上传文件名时，判断后缀名是否合法。

需要用到的类详解：

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

我们需要用到的工具类的jar包：commons-io,commons-fileupload

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.6</version>
</dependency>
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>

准备工作

对于文件上传，浏览器在上传的过程中是将文件以流的形式提交到服务器端的

一般选择采用apache的开源工具common-fileupload这个文件上传组件

common-fileupload是依赖common-io这个包的，所以下载这个jar包就行了

手动添加jar包，要将jar包导入到项目中，如果没有导入：

在这里插入图片描述

500错误：

在这里插入图片描述

处理错误：将jar包导入到web项目中

在这里插入图片描述

注意：如果jar包没有导入到tomcat中，会出现500错误，这个错误很难找，所以我们一般用maven导入项目直接添加依赖，会比手动添加jar包要稳定的多

FileItem

在HTML页面input必须有name <input type="file" name="filename">

表单如果包含一个文件上传输入项的话，这个表单的enctype属性就必须设置为multipart/form-data

<form action="${pageContext.request.contextPath}/upload.do" enctype="multipart/form-data" method="post">
    上传用户:<input type="text" name="username"><br>
    上传文件1:<input type="file" name="file1"><br>
    上传文件2:<input type="file" name="file2"><br>
    <input type="submit" value="提交">
    <input type="reset" value="重置">
</form>

浏览器的表单类型如果为multipart/form-data，在服务器端想获取数据就要通过流。

创建项目，编写Servlet

导入Servlet的jar包：这里我们可以IDEA自动下载，不去手动下载

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-0q1133Or-1646987918930)(C:\我的文档\java\学习\笔记\数据库\1646529375580.png)]

创建一个FileServlet类

注册Servlet:

<servlet>
    <servlet-name>FileServlet</servlet-name>
    <servlet-class>com.tang.servlet.FileServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>FileServlet</servlet-name>
    <url-pattern>/upload.do</url-pattern>
</servlet-mapping>

编写Servlet

package com.tang.servlet;
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.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.*;
import java.util.List;
import java.util.UUID;
public class FileServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        //判断上传的文件是普通表单还是带文件的表单 需要用到ServletFileUpload类的工具jar包
        if (!ServletFileUpload.isMultipartContent(req)){
            return;//终止方法运行，说明这是一个普通的表单，直接返回
        }
        //创建上传文件的保存地址，建议在WEB-INF路径下，安全，且用户无法直接访问上传的文件
        System.out.println(this.getServletContext());
        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();//创建这个临时目录
        }

        try {
/*        //获取DiskFileItemFactory
        //1.创建DiskFileItemFactory对象，处理文件上传路径或者大小限制
        DiskFileItemFactory factory = new DiskFileItemFactory();
        //通过这个工厂设置一个缓存区，当上传的文件大于这个缓冲区的时候，将它放到临时文件中
        factory.setSizeThreshold(1024*1024);//设置缓存区的大小为1M
        factory.setRepository(file);//临死目录的保存目录，需要一个File，设置目录仓库路径
        //将以上的代码封装为一个方法：DiskFileItemFactory factory = getDiskFileItemFactory(file);*/
            //1.创建DiskFileItemFactory对象，处理文件上传路径或者大小限制，
            //这里限制了永久保存的文件大小，超过1M就存放进临时文件
            DiskFileItemFactory factory = getDiskFileItemFactory(file);
/*         //获取ServletFileUpload
        ServletFileUpload upload = new ServletFileUpload(factory);
        //监听文件上传进度
        upload.setProgressListener(new ProgressListener() {
            @Override
            //pBytesRead:已经读取到的文件大小
            //pContentLength:文件大小
            public void update(long pBytesRead, long pContentLength, int pItems) {
                System.out.println("总大小："+pContentLength+"已上传："+pBytesRead);
            }
        });
        //处理乱码问题
        upload.setHeaderEncoding("UTF-8");
        //设置单个文件的最大值
        upload.setFileSizeMax(1024*1024*10);
        //设置总共能够上传文件的大小   1024=1kb*1024=1M*10=10M
        //将以上代码进行封装：ServletFileUpload upload=getServletFileUpload(factory);*/
            //2.获取ServletFileUpload
            //这里限制了文件上传的大小，设置为20M，超过20M会报错
            ServletFileUpload upload=getServletFileUpload(factory);

        /*处理上传的文件:将文件保存到服务器中
        处理上传的文件，一般都是需要通过流来获取，我们可以使用request.getInputStream(),原生态的文件上传流获取十分麻烦
        所以我们采用Apache的文件上传组件来实现，common-fileupload，需要导入commons-io组件*/
            //3.处理上传的文件
            String msg=uploadParseRequest(upload,req,uploadPath);
            //servlet请求转发消息
            req.setAttribute("msg",msg);
            req.getRequestDispatcher("info.jsp").forward(req,resp);
        } catch (FileUploadException e) {
            e.printStackTrace();
        }

    }

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

    //获取DiskFileItemFactory
    public static DiskFileItemFactory getDiskFileItemFactory(File file){
        //1.创建DiskFileItemFactory对象，处理文件上传路径或者大小限制
        DiskFileItemFactory factory = new DiskFileItemFactory();
        //通过这个工厂设置一个缓存区，当上传的文件大于这个缓冲区的时候，将它放到临时文件中
        factory.setSizeThreshold(1024*1024);//设置缓存区的大小为1M
        factory.setRepository(file);//临时目录的保存目录，需要一个File，设置目录仓库路径
        return factory;
    }

    //获取ServletFileUpload
    public static ServletFileUpload getServletFileUpload(DiskFileItemFactory factory){
        //获取ServletFileUpload
        ServletFileUpload upload = new ServletFileUpload(factory);
        //监听文件上传进度
        upload.setProgressListener(new ProgressListener() {
            @Override
            //pBytesRead:已经读取到的文件大小
            //pContentLength:文件大小
            public void update(long pBytesRead, long pContentLength, int pItems) {
                System.out.println("总大小："+pContentLength+"已上传："+pBytesRead);
            }
        });
        //处理乱码问题
        upload.setHeaderEncoding("UTF-8");
        //设置单个文件的最大值
        upload.setFileSizeMax(1024*1024*20);//只要这里的大小大于你要上传的单个文件，则就可以上传了
        //设置总共能够上传文件的大小   1024=1kb*1024=1M*20=20M
        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("")||uploadFileName==null){
                    continue;
                }
                //获取上传的文件名  /images/girl/paojie.png
                String fileName=uploadFileName.substring(uploadFileName.lastIndexOf("/")+1);
                //获取文件的后缀名
                String fileExtName = uploadFileName.substring(uploadFileName.lastIndexOf(".") + 1);
                /*
                    如果文件后缀名 fileExtName 不是我们所需要的
                    就直接return，不处理返回，告诉用户文件类型不对
                */
                System.out.println("文件信息[文件名: "+fileName+"---文件类型"+fileExtName+"]");
                //可以使用UUID(唯一识别的通用码)，保证文件名唯一
                //UUID.randomUUID(),随机生成一个唯一识别的通用码
                //网络传输中的东西，都需要序列化
                //POJO，实体类，如果想要在多个电脑上运行，传输===>需要把对象都序列化了
                //implements Serializable:标记接口，JVM-->本地
                String uuidPath = UUID.randomUUID().toString();

                //=====================处理文件完毕==================
                //存到哪？  uploadPath
                //文件真实存在的路径，realPath
                String realPath=uploadPath+"/"+uuidPath;
                //给每个文件创建一个对应的文件夹
                File realPathFile = new File(realPath);
                if (!realPathFile.exists()){
                    realPathFile.mkdir();
                }

                //========================存放地址，文件传输======================
                //获得文件上传的流
                InputStream inputStream = fileItem.getInputStream();
                //创建一个文件输出流
                //realPath=真实的文件夹
                //指定这个文件；加上输出文件的名字+"/"+uuidFileName
                FileOutputStream fos = new FileOutputStream(realPath + "/" + fileName);
                //创建一个缓存区
                byte[] buffer = new byte[1024 * 1024];
                //判断是否读取完毕
                int len=0;
                //如果大于0说明还存在数据;
                while((len=inputStream.read(buffer))>0){
                    fos.write(buffer,0,len);//将流读取文件，存到buffer缓存数组中，然后再输出到服务器文件中
                }

                //关闭流
                fos.close();
                inputStream.close();
                msg="文件上传成功！";
                fileItem.delete();//上传成功，清除临时文件,
                //这里我是选择直接将临时文件删除掉，临时文件后缀为.tmp
                //你可以设置临时文件的保质期，然后等时间一过再删除
                //========================文件传输完毕===================
            }
        }
        return msg;
    }
}

需要用到ServletFileUpload类的工具jar包，因为是流，所以我们可以用common-io的工具jar包

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.6</version>
</dependency>
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>

注意：这里设置了单个文件上传的大小为20M，是在ServletFileUpload类中的setFileSizeMax(1024102420)设置的，

编写前端，设置一个文件上传表单

<%@page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>$Title$</title>
</head>
<body>
<%--通过表单上传文件
        get：上传文件大小有限制
        post：上传文件大小没有限制
--%>
<%--${pageContext.request.contextPath}获取服务器路径--%>
<form action="${pageContext.request.contextPath}/upload.do" enctype="multipart/form-data" method="post">
    上传用户:<input type="text" name="username"><br>
    上传文件1:<input type="file" name="file1"><br>
    上传文件2:<input type="file" name="file2"><br>
    <input type="submit" value="提交">|<input type="reset" value="重置">
</form>
</body>
</html>

编写一个文件上传成功跳转的页面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
${msg}
</body>
</html>

最精简的步骤（重要）

判断整个表单是不是文件表单----ServletFileUpload.isMultipartContent(req)

是就返回true，不是返回false
设置并创建好你的临时文件夹
创建DiskFIleItemFactory对象

通过这个对象设置好临时文件的目录
创建ServletFIleUpload对象，将第3步的对象放进去
把前端解析，封装成一个FileItem对象，这里是最重要的步骤
```
List<FileItem> fileItems = upload.parseRequest(request); 
```
执行了这里，如果文件大于你设置的临时文件临界值，就会把文件整个保存到你的临时目录中。
将文件写入到真实文件夹中

… …

扩展

工厂模式

使用场景：1、日志记录器：记录可能记录到本地硬盘、系统事件、远程服务器等，用户可以选择记录日志到什么地方。2、数据库访问，当用户不知道最后系统采用哪一类数据库，以及数据库可能有变化时。3、设计一个连接服务器的框架，需要三个协议，“POP3”、“IMAP”、“HTTP”，可以把这三个作为产品类，共同实现一个接口。

注意：作为一个创建类模式，在任何需要生成复杂对象的地方，都可以使用工厂方法模式。有一点需要注意的地方就是复杂对象适合使用工厂模式，而简单对象，特别是只需要通过new就可以完成创建的对象，无需使用工厂模式。如果使用工厂模式，就需要引入一个工厂类，会增加系统的复杂度。

jni.h、jawt.h是C++或者C语言代码，java虚拟机不能操作，只有操作系统才能操作控制
在这里插入图片描述

在这里插入图片描述

花花的boby

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
文件上传笔记

文件上传介绍文件上传的注意事项：这里的文件是上传到服务器中为保证服务器安全，上传文件应该放在外界无法直接访问的目录下，比如放于WEB-INF目录下为防止文件覆盖的现象发生，要为上传文件产生一个唯一的文件名要限制上传文件的最大值可以限制上传文件的类型，在收到上传文件名时，判断后缀名是否合法。需要用到的类详解：ServletFileUpload负责处理上传的文件数据，并将表单中的每个输入项封装成一个FileItem对象，在使用ServletFileUpload对象解析请求时需要DIsk
复制链接

扫一扫